Panduan

Pasang widget eSIM di situs web dengan satu tag script

Widget Atli memuat toko eSIM perjalanan lengkap dan kode mitra Anda di satu tag script. Cara memasang, menata, melacak penjualan, dan menguji di Sandbox.

Halaman web di browser dengan widget Atli eSIM berisi daftar destinasi dan harga di bawah artikel, di samping maskot biru Atli bersayap yang memegang kartu paket

Widget Atli memungkinkan Anda menambahkan toko eSIM perjalanan lengkap ke situs web Anda hanya dengan satu tag script. Pengunjung bisa mencari destinasi, membandingkan paket, membayar, dan menerima kode QR eSIM mereka tanpa meninggalkan halaman Anda. Kode mitra Anda sudah disertakan di dalam skrip agar pembelian yang memenuhi syarat dikaitkan dengan akun Anda.

Menyematkannya gratis dan tidak perlu proses build. Atli mengurus katalog, pembayaran, dan pengiriman eSIM. Pemasangannya hanya memerlukan satu kontainer dan satu tag script.

Halaman ini menjalankan widget sungguhan:

Memasang widget di halaman

Masuk di partners.heyatli.com lalu buka Integrasi. Kartu Widget tersemat menampilkan kode untuk situs Anda, dan kode itu sudah memuat kode mitra Anda. Sesuaikan membuka pembuat widget di partners.heyatli.com/id/dev/atli-widget. Di sana Anda bisa mengubah setiap pengaturan lalu menyalin kodenya lagi.

Kartu Widget tersemat di halaman Integrasi partners.heyatli.com, berisi kode untuk situs Anda serta tombol Pratinjau dan Sesuaikan

Jika Anda lebih suka menambahkan kodenya secara langsung, ganti YOUR_CODE dengan kode mitra Anda:

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>

Tempelkan ke HTML halaman Anda di tempat toko itu harus muncul. Widget mengambil seluruh lebar kontainernya, dan tingginya mengikuti isi yang sedang ditampilkan. Tidak ada tinggi yang perlu diatur. Jika <div> dan data-target dihilangkan, widget muncul tepat setelah tag script.

Skripnya berukuran sekitar 17 KB dan tidak memerlukan instalasi lain. Skrip ini memuat toko dalam sebuah frame dari embed.heyatli.com, dan frame itu tidak bisa membaca halaman Anda, cookie-nya, atau penyimpanannya. Detail kartu diisi di formulir pembayaran Stripe di dalam frame tersebut.

Membuka widget di satu destinasi

Untuk halaman tentang negara tertentu, Anda bisa mengatur widget agar menampilkan paket untuk destinasi itu. Contoh ini langsung membuka paket Jepang untuk panduan berbahasa Jerman dan menampilkan harga dalam euro:

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>
Widget Atli yang dibuka di Jepang dalam bahasa Jerman dengan harga dalam euro, menampilkan paket unlimited 5 sampai 30 hari, masing-masing dengan tombol eSIM kaufen

data-destination menerima kode negara dua huruf (jp), nama negara dalam bahasa apa pun yang didukung widget (Japan, 日本), kawasan (europe, south_east_asia), atau ID paket. ID paket langsung membuka checkout paket itu. Widget hanya membuka destinasi jika menemukan kecocokan yang valid. Jika tidak, widget menampilkan layar beranda bawaan. Apa pun hasilnya, pengunjung tetap bisa mencari semua destinasi.

data-favorites mengisi tab Top dengan maksimal 32 destinasi pilihan Anda dan mempertahankan urutan yang Anda tulis. Contohnya: data-favorites="jp, kr, tw, asia".

Pengaturan widget

Semua pengaturan bersifat opsional. Di tag script, setiap pengaturan berupa atribut data-. Di JavaScript, namanya sama tetapi ditulis dalam camelCase: data-lang-priority menjadi langPriority.

AtributFungsinya
data-referralKode mitra Anda. Pelanggan baru yang membeli terhubung ke Anda.
data-destinationMembuka widget di satu destinasi atau paket.
data-favoritesMaksimal 32 destinasi untuk tab Top, dipisahkan dengan koma.
data-langBahasa widget. Tanpa atribut ini, widget memakai bahasa browser pengunjung.
data-lang-prioritywidget mempertahankan bahasa pilihan Anda meskipun pengunjung memilih bahasa lain, dan menyembunyikan menu bahasa.
data-currencyMata uang untuk harga dan pembayaran. Bawaannya USD.
data-currency-prioritywidget mempertahankan mata uang pilihan Anda meskipun pengunjung memilih mata uang lain.
data-themelight atau dark. Tanpa atribut ini, widget mengikuti pengaturan perangkat pengunjung.
data-theme-prioritywidget mempertahankan tema pilihan Anda dan menyembunyikan pengaturan tema.
data-cssAlamat https:// stylesheet Anda sendiri untuk widget.
data-bootMembuka widget di salah satu layar milik pengunjung sendiri: esims, credits, vouchers, refer, settings, payment-methods, groups, atau profile. esim membuka halaman pemasangan eSIM yang dibagikan tanpa perlu akun, untuk eSIM yang kodenya Anda berikan di data-lpa.
data-anonymous-cardstrue memungkinkan pengunjung yang belum masuk menyimpan kartu di browser ini. Nonaktif secara bawaan.
data-stripe-linkfalse menghapus Stripe Link dari formulir pembayaran.
data-analyticsoff mencegah widget memuat analitiknya sendiri.
data-consentall, analytics, atau none, sesuai persetujuan yang dikumpulkan banner cookie Anda.
data-envstaging menjalankan widget di Sandbox Atli. Jangan pakai atribut ini di halaman yang sudah tayang.

Widget ini mendukung 15 bahasa: en Inggris, pt Portugis, es Spanyol, fr Prancis, it Italia, de Jerman, pl Polandia, ru Rusia, zh Mandarin, ko Korea, ja Jepang, id Indonesia, vi Vietnam, ms Melayu, dan ar Arab. Harga bisa ditampilkan dalam AUD, CAD, EUR, GBP, HKD, JPY, KRW, SGD, TWD, USD, dan VND. Nilai yang tidak didukung akan diabaikan. Misalnya, data-currency="EUROS" akan memakai USD sebagai mata uang bawaan.

Memasang widget di single-page app

Tag script menginisialisasi widget saat halaman dimuat, tetapi tidak otomatis merespons perubahan routing di aplikasi Anda. Di React, Vue, Next.js, atau aplikasi apa pun yang berpindah halaman tanpa memuat ulang, muat skripnya sekali di HTML Anda lalu pasang widget dari kode Anda:

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 menerima selektor CSS atau elemen. update() menggabungkan nilai yang Anda berikan ke pengaturan yang sedang berlaku tanpa memuat ulang frame. Di React, widget cukup ditaruh di dalam sebuah effect:

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} />;
}

Dalam mode development, Strict Mode di React menjalankan setiap effect, membersihkannya, lalu menjalankannya lagi. Sertakan destroy() di fungsi cleanup untuk mencegah instans widget ganda.

Mengubah tampilan widget dengan CSS

Isi data-css dengan alamat https:// lengkap dari stylesheet di situs Anda. Widget memuatnya di dalam frame setelah gayanya sendiri, jadi selektor biasa sudah menang tanpa !important. Jika file gagal dimuat, widget tetap memakai tampilan bawaannya.

Ada satu baris yang tidak bisa Anda ubah. Setiap layar diakhiri footer Didukung oleh Atli | Bantuan yang tidak bisa ditata ulang atau disembunyikan oleh stylesheet Anda. Stylesheet yang menyembunyikan, memudarkan, memotong, atau menutupinya akan dibuang, widget kembali ke tampilan bawaannya selama sisa kunjungan, dan konsol browser menjelaskan alasannya.

Mulailah dari variabel CSS widget. Pengunjung bisa melihat tema terang maupun tema gelap. Atur variabelnya untuk keduanya:

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 dan mono.css adalah contoh lengkap yang mencakup semua variabel umum beserta komentarnya. Kolom kartu berada di frame milik Stripe sendiri, dan stylesheet apa pun tidak bisa menjangkaunya. Sebagai gantinya, saat menyusun formulir pembayaran, widget meneruskan ke Stripe warna aksen, warna teks, warna permukaan, font, dan radius sudut Anda.

Halaman Jepang yang sama di widget Atli dalam empat tampilan: tampilan terang bawaan, tema gelap, sunset.css dengan tombol oranye dan huruf serif, serta mono.css dengan huruf monospace dan tombol abu-abu

Lewat kustomisasi CSS, Anda bisa menyesuaikan widget dengan branding situs web Anda. Untuk kendali penuh atas antarmuka, gunakan API Atli, yang memerlukan pengembangan tambahan.

Melacak pembelian dengan event widget

Widget mengirimkan event yang bisa dipakai situs web Anda untuk melacak aktivitas pengunjung dan pembelian. Untuk mengirim data pembelian ke analitik Anda, pasang widget dengan HeyAtli.init() lalu dengarkan event purchase.completed. Handler ini meneruskan setiap pembelian ke Google Tag Manager dalam format ecommerce 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 sudah tiba dalam format item GA4, jadi bisa masuk ke dataLayer tanpa diubah. value dinyatakan dalam satuan utama mata uang dan berbunyi 12.99, bukan 1299. Push pertama mengosongkan objek ecommerce sebelumnya. Google menyarankan langkah ini sebelum setiap event ecommerce.

Event lainnya antara lain checkout.opened, payment.started, dan payment.failed. Handler menerima (detail, info), dan info.action menyebut nama event-nya, jadi widget.on('*', handler) bisa meneruskan semuanya. Untuk mencatat setiap event di konsol browser, tambahkan debug: true ke init() atau data-debug="true" ke tag script.

Event hanya dikirim ke domain yang ada dalam daftar izin Atli. Domain heyatli.com dan localhost sudah ada di daftar itu, jadi Anda bisa mengembangkan integrasi di komputer sendiri. Karena itu pula, handler yang berfungsi di localhost bisa berhenti menerima event di situs yang sudah tayang. Kirim email ke [email protected] agar domain Anda ditambahkan. Widget tetap bisa memproses pembelian meskipun pelacakan event tidak tersedia.

Menguji di Sandbox

Tambahkan data-env="staging", atau env: 'staging' di HeyAtli.init(), untuk menjalankan widget di Sandbox Atli. Label Sandbox muncul di pojok, dan kode mitra Anda tampil samar di banner pengujian supaya Anda bisa memastikan halaman sudah membacanya. Bayar dengan kartu uji Stripe 4242 4242 4242 4242, tanggal kedaluwarsa kapan pun di masa depan, dan kode keamanan apa saja. Akun Sandbox terpisah dari akun sungguhan. eSIM Sandbox berasal dari operator uji, jadi tidak bisa dipasang di ponsel, dan penjualan di Sandbox tidak pernah menghasilkan komisi.

Secara bawaan, widget memakai lingkungan produksi. Hapus data-env="staging" sebelum halaman ditayangkan, karena Sandbox hanya menerima pembayaran uji.

Cara penjualan lewat widget dicatat atas nama Anda

Pengunjung yang membeli di widget terhubung ke Anda saat ia masuk atau membayar, kecuali kode mitra lain atau pembelian sebelumnya sudah lebih dulu ada. Widget mengingat kode Anda di browser pengunjung selama 72 jam, jadi orang yang kembali keesokan harinya tetap terhitung. Setelah pembelian pertama itu, hubungannya permanen, dan pembelian berikutnya di akun Atli yang sama juga dihitung untuk Anda.

Harganya sama dengan di toko Atli, dan diskon pada kode Anda tampil saat checkout. Penghasilan dan pembayarannya dibahas di panduan program afiliasi Atli.

FAQ

Apakah widget Atli berbayar?
Tidak. Widget ini gratis disematkan, dan Atli yang menerima pembayaran serta mengirimkan eSIM. Anda mendapat bagi hasil dari apa yang dibeli pengunjung Anda.
Apakah saya perlu akun Stripe sendiri?
Tidak. Widget menerima pembayaran lewat akun Stripe milik Atli di dalam frame-nya sendiri, jadi detail kartu tidak pernah sampai ke situs Anda. Nama Atli yang tertera di tagihan kartu pembeli.
Bisakah pengunjung memasang eSIM dari widget?
Bisa. Setelah pembayaran, pengunjung menerima kode QR eSIM mereka, tautan pemasangan untuk iPhone dan Android, serta detail untuk pemasangan manual. Panduan kami untuk iPhone dan Android menjelaskan langkah-langkahnya di ponsel.
Bisakah saya membatasi widget hanya untuk negara yang saya tulis?
Sebagian. data-destination membukanya di satu destinasi, dan data-favorites mengisi tab Top dengan maksimal 32 destinasi pilihan Anda. Pengunjung tetap bisa mencari di seluruh katalog.
Apakah widget akan memperlambat halaman saya?
Tidak saat halaman dimuat. Loader-nya sekitar 17 KB, dan tokonya sendiri baru dimuat ketika frame mendekati bagian halaman yang terlihat. Jika widget berada di dekat akhir artikel, isinya dimuat saat pengunjung mendekati bagian tersebut.
Bisakah saya memasang dua widget di satu halaman?
Bisa. Beri masing-masing kontainer dan tag script sendiri, atau panggil HeyAtli.init() sekali untuk setiap kontainer.