Menyiapkan postback konversi untuk tautan landing ekosistem Telegram

PERHATIAN

Petunjuk di bagian ini tidak berlaku untuk kampanye Telegram Ads. Untuk informasi lebih lanjut tentang pelacakan konversi untuk tautan di dalam Telegram pada kampanye Telegram Ads, lihat bagian ini.

Parameter:

• token — token unik yang terkait dengan akun Anda. Token tersedia di dasbor AdsGram dan dapat dibuat ulang jika diperlukan.

  Cara mendapatkan token Anda:

  1. Buka dasbor AdsGram.
  2. Klik profil Anda di pojok kanan atas.
  3. Temukan parameter token dan klik tombol salin untuk menyalinnya.

  

• tgid — ID Telegram pengguna yang mengklik tautan iklan.

• campaignid — ID kampanye iklan AdsGram tempat konversi tersebut berasal. Sesuai dengan nilai makro {campaign_id} yang diteruskan dalam tautan iklan. AdsGram menyisipkan nilai makro saat pengguna mengklik tautan.

• goaltype — parameter yang menentukan jenis konversi (tahap funnel), membantu menyegmentasi berbagai tindakan pengguna. Menerima nilai integer dari 1 hingga 3.

  Penggunaan goaltype:

  1. Tentukan tahap funnel dalam produk atau layanan Anda.
  2. Petakan tahap ke nilai goaltype:
     • 1. Pendaftaran
     • 2. Deposit/pembelian pertama
     • 3. Deposit/pembelian berulang
  3. Konfigurasikan pelacakan konversi untuk tahap yang relevan dari perjalanan pengguna.
  4. Tambahkan parameter goaltype ke permintaan API Anda saat mengirim data konversi.
  5. Gunakan parameter ini dalam analitik Anda untuk melakukan analisis performa detail berdasarkan jenis konversi.

Cara menyiapkan pelacakan konversi:

1. Pilih kampanye. Gunakan kampanye aktif yang sudah ada atau buat yang baru.
2. Konfigurasikan tautan iklan. Pastikan tautan berisi makro {campaign_id}.
3. Dapatkan token Anda. Salin token unik Anda dari dasbor AdsGram.
4. Siapkan pengiriman postback. Konfigurasikan server Anda untuk mengirim permintaan API ke AdsGram setiap kali pengguna menyelesaikan tindakan target.
5. Tentukan jenis konversi. Atur nilai goaltype yang sesuai jika Anda ingin membedakan tahap funnel.
6. Uji integrasi. Ikuti langkah-langkah di bagian Pengujian integrasi di bawah dan pastikan konversi muncul di statistik AdsGram.

Contoh permintaan API saat terjadi konversi:

GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&tgid=98110997&goaltype=2&campaignid=72156

Dalam contoh ini, goaltype=2 mewakili konversi seperti deposit atau pembelian pertama.

Ganti nilai contoh dengan data Anda yang sebenarnya:

• YOUR_UNIQUE_TOKEN — token akun AdsGram Anda;
• 98110997 — ID Telegram pengguna yang mengklik tautan iklan;
• 72156 — ID kampanye iklan Anda.

Respons yang diharapkan: 200 OK — konversi berhasil didaftarkan.

Pengujian integrasi

Untuk menguji pelacakan konversi, ikuti langkah-langkah berikut:

1. Buat atau pilih kampanye. Konfigurasikan tautan iklan sesuai dokumentasi dan pastikan tautan berisi makro {campaign_id}.
2. Tunggu klik. Tunggu hingga pengguna mengklik tautan iklan beberapa kali.
3. Dapatkan ID Telegram pengguna. Ambil tgid dari pengguna yang mengklik tautan kampanye yang dipilih.
4. Kirim postback uji secara manual. Atur goaltype=1 dan masukkan token yang valid, ID Telegram pengguna di parameter tgid, serta ID kampanye uji di parameter campaignid.
5. Periksa hasilnya. Pastikan permintaan berhasil diproses dan konversi muncul di statistik AdsGram untuk kampanye yang dipilih.

Pemecahan masalah

• Konversi muncul di statistik: integrasi telah dikonfigurasi dengan benar dan berfungsi untuk skenario yang diuji.
• Server mengembalikan error: periksa URL permintaan serta nilai parameter token, tgid, campaignid dan goaltype.
• Permintaan berhasil, tetapi konversi tidak muncul: statistik diperbarui satu kali per jam. Jika konversi masih belum muncul setelah satu jam, hubungi dukungan AdsGram atau manajer akun Anda. Pastikan untuk melampirkan log permintaan dan respons.