--- title: "Telegram Ads izleme: makrolar ve dönüşüm postback'leri" description: "AdsGram'da Telegram Ads kampanyaları nasıl izlenir: web bağlantıları için makrolar, dönüşüm onay API'si ile dönüşüm postback'leri ve Mini App, bot ve kanallar için Goal 1'e otomatik olaylar." outline: [2,4] --- # Telegram Ads izleme Telegram Ads kampanyalarının performansını daha ayrıntılı izlemek ve hedef eylemlerin kaynaklarının doğru şekilde atanması için bir **analitik sistemi** kullanılması önerilir. ## Telegram Ads'te web bağlantıları için desteklenen makrolar Ayrıntılı izleme için makroları kullanın. AdsGram bunları izleme bağlantınızda otomatik olarak gerçek verilerle değiştirir. - `{campaign_id}` - `{banner_id}` - `{publisher_id}` - `{useragent}` - `{click_id}` - `{ip}` - `{campaign}` — kampanya adı > [!IMPORTANT] ÖNEMLİ > Bu destek yalnızca Telegram Ads'teki web bağlantıları için geçerlidir. AdsGram makroları, Telegram Ads kampanyalarında Telegram Mini Apps (TMA), botlar veya Telegram kanallarına yönlendiren bağlantılar için hâlâ desteklenmez. ::: warning UYARI Dönüşüm onay API'sinin Telegram Ads kampanyalarındaki web bağlantılarıyla doğru çalışması için kampanya URL'sinde `{campaign_id}` makrosu bulunmalıdır. Zorunlu makro eksikse dönüşüm takibi çalışmaz. Telegram Ads kampanyalarında AdsGram makroları, Telegram Mini Apps (TMA), botlar veya kanallara yönlendiren bağlantılar için desteklenmez. Bu nedenle dönüşüm onay API'si, Telegram Ads kampanyalarında bu tür bağlantılardan gelen dönüşümleri izlemek için kullanılamaz. Daha fazla bilgi için aşağıdaki [Telegram Ads kampanyalarında Telegram içi bağlantılar için dönüşüm takibi](#telegram-ads-kampanyalarında-telegram-ici-baglantılar-icin-donusum-takibi) bölümüne bakın. ::: > [!IMPORTANT] ÖNEMLİ > `{publisher_id}` makrosu yalnızca yayıncının benzersiz tanımlayıcısı olarak ortaya çıkarılır — adı veya diğer tanımlayıcı bilgiler belirtilmez. Kampanya URL'si örneği: ``` https://your-tracker.com/?campaign={campaign_id}&banner={banner_id}&pub={publisher_id}&clickid={click_id} ``` Panel, bağlantıya eklenen makroları Added macros ve eksik olanları Missed macros vurgular. ![Seçilen makrolar](../../advertiser/images/selected_macroses.webp =500x) ## Telegram Ads'te web bağlantıları için dönüşüm postback'lerinin kurulumu ### Parametreler: - `token` — hesabınızla ilişkili benzersiz bir token. AdsGram panelinde bulunur ve gerekirse yeniden oluşturulabilir. **Token'ınızı nasıl alırsınız:** 1. AdsGram panelini açın. 1. Sağ üst köşedeki profilinize tıklayın. 1. `token` parametresini bulun ve kopyalamak için kopyala düğmesine Copy tıklayın. ![Makroyu kopyala](../../advertiser/images/copy_macros.webp =200x) - `campaignid` — dönüşümün ait olduğu AdsGram reklam kampanyasının kimliği. Reklam bağlantısında iletilen `{campaign_id}` makrosunun değerine karşılık gelir. AdsGram, kullanıcı bağlantıya tıkladığında makronun değerini yerleştirir. - `goaltype` — dönüşümün türünü (huni aşaması) belirten, çeşitli kullanıcı eylemlerini segmentlere ayırmaya yardımcı olan bir parametre. 1'den 3'e kadar tamsayı değerlerini kabul eder. ##### goaltype kullanımı: 1. Ürününüz veya hizmetinizdeki huni aşamalarını tanımlayın. 1. Aşamaları goaltype değerleriyle eşleştirin: - 1. Kayıt - 2. İlk yatırım/satın alma - 3. Tekrar yatırım/satın alma 1. Kullanıcı yolculuğunun ilgili aşamaları için dönüşüm izlemeyi yapılandırın. 1. Dönüşüm verilerini gönderirken API isteğinize goaltype parametresini ekleyin. 1. Dönüşüm türüne göre ayrıntılı performans analizi yapmak için analitiklerinizde bu parametreyi kullanın. ### Dönüşüm takibi nasıl kurulur: 1. **Bir Telegram Ads kampanyası seçin.** Mevcut aktif bir kampanyayı kullanın veya yeni bir tane oluşturun. 1. **İzleme bağlantısını yapılandırın.** Bağlantının `{campaign_id}` makrosunu içerdiğinden emin olun. 1. **Token'ınızı alın.** Benzersiz token'ınızı AdsGram panelinden kopyalayın. 1. **Postback gönderimini ayarlayın.** Sunucunuzu, bir kullanıcı hedef eylemi her tamamladığında AdsGram'a API isteği gönderecek şekilde yapılandırın. 1. **Dönüşüm türünü belirtin.** Huni aşamalarını ayırt etmek istiyorsanız uygun `goaltype` değerini ayarlayın. 1. **Entegrasyonu test edin.** Aşağıdaki **Entegrasyon testi** bölümündeki adımları izleyin ve dönüşümlerin AdsGram istatistiklerinde göründüğünü doğrulayın. #### Dönüşüm anında API isteği örneği: ``` GET https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&campaignid=72156&goaltype=2 ``` Bu örnekte `goaltype=2`, ilk yatırım veya satın alma gibi bir dönüşümü ifade eder. `YOUR_UNIQUE_TOKEN` yerine hesabınızın token'ını, `72156` yerine reklam kampanyanızın kimliğini yazın. **Beklenen yanıt:** `200 OK` — dönüşüm başarıyla kaydedildi. ### Entegrasyon testi Dönüşüm takibini test etmek için şu adımları izleyin: 1. **Bir kampanya oluşturun veya seçin.** Bir Telegram Ads kampanyası oluşturun veya seçin ve izleme bağlantısını belgelere uygun şekilde yapılandırın. Bağlantıda `{campaign_id}` makrosunun bulunduğundan emin olun. 1. **Tıklamaları bekleyin.** Kullanıcılar izleme bağlantısına birkaç kez tıklayana kadar bekleyin. 1. **`goaltype=1` parametresiyle manuel olarak bir test postback'i gönderin.** Geçerli bir `token` ve `campaignid` parametresinde test kampanyasının kimliğini kullanın. 1. **Sonucu kontrol edin.** İsteğin başarıyla işlendiğini ve dönüşümün seçilen kampanyanın AdsGram istatistiklerinde göründüğünü doğrulayın. ### Sorun giderme - **Dönüşüm istatistiklerde görünüyor:** entegrasyon doğru yapılandırılmış ve test edilen senaryo için çalışıyor. - **Sunucu hata döndürüyor:** istek URL'sini ve `token`, `campaignid` ve `goaltype` parametrelerinin değerlerini kontrol edin. - **İstek başarılı, ancak dönüşüm görünmüyor:** istatistikler saatte bir güncellenir. Bir saat sonra dönüşüm hâlâ görünmüyorsa AdsGram desteğine veya hesap yöneticinize başvurun. Talebinize istek ve yanıt loglarını mutlaka ekleyin. ## Telegram Ads kampanyalarında Telegram içi bağlantılar için dönüşüm takibi Telegram Ads kampanyalarında, Telegram içindeki hedeflere yönlendiren bağlantılarda AdsGram makroları desteklenmez ve bu reklam bağlantılarına aktarılmaz. Bu nedenle dönüşüm onayı API'si, Telegram Mini Apps (TMA), botlar veya kanallara yönlendiren bağlantılardan gelen dönüşümleri izlemek için kullanılamaz. Telegram Ads kampanyalarındaki Telegram içi bağlantılar için aşağıdaki hedef olaylar varsayılan olarak otomatik şekilde **Goal 1** olarak kaydedilir: - TMA — TMA'nın başlatılması; - Botlar — botun başlatılması; - Kanallar — kanala abonelik. Dönüşümler otomatik olarak kaydedilir, bu nedenle ek yapılandırma gerekmez.