Tilføj Hello til din side
Tilføj Hello scriptet - grundlæggende
At tilføje dette script til din sides kode vil tilføje Zonos Hello flaget til din hjemmeside, genkende det land, dine kunder besøger fra, hilse på dem og give generel told- og skatteinformation for deres land.
KOMPETENCER NØDVENDIGE: Grundlæggende webfærdigheder
For at installere Hello, anvend det tilpassede script, der indeholder din unikke site-nøgle, på din hjemmeside før den afsluttende body
tag.
Hello integrationsscript
<script src="https://hello.zonos.com/hello.js?siteKey=YOURSITEKEY"></script>
Zonos Hello skal indlæses, før der tilføjes nogen yderligere funktionalitet. Venligst inkluder eventuelle yderligere funktioner efter ovenstående script.
Har du ikke allerede et script? Klik her for at downloade.
Generer estimerede told- og skattebeløb
KOMPETENCER NØDVENDIGE: Grundlæggende udviklerfærdigheder
Når denne funktion er aktiveret, kan Hello give estimater for told og skat, når et produkt vises eller tilføjes til indkøbskurven. Hello kan også vise fulde told- og skatteoverslag for hele indkøbskurven, når siden vises.
Told- og skatteoverslaget kan placeres på hver produktside eller din hovedprodukside, afhængigt af hvordan din platform er opsat.
For at tilføje told- og skatteoverslaget, anvend et script, der ligner det, der vises nedenfor. De to krævede felter er name
og price
.
Eksempel: Nedenfor er et eksempel på, hvordan scriptet vil se ud og fungere på din side.
Hello integrationsscript
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',
});
Scripts, der kan bruges, skal justeres for at få dem til at fungere på dit site. Sørg venligst for, at nogen af de følgende scripts, du bruger, placeres efter den indledende Zonos Hello Script.
Hvis du ikke bruger en platform, kan du bruge følgende til dynamisk at hente dine produktdetaljer. Dette script vil hente det første tilgængelige produkt. Du kan også justere dette script til at blive brugt på din sites indkøbskurvside. Du skal loop igennem alle produkter og deres data og derefter sende det til zonos.quote.
Hello integrationsscript
<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 tilføje yderligere værdier fra varefelterne nedenfor og også ændre
currencyCode
til at være din standardvaluta.
Shopify og BigCommerce
Hvis du bruger Shopify eller BigCommerce, skal du bruge koden nedenfor.
Hvis du bruger Shopify som din platform, har vi et script, du kan bruge, som vil hente produktdata fra dine Shopify produktdetaljer.
Den nedenstående kode har en funktion, der vil køre på produkt siderne og indkøbskurv siden.
Hello integrationsscript
<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>
Citationsfelter
Felt | Datatype | Beskrivelse |
---|---|---|
items | array PÅKRÆVET | En liste over varer, der skal inkluderes i citatet |
currencyCode | string | Varepriserne vises i den valuta, der er angivet med den tre-tegns valuta kode. Standard: USD |
includedTaxRate | number | Vareafgift rate hvis varen inkluderer skat |
showDecimal | bool | Tænd/sluk for visning af decimalværdien på konverterede valutaer |
Varefelter
Felt | Datatype | Beskrivelse |
---|---|---|
name | string PÅKRÆVET | Produktnavn |
price | number PÅKRÆVET | Enhedspris for et enkelt produkt |
quantity | integer | Antallet af produkter i indkøbskurven. Standard: 1 |
image | string | URL til produktbilledet |
url | string | URL til det enkelte produkt |
hsCode | string | Den harmoniserede kode (HS-kode) for dit produkt |
category | string | Produktets kategori på din side |
country | string | To-tegns ISO-kode for det land, dette produkt stammer fra |
customization | string | Produkttilpasning, f.eks. størrelse, farve |
description | string | Den detaljerede beskrivelse af produktet |
sku | string | UPC eller SKU for produktet |
Når du giver flere oplysninger til Zonos om dit produkt, vil nøjagtigheden af estimatet normalt blive forbedret.
Tilpas Hello
Ændre flagets placering
KOMPETENCER NØDVENDIGE: Grundlæggende udviklerfærdigheder
Som standard vil Zonos Hello flaget vises i nederste højre hjørne af din side.
Her finder du nogle oplysninger om, hvordan du ændrer placeringen af flaget samt skjuler visse elementer på din hjemmeside, som du ikke ønsker, at internationale kunder skal se.
Eksempel: Skjule gratis fragt fra internationale kunder; dette vil også gøre det muligt for dig at skjule Zonos Hello fra indenlandske kunder og specifikke lande.
Hvis placeringen efterlades tom, vil koden bruge standardindstillingen.
Hello integrationsscript
zonos.config({ location: 'right bottom attached' });
zonos.config({ location: '' });
For the bottom-left corner:
zonos.config({location: 'venstre'});
For the top-left corner with a floating information dialog:
zonos.config({location: 'venstre top flydende'});
flydende
refererer til Hello informationsdialogen, der flyder i midten af siden.vedhæftet
refererer til Hello informationsdialogen, der åbner over flaget.flydende
foretrækkes, når flaget er placeret itop
.
Skjul specifikt indhold
KOMPETENCER NØDVENDIGE: Grundlæggende udviklerfærdigheder
Klassen z-intl
er baseret på det nuværende indenlandske land. Hvis Hello er indstillet til et internationalt land, vil klassen z-intl
fungere som en skjult klasse, der skjuler det indhold, som .z-intl
er knyttet til.
Brug følgende CSS til at skjule indhold. Erstat
.dit-indhold
med det flydende indhold, du ønsker at skjule.
.z-intl .dit-indhold { display: none; }
Nu kan du skjule Hello for dine indenlandske kunder, så andre dialoger bliver synlige igen.
Hello integrationsscript
#zonos {
display: none;
}
.z-intl #zonos {
display: block;
}
Skjul for specifikke lande
Tilføj #zonos id kombineret med landekoden, der fungerer som CSS-klasse for det pågældende land, til funktionen .z-intl { display: none; }
.
Linjen skal se sådan ud:
Hello integrationsscript
.z-intl #zonos.US {
display: none;
}
Tænd/sluk for splash
KOMPETENCER NØDVENDIGE : Grundlæggende udviklerfærdigheder
Splash refererer til pop-up'en og forstørrelsen af Zonos dialogboksen, som indeholder yderligere information om deres lands specifikke told- og skattepolitik.\
Hvis du gerne vil TÆNDE og vise Zonos Hello splash for dine kunders første besøg:
Hello integrationsscript
zonos.config({ showSplash: true });
Hvis du ønsker at DEAKTIVERE Zonos Hello splash for dine kunders første besøg:
Hello integrationsscript
zonos.config({ showSplash: false });
Bemærk: Enhver Zonos tilpasning skal være inden for et
script
tag.
Ofte stillede spørgsmål
Jeg er ikke udvikler og har brug for hjælp. Hvad er mine muligheder?
Hvis du har spørgsmål, bedes du kontakte vores supportteam. Hvis du ikke har ressourcerne til at gennemføre integrationen og har brug for hjælp, bedes du kontakte vores Professionelle Services team.
Installer Hello legacy
Lær hvordan du installerer Hello på din butiks hjemmeside.Hvis du bruger Shopify, BigCommerce, Magento, Miva eller X-Cart, bedes du læse den tilsvarende plugin integrationsside.
Scriptet nedenfor vil tilføje Zonos Hello flaget til din side, genkende det land, dine kunder besøger fra, hilse på dem og give generel told- og skatteinformation for deres land (grundlæggende).
Yderligere funktioner er tilgængelige med minimal udviklingsarbejde (vist nedenfor).