DOCS

Install

/
Hello•
AnasayfaKüresel e-ticaret Entegrasyon Kurulum

Hello mirasını kurun

Mağazanızın web sitesine Hello nasıl kurulacağını öğrenin.

Eğer Shopify, BigCommerce, Magento, Miva veya X-Cart kullanıyorsanız, lütfen ilgili eklenti entegrasyon sayfasını okuyun.

Aşağıdaki script, sitenize Zonos Hello bayrağını ekleyecek, müşterilerinizin ziyaret ettiği ülkeyi tanıyacak, onlara selam verecek ve kendi ülkeleri için genel gümrük ve vergi bilgilerini verecektir (temel).

Ek özellikler, minimum geliştirme çalışması ile mevcuttur (aşağıda gösterilmiştir).

Hello'yu sitenize ekleyin 

1

Hello scriptini ekleyin - temel

Bu scripti sitenizin koduna eklemek, web sitenize Zonos Hello bayrağını ekleyecek, müşterilerinizin ziyaret ettiği ülkeyi tanıyacak, onlara selam verecek ve kendi ülkeleri için genel gümrük ve vergi bilgilerini verecektir.

GEREKEN BECERİLER: Temel web becerileri

Hello'yu kurmak için, benzersiz site anahtarınızı içeren özel scripti web sitenize kapanış body etiketinden önce uygulayın.

Hello entegrasyon scripti

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

Zonos Hello herhangi bir ek işlevsellik eklenmeden önce yüklenmelidir. Lütfen yukarıdaki scriptten sonra herhangi bir ek özellik ekleyin.

Henüz bir scriptiniz yok mu? ?Buraya tıklayarak indirin.

2

Tahmini gümrük ve vergi hesapla

GEREKEN BECERİLER: Temel geliştirici becerileri

Bu özellik etkinleştirildiğinde, Hello bir ürün görüntülendiğinde veya sepete eklendiğinde gümrük ve vergi tahminleri sağlayabilir. Hello ayrıca sayfa görüntülendiğinde tüm sepet için tam gümrük ve vergi tekliflerini de gösterebilir.

Gümrük ve vergi teklifi, platformunuzun nasıl kurulduğuna bağlı olarak her ürün sayfasında veya ana ürün sayfanızda yer alabilir.

Gümrük ve vergi teklifini eklemek için, aşağıda gösterilen script gibi bir script uygulayın. İki gerekli alan name ve pricedir.

Örnek: Aşağıda scriptin sayfanızda nasıl görüneceği ve işlev göreceğine dair bir örnek bulunmaktadır.

Hello entegrasyon scripti

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',
});

Kullanılabilecek betikler, siteniz için çalışacak şekilde ayarlanmalıdır. Lütfen kullandığınız aşağıdaki betiklerin, başlangıçtaki Zonos Hello Betiğinden sonra yerleştirildiğinden emin olun.

Bir platform kullanmıyorsanız, ürün detaylarınızı dinamik olarak almak için aşağıdakini kullanabilirsiniz. Bu betik, mevcut olan ilk ürünü alacaktır. Bu betiği sitenizin sepet sayfasında kullanılacak şekilde de ayarlayabilirsiniz. Tüm ürünleri ve verilerini döngüye almanız ve ardından bunu zonos.quote'ye göndermeniz gerekecektir.

Hello entegrasyon betiği

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>

Aşağıdaki öğe alanlarından ek değerler ekleyebilir ve currencyCode değerini varsayılan para biriminiz olarak değiştirebilirsiniz.

Shopify ve BigCommerce

Eğer Shopify veya BigCommerce kullanıyorsanız, aşağıdaki kodu kullanın.

Shopify
BigCommerce

Eğer platform olarak Shopify kullanıyorsanız, Shopify ürün detaylarınızdan ürün verilerini çekecek bir scriptimiz var.

Aşağıdaki kod, ürün sayfalarında ve sepet sayfasında çalışacak bir fonksiyona sahiptir.

Hello entegrasyon scripti

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>

Alıntı alanları 

AlanVeri türüAçıklama
itemsdizi

GEREKEN

Alıntıya dahil edilecek öğelerin listesi
currencyCodedizeÜrün fiyatları, üç karakterli para birimi koduyla belirtilen para biriminde görüntülenecektir. Varsayılan: USD
includedTaxRatesayıÜrün vergi rate eğer ürün vergi içeriyorsa
showDecimalboolDönüştürülmüş para birimlerinde ondalık değerin gösterimini açar veya kapatır

Ürün alanları 

AlanVeri türüAçıklama
namedize

GEREKEN

Ürün adı
pricesayı

GEREKEN

Tek bir ürünün birim fiyatı
quantitytam sayıSepetteki ürün sayısı. Varsayılan: 1
imagedizeÜrün resminin URL'si
urldizeBireysel ürüne giden URL
hsCodedizeÜrünün Harmonize Kodu (HS kodu)
categorydizeÜrünün sitenizdeki kategorisi
countrydizeBu ürünün geldiği ülkenin iki karakterli ISO kodu
customizationdizeÜrün özelleştirmesi (örneğin, boyut, renk)
descriptiondizeÜrünün detaylı açıklaması
skudizeÜrünün UPC veya SKU'su

Zonos hakkında daha fazla ayrıntı sağladıkça, tahminin doğruluğu genellikle artacaktır.

Özelleştir Hello 

Bayrak konumunu değiştir

GEREKEN BECERİLER : Temel geliştirici becerileri

Varsayılan olarak, Zonos Hello bayrağı sayfanızın sağ alt köşesinde görünecektir.

Burada bayrağın konumunu nasıl değiştireceğiniz ve uluslararası müşterilerin görmek istemediği belirli web sitesi öğelerini nasıl gizleyeceğiniz hakkında bazı bilgiler bulacaksınız.

Örnek: Uluslararası müşterilerden ücretsiz kargoyu gizlemek; bu, Zonos Hello'yı yerel müşterilerden ve belirli ülkelerden gizlemenizi de sağlayacaktır.

Konum boş bırakılırsa, kod varsayılanı kullanacaktır.

Hello entegrasyon scripti

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

Sol alt köşe için:

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

Sol üst köşe için, yüzen bir bilgi penceresi ile:

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

  • floating, sayfanın ortasında yüzen Hello bilgi penceresini ifade eder.
  • attached, bayrağın üzerinde açılan Hello bilgi penceresini ifade eder.
  • Bayrağı top konumlandırırken floating tercih edilir.

Belirli içeriği gizle

GEREKEN BECERİLER: Temel geliştirici becerileri

z-intl sınıfı mevcut yerel ülkeye dayanmaktadır. Eğer Hello uluslararası bir ülkeye ayarlandıysa, z-intl sınıfı, .z-intl ile bağlı olan içeriği gizleyen bir gizli sınıf olarak işlev görecektir.

İçeriği gizlemek için aşağıdaki CSS'i kullanın. .your-content kısmını gizlemek istediğiniz yüzen içerik ile değiştirin.
.z-intl .your-content { display: none; }

Artık Hello'yı yerel müşterilerinizden gizleyebilir, böylece diğer pencerelerin görünür olmasını sağlayabilirsiniz.

Hello entegrasyon scripti

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

Belirli ülkeler için gizle

.z-intl { display: none; } fonksiyonuna, o ülke için CSS sınıfı olarak işlev gören ülke kodu ile birleştirilmiş #zonos kimliğini ekleyin.

Satır şöyle görünmelidir:

Hello entegrasyon scripti

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

Splash'ı aç/kapat

GEREKEN BECERİLER: Temel geliştirici becerileri

Splash, müşterilerin ülkesine özgü gümrük ve vergi politikasıyla ilgili ek bilgileri içeren Zonos iletişim kutusunun açılması ve büyütülmesi anlamına gelir.\

Eğer müşterilerinizin ilk ziyareti için Zonos Hello splash'ını AÇMAK ve görüntülemek istiyorsanız:

Hello entegrasyon scripti

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

Eğer müşterilerinizin ilk ziyareti için Zonos Hello açılış ekranını KAPATMAK istiyorsanız:

Hello entegrasyon scripti

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

Not: Herhangi bir Zonos özelleştirme script etiketinin içinde olmalıdır.

Sıkça Sorulan Sorular 

Ben bir geliştirici değilim ve yardıma ihtiyacım var. Seçeneklerim neler?

Sorularınız varsa, lütfen destek ekibimizle iletişime geçin. Entegrasyonu tamamlamak için kaynaklarınız yoksa ve yardıma ihtiyacınız varsa, lütfen Profesyonel Hizmetler ekibimizle iletişime geçin.

Bu sayfa yardımcı oldu mu?

© 2024 Zonoszonos.com
Bu sayfada:
  • Hello mirasını kurun
  • Hello'yu sitenize ekleyin
  • Alıntı alanları
  • Ürün alanları
  • Özelleştir Hello
  • Sıkça Sorulan Sorular