DOCS

Install

/
Hello•
HjemGlobal e-handel Integrasjon Installer

Installer Hello legacy

Lær hvordan du installerer Hello på nettstedet til butikken din.

Hvis du bruker Shopify, BigCommerce, Magento, Miva eller X-Cart, vennligst les den tilsvarende plugin-integrasjonssiden.

Skriptet nedenfor vil legge til Zonos Hello flagget på nettstedet ditt, gjenkjenne landet kundene dine besøker fra, hilse på dem, og gi generell informasjon om avgifter og skatter for deres land (grunnleggende).

Ytterligere funksjoner er tilgjengelige med minimal utviklingsarbeid (vist nedenfor).

Legg til Hello på nettstedet ditt 

1

Legg til Hello skriptet - grunnleggende

Å legge til dette skriptet i nettstedets kode vil legge til Zonos Hello flagget på nettstedet ditt, gjenkjenne landet kundene dine besøker fra, hilse på dem, og gi generell informasjon om avgifter og skatter for deres land.

FERDIGHETER SOM TRENGS: Grunnleggende webferdigheter

For å installere Hello, legg inn det tilpassede skriptet som inneholder din unike nettstednøkkel på nettstedet ditt før den avsluttende body-taggen.

Hello integrasjonsskript

1
<script src="https://hello.zonos.com/hello.js?siteKey=YOURSITEKEY"></script>

Zonos Hello må lastes inn før noen ekstra funksjonalitet legges til. Vennligst inkluder eventuelle ekstra funksjoner etter skriptet ovenfor.

Har du ikke allerede et skript? Klikk her for å laste ned.

2

Generer estimert toll og skatt

KUNNSKAPER NEEDED : Grunnleggende utviklerferdigheter

Når denne funksjonen er aktivert, kan Hello gi estimater for toll og skatt når et produkt vises eller legges til i handlekurven. Hello kan også vise fullstendige toll- og skatteestimater for hele handlekurven når siden vises.

Toll- og skatteestimatet kan plasseres på hver produktside eller din hoved produktside, avhengig av hvordan plattformen din er satt opp.

For å legge til toll- og skatteestimatet, bruk et skript som ser ut som det som vises nedenfor. De to nødvendige feltene er name og price.

Eksempel: Nedenfor er et eksempel på hvordan skriptet vil se ut og fungere på siden din.

Hello integrasjonsskript

1
2
3
4
5
6
7
8
9
10
11
12
13
zonos.quote({
  items: [
    {
      name: 'The name of the product',
      price: 19.95,
      quantity: 2,
      image: 'https://example.com/product-123.png',
      url: 'https://example.com/product-123',
      sku: '123',
    },
  ],
  currencyCode: 'USD',
});

Skript som kan brukes må justeres for å fungere på nettstedet ditt. Vennligst sørg for at noen av de følgende skriptene du bruker er plassert etter den innledende Zonos Hello-skripten.

Hvis du ikke bruker en plattform, kan du bruke følgende for dynamisk å hente produktdetaljene dine. Dette skriptet vil hente det første tilgjengelige produktet. Du kan også justere dette skriptet for å brukes på handlekurvsiden til nettstedet ditt. Du må gå gjennom alle produkter og deres data, og deretter sende det til zonos.quote.

Hello integrasjonsskript

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
<script>
  var zPrice = '';
  var zName = '';
  var zImg = '';

  try {
    if (document.querySelector('ID OR CLASSNAME') != null) {
      zPrice = document.querySelectorAll('ID OR CLASSNAME').innerText;
    }

    if (document.querySelector('ID OR CLASSNAME') != null) {
      zName = document.querySelector('ID OR CLASSNAME').innerText;
    }

    if (document.querySelector('.ID OR CLASSNAME') != null) {
      zImg = document.querySelector('ID OR CLASSNAME').src;
    }

    zonos.quote({
      items: [
        {
          name: zName,
          price: zPrice,
          image: zImg,
        },
      ],
      currencyCode: 'USD',
    });
  } catch (error) {}
</script>

Du kan legge til ekstra verdier fra varefeltene nedenfor og også endre currencyCode til å være din standardvaluta.

Shopify og BigCommerce

Hvis du bruker Shopify eller BigCommerce, bruk koden nedenfor.

Shopify
BigCommerce

Hvis du bruker Shopify som plattform, har vi et skript du kan bruke som henter produktdata fra detaljene for Shopify-produktet.

Koden nedenfor har en funksjon som vil kjøre på produktsidene og handlekurvsiden.

Hello integrasjonskript

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<script>
    function znDutyTaxEstimateOnDetailPage() {
        {% if product and product.price %}
          zonos.quote({
            items: [{ price: "{{ product.price | money_without_currency }}", name: "{{product.title | replace: '"', '\"'}}", url: "{{ shop.secure_url }}{{ product.url }}", image: "https:{{ product.featured_image | product_img_url: 'medium' }}"}],
            currencyCode: '{{ shop.currency }}'

          });

      {% endif %}

  }

  function znDutyTaxEstimateOnCartPage() {
  if (window.location.href.indexOf("cart") > -1) {
  zonos.quote({
  items: [
  {% for item in cart.items %}
  { price: "{{ item.price | money_without_currency }}", quantity: {{item.quantity}}, name: "{{ item.title | replace: '"', '\"'}}", url: "{{ shop.secure_url }}{{item.url}}", image: "https:{{item.image| product_img_url: 'medium'}}"},
  {% endfor %}
  ],currencyCode: '{{ shop.currency }}'});
  }
  }

  znDutyTaxEstimateOnDetailPage();
  znDutyTaxEstimateOnCartPage();
</script>

Sitatfelt 

FeltDatatypeBeskrivelse
itemsarray

PÅKREVD

En liste over elementer som skal inkluderes i tilbudet
currencyCodestringPrisen på elementene vil vises i valutaen spesifisert av den tre-tegns valutakoden. Standard: USD
includedTaxRatenumberSkattesatsen rate for elementet hvis elementet inkluderer skatt
showDecimalboolSlår av eller på visning av desimalverdien på konverterte valutaer

Elementfelt 

FeltDatatypeBeskrivelse
namestring

PÅKREVD

Produktnavn
pricenumber

PÅKREVD

Enhetsprisen for et enkelt produkt
quantityintegerAntall produkter i handlekurven. Standard: 1
imagestringURL til produktbildet
urlstringURL til det individuelle produktet
hsCodestringHarmonisert kode (HS-kode) for produktet ditt
categorystringProduktets kategori på nettstedet ditt
countrystringTo-tegns ISO-kode for landet dette produktet stammer fra
customizationstringProdukttilpasning (f.eks. størrelse, farge)
descriptionstringDen detaljerte beskrivelsen av produktet
skustringUPC eller SKU for produktet

Når du gir mer informasjon til Zonos om produktet ditt, vil nøyaktigheten av estimatet vanligvis bli forbedret.

Tilpass Hello 

Endre flaggets plassering

FERDIGHETER NØDVENDIG: Grunnleggende utviklerferdigheter

Som standard vil Zonos Hello-flagget vises i nedre høyre hjørne av siden din.

Her finner du informasjon om hvordan du kan endre plasseringen av flagget samt skjule visse elementer på nettstedet ditt som du ikke ønsker at internasjonale kunder skal se.

Eksempel: Skjule gratis frakt fra internasjonale kunder; dette vil også gjøre det mulig å skjule Zonos Hello fra innenlandske kunder og spesifikke land.

Hvis plasseringen står tom, vil koden bruke standardinnstillingen.

Hello integrasjonskode

1
2
zonos.config({ location: 'right bottom attached' });
zonos.config({ location: '' });

For the bottom-left corner:

zonos.config({location: 'left'});

For the top-left corner with a floating information dialog:

zonos.config({location: 'left top floating'});

  • floating refererer til Hello informasjonsdialogen som flyter i midten av siden.
  • attached refererer til Hello informasjonsdialogen som åpnes over flagget.
  • floating foretrekkes når flagget plasseres på top.

Skjul spesifikt innhold

FERDIGHETER NØDVENDIG: Grunnleggende utviklerferdigheter

z-intl klassen er basert på det nåværende innenlandske landet. Hvis Hello er satt til et internasjonalt land, vil z-intl klassen fungere som en skjult klasse, og skjule innholdet som .z-intl er knyttet til.

Bruk følgende CSS for å skjule innhold. Erstatt .your-content med flytende innhold du ønsker å skjule.
.z-intl .your-content { display: none; }

Nå kan du skjule Hello fra dine innenlandske kunder slik at andre dialoger blir synlige igjen.

Hello integrasjonscript

1
2
3
4
5
6
#zonos {
  display: none;
}
.z-intl #zonos {
  display: block;
}

Skjul for spesifikke land

Legg til #zonos-id kombinert med landskoden som også fungerer som CSS-klasse for det landet til .z-intl { display: none; }-funksjonen.

Linjen skal se slik ut:

Hello integrasjonscript

1
2
3
.z-intl #zonos.US {
  display: none;
}

Slå på/av splash

KUNNSKAPER SOM TRENGERS: Grunnleggende utviklerferdigheter

Splash refererer til pop-up-vinduet og forstørrelsen av Zonos dialogboksen, som inneholder tilleggsinformasjon om deres lands spesifikke avgifts- og skattepolitikk.\

Hvis du ønsker å slå PÅ og vise Zonos Hello splash for kundene dine ved deres første besøk:

Hello integrasjonscript

1
zonos.config({ showSplash: true });

Hvis du ønsker å slå AV Zonos Hello splash-siden for kundens første besøk:

Hello integrasjonscript

1
zonos.config({ showSplash: false });

Merk: Eventuelle Zonos tilpasninger må være inne i en script-tag.

Ofte stilte spørsmål 

Jeg er ikke utvikler og trenger hjelp. Hva er alternativene mine?

Hvis du har spørsmål, vennligst kontakt vårt supportteam. Hvis du ikke har ressursene til å fullføre integrasjonen og trenger hjelp, vennligst kontakt vårt Professional Services-team.

Var denne siden nyttig?

Spørsmål?

Kontakt oss.
© 2024 Zonoszonos.com
På denne siden:
  • Installer Hello legacy
  • Legg til Hello på nettstedet ditt
  • Sitatfelt
  • Elementfelt
  • Tilpass Hello
  • Ofte stilte spørsmål