Menyiapkan postback konversi untuk tautan landing web

PERHATIAN

Petunjuk di bagian ini tidak berlaku untuk kampanye Telegram Ads. Untuk petunjuk menyiapkan postback konversi untuk tautan web di 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.

  

• record — nilai unik untuk setiap klik atau tayangan, sesuai dengan makro {record_data}. AdsGram secara otomatis menyisipkan nilai ini ke dalam tautan pelacakan.

• 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 pelacakan. Pastikan tautan berisi makro {record_data}.
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&record=7f3a1b6c5d2e4f8a&goaltype=2

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

Ganti YOUR_UNIQUE_TOKEN dengan token akun Anda dan 7f3a1b6c5d2e4f8a dengan nilai {record_data} yang sebenarnya dari tautan pelacakan.

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 pelacakan sesuai dokumentasi dan pastikan tautan berisi makro {record_data}.
2. Tunggu klik. Tunggu hingga pengguna mengklik tautan pelacakan beberapa kali.
3. Kirim postback uji secara manual dengan parameter goaltype=1. Masukkan token yang valid di parameter token dan nilai {record_data} yang sebenarnya dari tautan pelacakan yang diklik di parameter record.
4. 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, record 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.