
Виджет Atli позволяет добавить на ваш сайт полноценный магазин туристических eSIM с помощью одного тега script. Посетители могут искать направления, сравнивать тарифы, оплачивать покупки и получать QR-коды своих eSIM, не уходя с вашей страницы. Ваш партнёрский код включён в скрипт, чтобы покупки, соответствующие условиям, засчитывались вашему аккаунту.
Встраивание ничего не стоит и не требует сборки. Каталог, оплату и выдачу eSIM берёт на себя Atli. Для установки требуются только один контейнер и один тег script.
На этой странице работает настоящий виджет:
Как добавить виджет на страницу
Войдите на partners.heyatli.com и откройте Интеграции. В карточке Встраиваемый виджет лежит код для вашего сайта, и ваш партнёрский код в нём уже стоит. Кнопка Настроить открывает конструктор виджета на partners.heyatli.com/ru/dev/atli-widget: там можно поменять любую настройку и снова скопировать код.

Если вы предпочитаете добавить код напрямую, замените YOUR_CODE на свой партнёрский код:
<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 внутри фрейма.
Виджет для одного направления
Для страниц об отдельной стране виджет можно настроить так, чтобы он показывал тарифы для этого направления. Этот вариант для путеводителя на немецком языке открывается на Японии и показывает цены в евро:
<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>
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-priority | widget сохраняет ваш язык, даже если посетитель выбрал другой, и скрывает меню выбора языка. |
data-currency | Валюта цен и оплаты. По умолчанию USD. |
data-currency-priority | widget сохраняет вашу валюту, даже если посетитель выбрал другую. |
data-theme | light или dark. Без этого атрибута используется настройка устройства посетителя. |
data-theme-priority | widget сохраняет вашу тему и скрывает её переключатель. |
data-css | Адрес вашего собственного файла стилей для виджета, начинающийся с https://. |
data-boot | Открывает один из личных экранов посетителя: esims, credits, vouchers, refer, settings, payment-methods, groups или profile. esim открывает страницу установки eSIM, которой поделились, и аккаунт для неё не нужен. Код нужной eSIM передайте в data-lpa. |
data-anonymous-cards | true позволяет посетителям, которые не вошли в аккаунт, сохранить карту в этом браузере. По умолчанию выключено. |
data-stripe-link | false убирает Stripe Link из платёжной формы. |
data-analytics | off не даёт виджету загружать собственную аналитику. |
data-consent | all, analytics или none: значение должно совпадать с согласием, которое собрал ваш cookie-баннер. |
data-env | staging запускает виджет в 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 один раз и монтируйте виджет из своего кода:
<script src="https://embed.heyatli.com/embed.js"></script>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 виджету хватает одного эффекта:
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-переменных виджета. Посетитель может видеть как светлую, так и тёмную тему, поэтому задайте переменные для обеих:
.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 ваш акцентный цвет, цвета текста и поверхностей, шрифт и радиус скругления углов.

Настройка через CSS позволяет привести виджет в соответствие с фирменным стилем вашего сайта. Для полного контроля над интерфейсом используйте API Atli, что потребует дополнительной разработки.
Как отслеживать покупки через события виджета
Виджет отправляет события, по которым ваш сайт может отслеживать действия посетителей и покупки. Чтобы передавать покупки в аналитику, монтируйте виджет через HeyAtli.init() и слушайте purchase.completed. Этот обработчик отправляет каждую покупку в Google Tag Manager в формате электронной торговли GA4:
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 платный?
Нужен ли мне собственный аккаунт Stripe?
Можно ли установить eSIM прямо из виджета?
Можно ли ограничить виджет странами, о которых я пишу?
data-destination открывает его на одном направлении, а data-favorites помещает на вкладку Топ до 32 ваших направлений. Искать по всему каталогу посетители всё равно могут.Не замедлит ли виджет мою страницу?
Можно ли поставить на одну страницу два виджета?
HeyAtli.init() по разу для каждого контейнера.


