--- title: "Pelacakan Telegram Ads: makro dan postback konversi" description: "Cara melacak kampanye Telegram Ads di AdsGram: makro untuk tautan web, postback konversi melalui API konfirmasi konversi, dan event otomatis ke Goal 1 untuk Mini App, bot, dan channel." outline: [2,4] --- # Pelacakan Telegram Ads Untuk pelacakan performa kampanye Telegram Ads yang lebih detail dan atribusi yang benar dari sumber tindakan target, disarankan untuk menggunakan **sistem analitik**. ## Makro yang didukung untuk tautan web di Telegram Ads Untuk pelacakan yang detail, gunakan makro. AdsGram akan otomatis menggantinya dengan data nyata di tautan pelacakan Anda. - `{campaign_id}` - `{banner_id}` - `{publisher_id}` - `{useragent}` - `{click_id}` - `{ip}` - `{campaign}` — nama kampanye > [!IMPORTANT] PENTING > Dukungan ini hanya berlaku untuk tautan web di Telegram Ads. Makro AdsGram tetap tidak didukung untuk tautan yang mengarah ke Telegram Mini Apps (TMA), bot, atau channel Telegram dalam kampanye Telegram Ads. ::: warning PERINGATAN Agar API konfirmasi konversi berfungsi dengan benar untuk tautan web dalam kampanye Telegram Ads, URL kampanye harus menyertakan makro `{campaign_id}`. Jika makro wajib tidak ada, pelacakan konversi tidak akan berfungsi. Dalam kampanye Telegram Ads, makro AdsGram tidak didukung untuk tautan yang mengarah ke Telegram Mini Apps (TMA), bot, atau channel. Oleh karena itu, API konfirmasi konversi tidak dapat digunakan untuk melacak konversi dari tautan tersebut dalam kampanye Telegram Ads. Untuk informasi lebih lanjut, lihat [Pelacakan konversi untuk tautan di dalam Telegram pada kampanye Telegram Ads](#pelacakan-konversi-untuk-tautan-di-dalam-telegram-pada-kampanye-telegram-ads) di bawah. ::: > [!IMPORTANT] PENTING > Makro `{publisher_id}` hanya diungkapkan sebagai pengenal unik publisher — tanpa menyebutkan nama atau informasi pengenal lainnya. Contoh URL kampanye: ``` https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id} ``` Dasbor menyoroti makro yang ditambahkan ke tautan Added macros dan yang hilang Missed macros. ![Makro yang dipilih](../../advertiser/images/selected_macroses.webp =500x) ## 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. 1. Klik profil Anda di pojok kanan atas. 1. Temukan parameter `token` dan klik tombol salin Copy untuk menyalinnya. ![Salin makro](../../advertiser/images/copy_macros.webp =200x) - `campaignid` — ID kampanye iklan AdsGram tempat konversi tersebut berasal. Sesuai dengan nilai makro `{campaign_id}` yang diteruskan dalam tautan iklan. AdsGram mengganti 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. 1. Petakan tahap ke nilai goaltype: - 1. Pendaftaran - 2. Deposit/pembelian pertama - 3. Deposit/pembelian berulang 1. Konfigurasikan pelacakan konversi untuk tahap yang relevan dari perjalanan pengguna. 1. Tambahkan parameter goaltype ke permintaan API Anda saat mengirim data konversi. 1. 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. 1. **Konfigurasikan tautan pelacakan.** Pastikan tautan berisi makro `{campaign_id}`. 1. **Dapatkan token Anda.** Salin token unik Anda dari dasbor AdsGram. 1. **Siapkan pengiriman postback.** Konfigurasikan server Anda untuk mengirim permintaan API ke AdsGram setiap kali pengguna menyelesaikan tindakan target. 1. **Tentukan jenis konversi.** Atur nilai `goaltype` yang sesuai jika Anda ingin membedakan tahap funnel. 1. **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. 1. **Tunggu klik.** Tunggu hingga pengguna mengklik tautan pelacakan beberapa kali. 1. **Kirim postback uji secara manual** dengan parameter `goaltype=1`. Gunakan `token` yang valid dan ID kampanye uji di parameter `campaignid`. 1. **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. ## 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.