
Widżet Atli pozwala dodać do twojej strony kompletny sklep z eSIM na podróż za pomocą jednego tagu script. Odwiedzający mogą wyszukiwać kierunki, porównywać pakiety, płacić i otrzymywać kody QR swoich eSIM, nie opuszczając strony. Twój kod partnera jest zawarty w skrypcie, dzięki czemu kwalifikujące się zakupy są przypisywane do twojego konta.
Osadzenie nic nie kosztuje i nie wymaga etapu budowania. Atli prowadzi katalog, płatności i dostawę eSIM. Instalacja wymaga tylko jednego kontenera i jednego tagu script.
Na tej stronie działa prawdziwy widżet:
Jak dodać widżet do strony
Zaloguj się na partners.heyatli.com i otwórz Integracje. Karta Widżet osadzony pokazuje kod na twoją stronę, w którym jest już twój kod partnera. Przycisk Dostosuj otwiera kreator widżetu pod adresem partners.heyatli.com/pl/dev/atli-widget, gdzie zmienisz każde ustawienie i ponownie skopiujesz kod.

Jeśli wolisz dodać kod bezpośrednio, zastąp YOUR_CODE swoim kodem partnera:
<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>Wklej go w HTML strony tam, gdzie ma się pojawić sklep. Widżet zajmuje całą szerokość kontenera i rośnie do wysokości tego, co akurat pokazuje. Wysokości nie trzeba ustawiać. Jeśli pominiesz <div> i data-target, widżet pojawi się zaraz za tagiem script.
Skrypt waży około 17 KB i nie wymaga instalowania niczego więcej. Ładuje sklep w ramce z embed.heyatli.com, a ta ramka nie może odczytać twojej strony, jej plików cookie ani jej pamięci lokalnej. Dane karty trafiają do formularza płatności Stripe wewnątrz ramki.
Otwieranie na jednym kierunku
Na stronach poświęconych jednemu krajowi możesz ustawić widżet tak, żeby pokazywał pakiety dla tego kierunku. Ta wersja otwiera się na Japonii w poradniku po niemiecku i pokazuje ceny w euro:
<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 przyjmuje dwuliterowy kod kraju (jp), nazwę kraju w dowolnym z języków widżetu (Japan, 日本), region (europe, south_east_asia) albo ID pakietu. ID pakietu otwiera płatność za ten pakiet. Widżet otwiera kierunek tylko wtedy, gdy znajdzie prawidłowe dopasowanie. W przeciwnym razie wyświetla domyślny ekran startowy. Odwiedzający i tak mogą wyszukać każdy kierunek.
data-favorites układa w zakładce Top do 32 wybranych przez ciebie kierunków i zachowuje kolejność, w jakiej je podasz. Na przykład: data-favorites="jp, kr, tw, asia".
Ustawienia widżetu
Każde ustawienie jest opcjonalne. W tagu script każde z nich to atrybut data-. W JavaScripcie to ta sama nazwa w camelCase: data-lang-priority zmienia się w langPriority.
| Atrybut | Co robi |
|---|---|
data-referral | Twój kod partnera. Nowi klienci, którzy kupią, zostają przypisani do ciebie. |
data-destination | Otwiera widżet na jednym kierunku lub pakiecie. |
data-favorites | Lista do 32 kierunków po przecinku dla zakładki Top. |
data-lang | Język widżetu. Bez tego atrybutu widżet używa języka przeglądarki odwiedzającego. |
data-lang-priority | widget zachowuje twój język, nawet jeśli odwiedzający wybrał inny, i ukrywa menu języka. |
data-currency | Waluta cen i płatności. Domyślnie USD. |
data-currency-priority | widget zachowuje twoją walutę, nawet jeśli odwiedzający wybrał inną. |
data-theme | light lub dark. Bez tego atrybutu widżet bierze ustawienie z urządzenia odwiedzającego. |
data-theme-priority | widget zachowuje twój motyw i ukrywa ustawienie motywu. |
data-css | Adres https:// twojego własnego arkusza stylów dla widżetu. |
data-boot | Otwiera jeden z ekranów odwiedzającego: esims, credits, vouchers, refer, settings, payment-methods, groups lub profile. esim otwiera bez konta stronę instalacji udostępnionej eSIM, której kod podajesz w data-lpa. |
data-anonymous-cards | true pozwala niezalogowanym odwiedzającym zapisać kartę w tej przeglądarce. Domyślnie wyłączone. |
data-stripe-link | false usuwa Stripe Link z formularza płatności. |
data-analytics | off sprawia, że widżet nie ładuje własnej analityki. |
data-consent | Przekazuje zgody zebrane przez twój baner cookie: all, analytics lub none. |
data-env | staging uruchamia widżet w Sandbox Atli. Na stronie produkcyjnej go pomiń. |
Widżet obsługuje 15 języków: en angielski, pt portugalski, es hiszpański, fr francuski, it włoski, de niemiecki, pl polski, ru rosyjski, zh chiński, ko koreański, ja japoński, id indonezyjski, vi wietnamski, ms malajski i ar arabski. Ceny podaje w AUD, CAD, EUR, GBP, HKD, JPY, KRW, SGD, TWD, USD i VND. Nieobsługiwane wartości są ignorowane. Na przykład przy data-currency="EUROS" widżet domyślnie użyje USD.
Jak dodać widżet do aplikacji SPA
Tag script inicjalizuje widżet podczas wczytywania strony, ale nie reaguje automatycznie na zmiany routingu w twojej aplikacji. W React, Vue, Next.js czy dowolnej aplikacji, która zmienia strony bez przeładowania, wczytaj skrypt raz w HTML i montuj widżet ze swojego kodu:
<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 przyjmuje selektor CSS albo element. update() scala to, co przekażesz, z bieżącymi ustawieniami i nie przeładowuje ramki. W React widżet zamyka się w jednym efekcie:
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} />;
}W trybie deweloperskim Strict Mode w React uruchamia każdy efekt, czyści go i uruchamia ponownie. Umieść destroy() w funkcji czyszczącej, żeby zapobiec powstawaniu zduplikowanych instancji widżetu.
Stylowanie widżetu w CSS
Podaj w data-css pełny adres https:// arkusza stylów ze swojej strony. Widżet wczytuje go wewnątrz ramki po własnych stylach, więc zwykłe selektory wygrywają bez !important. Jeśli plik się nie wczyta, widżet zachowa domyślny wygląd.
Jednej linijki nie ruszysz. Każdy ekran kończy się stopką Obsługiwane przez Atli | Pomoc, której twój arkusz stylów nie może ani zmienić, ani ukryć. Arkusz, który ją ukrywa, wygasza, przycina lub zasłania, zostaje odrzucony, widżet do końca wizyty wraca do domyślnego wyglądu, a konsola przeglądarki podaje powód.
Zacznij od zmiennych CSS widżetu. Odwiedzający mogą widzieć jasny albo ciemny motyw. Ustaw zmienne dla obu:
.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 i mono.css to gotowe przykłady z komentarzami, które obejmują wszystkie popularne zmienne. Pola karty siedzą we własnej ramce Stripe, do której nie sięga żaden arkusz stylów. Zamiast tego widżet przy budowaniu formularza płatności przekazuje do Stripe twoje kolory akcentu, tekstu i tła, czcionkę oraz promień zaokrąglenia rogów.

Dzięki CSS dopasujesz widżet do identyfikacji wizualnej swojej strony. Jeśli potrzebujesz pełnej kontroli nad interfejsem, użyj API Atli, co wymaga dodatkowej pracy programistycznej.
Śledzenie zakupów przez zdarzenia widżetu
Widżet wysyła zdarzenia, dzięki którym twoja strona może śledzić aktywność odwiedzających i zakupy. Żeby wysyłać zakupy do analityki, zamontuj go przez HeyAtli.init() i nasłuchuj purchase.completed. Ten handler przekazuje każdy zakup do narzędzia Google Tag Manager w formacie e-commerce 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 przychodzi w formacie elementów GA4, więc trafia do dataLayer bez zmian. value jest podawane w głównej jednostce waluty: 12.99, a nie 1299. Pierwszy push czyści poprzedni obiekt ecommerce, co Google zaleca przed każdym zdarzeniem e-commerce.
Inne zdarzenia to między innymi checkout.opened, payment.started i payment.failed. Handler dostaje (detail, info), a info.action podaje nazwę zdarzenia, więc widget.on('*', handler) może przekazać dalej wszystkie. Żeby logować każde zdarzenie w konsoli przeglądarki, dodaj debug: true do init() albo data-debug="true" do tagu script.
Zdarzenia docierają tylko do domen z listy dozwolonych Atli. Są na niej heyatli.com i localhost, więc możesz budować na własnym komputerze. Z tego samego powodu handler, który działa na localhost, może przestać słyszeć zdarzenia na stronie produkcyjnej. Napisz na [email protected] z prośbą o dodanie twojej domeny. Widżet może obsługiwać zakupy nawet wtedy, gdy śledzenie zdarzeń jest niedostępne.
Testowanie w Sandbox
Dodaj data-env="staging" albo env: 'staging' w HeyAtli.init(), żeby uruchomić widżet w Sandbox Atli. W rogu pojawia się oznaczenie Sandbox, a twój kod partnera widać blado na testowym banerze, więc sprawdzisz, czy strona go odczytała. Zapłać testową kartą Stripe 4242 4242 4242 4242 z dowolną przyszłą datą ważności i dowolnym kodem bezpieczeństwa. Konta w Sandbox są oddzielone od prawdziwych. Tamtejsze eSIM pochodzą od testowego operatora, więc nie da się ich zainstalować na telefonie, a sprzedaż w Sandbox nigdy nie daje prowizji.
Domyślnie widżet działa w środowisku produkcyjnym. Usuń data-env="staging" przed publikacją, ponieważ Sandbox przyjmuje tylko płatności testowe.
Jak przypisywana jest sprzedaż z widżetu
Odwiedzający, który kupi w widżecie, zostaje przypisany do ciebie, gdy się zaloguje albo zapłaci, chyba że wcześniej użył kodu innego partnera albo już kiedyś kupował. Widżet pamięta twój kod w przeglądarce odwiedzającego przez 72 godziny, więc ktoś, kto wróci następnego dnia, nadal się liczy. Po tym pierwszym zakupie przypisanie jest stałe, a kolejne zakupy na tym samym koncie Atli też liczą się dla ciebie.
Ceny są takie same jak w sklepie Atli, a zniżka z twojego kodu pojawia się przy płatności. Zarobki i wypłaty opisuje poradnik Jak program partnerski Atli płaci za polecenia.
FAQ
Czy widżet Atli coś kosztuje?
Czy potrzebuję własnego konta Stripe?
Czy odwiedzający mogą zainstalować eSIM z widżetu?
Czy mogę ograniczyć widżet do krajów, o których piszę?
data-destination otwiera go na jednym kierunku, a data-favorites układa w zakładce Top do 32 twoich kierunków. Odwiedzający nadal mogą przeszukać cały katalog.Czy widżet spowolni moją stronę?
Czy mogę umieścić dwa widżety na jednej stronie?
HeyAtli.init() raz dla każdego kontenera.


