Гид

Добавьте виджет eSIM на свой сайт одним тегом script

Виджет Atli умещает магазин eSIM для поездок и ваш партнёрский код в один тег script. Как настроить, оформить, отслеживать продажи и тестировать в Sandbox.

Веб-страница в браузере со встроенным под статьёй виджетом Atli eSIM, в котором перечислены направления и цены, и крылатый синий талисман Atli с карточками тарифов

Виджет Atli позволяет добавить на ваш сайт полноценный магазин туристических eSIM с помощью одного тега script. Посетители могут искать направления, сравнивать тарифы, оплачивать покупки и получать QR-коды своих eSIM, не уходя с вашей страницы. Ваш партнёрский код включён в скрипт, чтобы покупки, соответствующие условиям, засчитывались вашему аккаунту.

Встраивание ничего не стоит и не требует сборки. Каталог, оплату и выдачу eSIM берёт на себя Atli. Для установки требуются только один контейнер и один тег script.

На этой странице работает настоящий виджет:

Как добавить виджет на страницу

Войдите на partners.heyatli.com и откройте Интеграции. В карточке Встраиваемый виджет лежит код для вашего сайта, и ваш партнёрский код в нём уже стоит. Кнопка Настроить открывает конструктор виджета на partners.heyatli.com/ru/dev/atli-widget: там можно поменять любую настройку и снова скопировать код.

Карточка «Встраиваемый виджет» на странице «Интеграции» в partners.heyatli.com с кодом для вашего сайта и кнопками «Предпросмотр» и «Настроить»

Если вы предпочитаете добавить код напрямую, замените YOUR_CODE на свой партнёрский код:

HTML
<div id="heyatli-esim-checkout-container"></div>
<script
  src="https://embed.heyatli.com/embed.js"
  data-atli-widget
  data-target="#heyatli-esim-checkout-container"
  data-referral="YOUR_CODE"
  defer
></script>

Вставьте его в HTML страницы там, где должен появиться магазин. Виджет занимает всю ширину контейнера и вытягивается по высоте под то, что в нём показано. Высоту задавать не нужно. Если убрать <div> и data-target, виджет появится сразу после тега script.

Скрипт весит около 17 КБ, и больше ничего устанавливать не нужно. Он загружает магазин во фрейме с embed.heyatli.com, а этот фрейм не может прочитать ни вашу страницу, ни её cookie, ни её хранилище. Данные карты вводятся в платёжную форму Stripe внутри фрейма.

Виджет для одного направления

Для страниц об отдельной стране виджет можно настроить так, чтобы он показывал тарифы для этого направления. Этот вариант для путеводителя на немецком языке открывается на Японии и показывает цены в евро:

HTML
<div id="japan-esim"></div>
<script
  src="https://embed.heyatli.com/embed.js"
  data-atli-widget
  data-target="#japan-esim"
  data-referral="YOUR_CODE"
  data-destination="jp"
  data-lang="de"
  data-lang-priority="widget"
  data-currency="EUR"
  defer
></script>
Виджет Atli, открытый на Японии на немецком языке с ценами в евро: безлимитные тарифы от 5 до 30 дней, у каждого кнопка eSIM kaufen

data-destination принимает двухбуквенный код страны (jp), название страны на любом из языков виджета (Japan, 日本), регион (europe, south_east_asia) или ID тарифа. ID тарифа сразу открывает оформление его покупки. Виджет открывает направление, только если находит корректное совпадение. В противном случае он показывает главный экран по умолчанию. Искать по всем направлениям посетители могут в любом случае.

data-favorites помещает на вкладку Топ до 32 ваших собственных направлений и сохраняет порядок, в котором вы их перечислили. Например: data-favorites="jp, kr, tw, asia".

Настройки виджета

Все настройки необязательны. В теге script каждая из них задаётся атрибутом data-. В JavaScript у неё то же имя в camelCase: data-lang-priority превращается в langPriority.

АтрибутЧто делает
data-referralВаш партнёрский код. Новые клиенты, сделавшие покупку, привязываются к вам.
data-destinationОткрывает виджет на одном направлении или тарифе.
data-favoritesДо 32 направлений для вкладки Топ через запятую.
data-langЯзык виджета. Без этого атрибута используется язык браузера посетителя.
data-lang-prioritywidget сохраняет ваш язык, даже если посетитель выбрал другой, и скрывает меню выбора языка.
data-currencyВалюта цен и оплаты. По умолчанию USD.
data-currency-prioritywidget сохраняет вашу валюту, даже если посетитель выбрал другую.
data-themelight или dark. Без этого атрибута используется настройка устройства посетителя.
data-theme-prioritywidget сохраняет вашу тему и скрывает её переключатель.
data-cssАдрес вашего собственного файла стилей для виджета, начинающийся с https://.
data-bootОткрывает один из личных экранов посетителя: esims, credits, vouchers, refer, settings, payment-methods, groups или profile. esim открывает страницу установки eSIM, которой поделились, и аккаунт для неё не нужен. Код нужной eSIM передайте в data-lpa.
data-anonymous-cardstrue позволяет посетителям, которые не вошли в аккаунт, сохранить карту в этом браузере. По умолчанию выключено.
data-stripe-linkfalse убирает Stripe Link из платёжной формы.
data-analyticsoff не даёт виджету загружать собственную аналитику.
data-consentall, analytics или none: значение должно совпадать с согласием, которое собрал ваш cookie-баннер.
data-envstaging запускает виджет в Sandbox Atli. На рабочей странице этот атрибут не указывайте.

Виджет поддерживает 15 языков: en английский, pt португальский, es испанский, fr французский, it итальянский, de немецкий, pl польский, ru русский, zh китайский, ko корейский, ja японский, id индонезийский, vi вьетнамский, ms малайский и ar арабский. Цены он показывает в AUD, CAD, EUR, GBP, HKD, JPY, KRW, SGD, TWD, USD и VND. Неподдерживаемые значения игнорируются. Например, при data-currency="EUROS" по умолчанию используется USD.

Виджет в одностраничном приложении

Тег script инициализирует виджет при загрузке страницы, но не реагирует автоматически на изменения маршрутизации в вашем приложении. В React, Vue, Next.js или любом другом приложении, которое меняет страницы без перезагрузки, подключите скрипт в HTML один раз и монтируйте виджет из своего кода:

HTML
<script src="https://embed.heyatli.com/embed.js"></script>
JavaScript
const widget = HeyAtli.init({
  target: '#esim',
  referral: 'YOUR_CODE',
  destination: 'jp',
  lang: 'de',
  currency: 'EUR',
});

// Change settings later without rebuilding the frame
widget.update({ destination: 'th' });

// Remove it when the page goes away
widget.destroy();

target принимает CSS-селектор или элемент. update() объединяет переданные значения с текущими настройками и не перезагружает фрейм. В React виджету хватает одного эффекта:

JSX
import { useEffect, useRef } from 'react';

export function EsimStore({ destination }) {
  const ref = useRef(null);

  useEffect(() => {
    const widget = window.HeyAtli.init({
      target: ref.current,
      referral: 'YOUR_CODE',
      destination,
    });
    return () => widget.destroy();
  }, [destination]);

  return <div ref={ref} />;
}

В режиме разработки Strict Mode в React запускает каждый эффект, выполняет очистку и запускает эффект снова. Добавьте destroy() в функцию очистки, чтобы не появлялись дублирующиеся экземпляры виджета.

Оформление через CSS

Передайте в data-css полный адрес файла стилей на вашем сайте, начинающийся с https://. Виджет загружает этот файл внутри фрейма после собственных стилей, поэтому обычные селекторы перебивают их без !important. Если файл не загрузится, виджет останется в оформлении по умолчанию.

Одна строка вам неподвластна. Каждый экран заканчивается строкой Работает на Atli | Поддержка, которую ваш файл стилей не может ни переоформить, ни скрыть. Если файл стилей прячет, приглушает, обрезает или перекрывает её, виджет отбрасывает этот файл и до конца визита возвращается к оформлению по умолчанию, а консоль браузера объясняет причину.

Начните с CSS-переменных виджета. Посетитель может видеть как светлую, так и тёмную тему, поэтому задайте переменные для обеих:

CSS
.atli-widget {
  --atli-font-family: 'Inter', system-ui, sans-serif;
  --atli-color-accent: #0f766e;
  --atli-color-accent-hover: #115e59;
  --atli-color-accent-text: #ffffff;
  --atli-radius-md: 6px;
}

.atli-widget[data-theme='dark'] {
  --atli-color-accent: #2dd4bf;
  --atli-color-accent-hover: #5eead4;
  --atli-color-accent-text: #042f2e;
}

Готовые примеры с комментариями ко всем распространённым переменным лежат в sunset.css и mono.css. Поля карты находятся в собственном фрейме Stripe, куда не дотягивается ни один файл стилей. Поэтому, собирая платёжную форму, виджет передаёт Stripe ваш акцентный цвет, цвета текста и поверхностей, шрифт и радиус скругления углов.

Одна и та же страница Японии в виджете Atli в четырёх вариантах: светлое оформление по умолчанию, тёмная тема, sunset.css с оранжевыми кнопками и шрифтом с засечками и mono.css с моноширинным шрифтом и серыми кнопками

Настройка через CSS позволяет привести виджет в соответствие с фирменным стилем вашего сайта. Для полного контроля над интерфейсом используйте API Atli, что потребует дополнительной разработки.

Как отслеживать покупки через события виджета

Виджет отправляет события, по которым ваш сайт может отслеживать действия посетителей и покупки. Чтобы передавать покупки в аналитику, монтируйте виджет через HeyAtli.init() и слушайте purchase.completed. Этот обработчик отправляет каждую покупку в Google Tag Manager в формате электронной торговли GA4:

JavaScript
const widget = HeyAtli.init({ target: '#esim', referral: 'YOUR_CODE' });

widget.on('purchase.completed', function (detail) {
  window.dataLayer = window.dataLayer || [];
  window.dataLayer.push({ ecommerce: null });
  window.dataLayer.push({
    event: 'purchase',
    ecommerce: {
      transaction_id: detail.transactionId,
      value: detail.value,
      currency: detail.currency,
      items: detail.items,
    },
  });
});

items приходит в формате товаров GA4, поэтому попадает в dataLayer без изменений. value указан в основных единицах валюты и выглядит как 12.99, а не 1299. Первый push очищает предыдущий объект ecommerce: Google рекомендует делать это перед каждым событием электронной торговли.

Среди других событий есть checkout.opened, payment.started и payment.failed. Обработчик получает (detail, info), а info.action называет событие, поэтому widget.on('*', handler) может переслать их все. Чтобы выводить каждое событие в консоль браузера, добавьте debug: true в init() или data-debug="true" в тег script.

События доходят только до доменов из списка разрешённых у Atli. В нём есть heyatli.com и localhost, так что разрабатывать можно на своей машине. По той же причине обработчик, который работает на localhost, может перестать слышать события на рабочем сайте. Чтобы добавить ваш домен в список, напишите на [email protected]. Виджет может обрабатывать покупки, даже если отслеживание событий недоступно.

Тестирование в Sandbox

Чтобы запустить виджет в Sandbox Atli, добавьте data-env="staging" или env: 'staging' в HeyAtli.init(). В углу появится метка «Песочница», а в тестовом баннере бледно проступит ваш партнёрский код, чтобы вы могли убедиться, что страница его подхватила. Платите тестовой картой Stripe 4242 4242 4242 4242 с любым будущим сроком действия и любым CVC. Аккаунты в Sandbox отделены от настоящих. eSIM в Sandbox выпускает тестовый оператор, поэтому установить их на телефон нельзя, а продажи в Sandbox никогда не приносят комиссии.

По умолчанию виджет работает в рабочей среде. Перед публикацией уберите data-env="staging", так как Sandbox принимает только тестовые платежи.

Как засчитываются продажи через виджет

Посетитель, купивший в виджете, привязывается к вам, когда входит в аккаунт или платит, если только его не опередили код другого партнёра или более ранняя покупка. Виджет помнит ваш код в браузере посетителя 72 часа, поэтому вернувшийся на следующий день посетитель всё равно ваш. После первой покупки привязка становится постоянной, и следующие покупки в том же аккаунте Atli тоже засчитываются вам.

Цены такие же, как в магазине Atli, а скидка по вашему коду видна при оплате. О заработке и выплатах рассказывает гид по партнёрской программе Atli.

Частые вопросы

Виджет Atli платный?
Нет. Встраивание бесплатное, а оплату принимает и eSIM выдаёт Atli. Вы получаете свою долю дохода с того, что покупают ваши посетители.
Нужен ли мне собственный аккаунт Stripe?
Нет. Виджет принимает оплату на аккаунт Stripe компании Atli внутри своего фрейма, поэтому данные карты никогда не попадают на ваш сайт. В выписке по карте покупателя будет стоять имя Atli.
Можно ли установить eSIM прямо из виджета?
Да. После оплаты посетитель получает QR-код своей eSIM, ссылки для установки на iPhone и Android и данные для ручной установки. Шаги на самом телефоне описаны в наших гидах для iPhone и Android.
Можно ли ограничить виджет странами, о которых я пишу?
Отчасти. data-destination открывает его на одном направлении, а data-favorites помещает на вкладку Топ до 32 ваших направлений. Искать по всему каталогу посетители всё равно могут.
Не замедлит ли виджет мою страницу?
При загрузке не замедлит. Сам загрузчик весит около 17 КБ, а магазин подтягивается, только когда фрейм приближается к видимой части страницы. Если виджет стоит ближе к концу статьи, его содержимое загрузится, когда посетитель приблизится к этому разделу.
Можно ли поставить на одну страницу два виджета?
Да. Дайте каждому свой контейнер и тег script или вызовите HeyAtli.init() по разу для каждого контейнера.