Hello•

ДомойГлобальная электронная коммерция Интеграция Установка

Установка Hello legacy

Узнайте, как установить Hello на сайте вашего магазина.

Если вы используете Shopify, BigCommerce, Magento, Miva или X-Cart, пожалуйста, прочитайте соответствующую страницу интеграции плагина.

Скрипт ниже добавит флаг Zonos Hello на ваш сайт, определит страну, из которой ваши клиенты посещают сайт, поприветствует их и предоставит общую информацию о пошлинах и налогах для их страны (базовая).

Дополнительные функции доступны с минимальными затратами на разработку (показаны ниже).

Добавить Hello на ваш сайт

Добавить скрипт Hello - базовый

Добавление этого скрипта в код вашего сайта добавит флаг Zonos Hello на ваш веб-сайт, определит страну, из которой ваши клиенты посещают сайт, поприветствует их и предоставит общую информацию о пошлинах и налогах для их страны.

НЕОБХОДИМЫЕ НАВЫКИ: Базовые веб-навыки

Чтобы установить Hello, вставьте пользовательский скрипт с вашим уникальным ключом сайта на ваш веб-сайт перед закрывающим тегом body.

Hello интеграционный скрипт

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

Zonos Hello должен быть загружен перед добавлением любой дополнительной функциональности. Пожалуйста, включите любые дополнительные функции после вышеуказанного скрипта.

Еще нет скрипта? Нажмите здесь, чтобы скачать.

Генерация оценок пошлин и налогов

НЕОБХОДИМЫЕ НАВЫКИ: Базовые навыки разработчика

Когда эта функция включена, Hello может предоставлять оценки пошлин и налогов, когда продукт просматривается или добавляется в корзину. Hello также может отображать полные оценки пошлин и налогов для всей корзины при просмотре страницы.

Оценка пошлин и налогов может быть размещена на каждой странице продукта или на вашей главной странице продукта, в зависимости от того, как настроена ваша платформа.

Чтобы добавить оценку пошлин и налогов, примените скрипт, который выглядит как показано ниже. Два обязательных поля — name и price.

Пример: Ниже приведен пример того, как будет выглядеть и функционировать скрипт на вашей странице.

Hello интеграционный скрипт

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

Скрипты, которые могут быть использованы, необходимо будет настроить, чтобы они работали на вашем сайте. Пожалуйста, убедитесь, что любой из следующих скриптов, которые вы используете, размещен после начального Zonos Hello скрипта.

Если вы не используете платформу, вы можете использовать следующее, чтобы динамически получить детали вашего продукта. Этот скрипт захватит первый доступный продукт. Вы также можете настроить этот скрипт для использования на странице корзины вашего сайта. Вам нужно будет пройтись по всем продуктам и их данным, а затем отправить это в zonos.quote.

Hello интеграционный скрипт

<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>

Вы можете добавить дополнительные значения из полей элементов ниже и также изменить currencyCode на вашу валюту по умолчанию.

Shopify и BigCommerce

Если вы используете Shopify или BigCommerce, используйте код ниже.

Shopify

BigCommerce

Если вы используете Shopify в качестве вашей платформы, у нас есть скрипт, который вы можете использовать, чтобы получить данные о продукте из деталей вашего продукта Shopify.

Ниже приведенный код содержит функцию, которая будет выполняться на страницах продуктов и на странице корзины.

Hello интеграционный скрипт

<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>

Поля для котировок

Поле	Тип данных	Описание
`items`	array ТРЕБУЕТСЯ	Список предметов, которые нужно включить в котировку
`currencyCode`	string	Цены на товары будут отображаться в валюте, указанной трехсимвольным кодом валюты. По умолчанию: USD
`includedTaxRate`	number	Налог на товар rate если товар включает налог
`showDecimal`	bool	Включает или отключает отображение десятичного значения для конвертированных валют

Поля для товаров

Поле	Тип данных	Описание
`name`	string ТРЕБУЕТСЯ	Название продукта
`price`	number ТРЕБУЕТСЯ	Цена за единицу одного продукта
`quantity`	integer	Количество продуктов в корзине. По умолчанию: 1
`image`	string	URL изображения продукта
`url`	string	URL на отдельный продукт
`hsCode`	string	Гармонизированный код (HS код) для вашего продукта
`category`	string	Категория продукта на вашем сайте
`country`	string	Двухсимвольный ISO код страны, из которой произошел этот продукт
`customization`	string	Настройка продукта (например, размер, цвет)
`description`	string	Подробное описание продукта
`sku`	string	UPC или SKU продукта

По мере того как вы предоставляете больше информации Zonos о вашем продукте, точность оценки обычно улучшается.

Настроить Hello

Изменить местоположение флага

НЕОБХОДИМЫЕ НАВЫКИ: Базовые навыки разработчика

По умолчанию флаг Zonos Hello будет отображаться в правом нижнем углу вашей страницы.

Здесь вы найдете информацию о том, как изменить местоположение флага, а также скрыть определенные элементы вашего веб-сайта, которые вы не хотите, чтобы международные клиенты видели.

Пример: Скрытие бесплатной доставки от международных клиентов; это также позволит вам скрыть Zonos Hello от местных клиентов и определенных стран.

Если местоположение оставлено пустым, код будет использовать значение по умолчанию.

Hello интеграционный скрипт

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

Для нижнего левого угла:

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

Для верхнего левого угла с плавающим информационным диалогом:

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

floating относится к Hello информационному диалогу, который плавает в центре страницы.
attached относится к Hello информационному диалогу, который открывается над флагом.
floating предпочтителен при позиционировании флага в top.

Скрыть конкретный контент

НЕОБХОДИМЫЕ НАВЫКИ: Базовые навыки разработчика

Класс z-intl основан на текущей внутренней стране. Если Hello установлен на международную страну, класс z-intl будет действовать как скрытый класс, скрывая контент, к которому привязан .z-intl.

Используйте следующий CSS для скрытия контента. Замените .your-content на плавающий контент, который вы хотите скрыть.
.z-intl .your-content { display: none; }

Теперь вы можете скрыть Hello от ваших внутренних клиентов, чтобы другие диалоги снова были видны.

Hello интеграционный скрипт

#zonos {
  display: none;
}
.z-intl #zonos {
  display: block;
}

Скрыть для конкретных стран

Добавьте #zonos идентификатор, комбинируя его с кодом страны, который также служит в качестве CSS класса для этой страны, в функцию .z-intl { display: none; }.

Строка должна выглядеть примерно так:

Hello интеграционный скрипт

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

Включить/выключить всплывающее окно

НЕОБХОДИМЫЕ НАВЫКИ: Базовые навыки разработчика

Всплывающее окно относится к появлению и увеличению диалогового окна Zonos, которое содержит дополнительную информацию о специфической политике пошлин и налогов в их стране.\

Если вы хотите ВКЛЮЧИТЬ и отобразить всплывающее окно Zonos Hello для первого визита ваших клиентов:

Hello интеграционный скрипт

zonos.config({ showSplash: true });

Если вы хотите отключить заставку Zonos Hello для первого визита ваших клиентов:

Hello интеграционный скрипт

zonos.config({ showSplash: false });

Примечание: Любые Zonos настройки должны быть внутри тега script.

Часто задаваемые вопросы

Я не разработчик и мне нужна помощь. Какие у меня есть варианты?

Если у вас есть вопросы, пожалуйста, свяжитесь с нашей службой поддержки. Если у вас нет ресурсов для завершения интеграции и вам нужна помощь, пожалуйста, свяжитесь с нашей командой профессиональных услуг.

Была ли эта страница полезной?

Вопросы?

Свяжитесь с нами.

Посмотреть Zonos

политики и соглашения