Pelacakan konversi di kampanye Telegram Ads

Pelacakan konversi untuk tautan di dalam Telegram pada kampanye Telegram Ads

Di kampanye Telegram Ads, makro AdsGram tidak didukung untuk tautan yang mengarah ke tujuan di dalam Telegram dan tidak diteruskan ke tautan iklan tersebut. Karena itu, API konfirmasi konversi tidak dapat digunakan untuk melacak konversi dari tautan yang mengarah ke Telegram Mini Apps (TMA), bot, atau channel.

Untuk tautan di dalam Telegram pada kampanye Telegram Ads, peristiwa target berikut secara default otomatis dicatat sebagai Goal 1:

• TMA — peluncuran TMA;
• Bot — peluncuran bot;
• Channel — langganan channel.

Konversi dicatat secara otomatis, sehingga tidak diperlukan konfigurasi tambahan.

Menyiapkan postback konversi untuk tautan web di Telegram Ads

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.

  

• 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 Telegram Ads. Gunakan kampanye aktif yang sudah ada atau buat yang baru.
2. Konfigurasikan tautan pelacakan. 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&campaignid=72156&goaltype=2

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

Ganti YOUR_UNIQUE_TOKEN dengan token akun Anda dan 72156 dengan 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. Buat atau pilih kampanye Telegram Ads dan konfigurasikan tautan pelacakan sesuai dokumentasi. Pastikan makro {campaign_id} disertakan dalam tautan.
2. Tunggu klik. Tunggu hingga pengguna mengklik tautan pelacakan beberapa kali.
3. Kirim postback uji secara manual dengan parameter goaltype=1. Gunakan token yang valid dan ID kampanye uji di parameter campaignid.
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, 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.