Telegram Ads kampanyalarında dönüşüm takibi

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.

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.
  2. Sağ üst köşedeki profilinize tıklayın.
  3. token parametresini bulun ve kopyalamak için kopyala düğmesine tıklayın.

  

• 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. Kullanıcı bağlantıya tıkladığında AdsGram 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.
  2. 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
  3. Kullanıcı yolculuğunun ilgili aşamaları için dönüşüm izlemeyi yapılandırın.
  4. Dönüşüm verilerini gönderirken API isteğinize goaltype parametresini ekleyin.
  5. 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.
2. İzleme bağlantısını yapılandırın. Bağlantının {campaign_id} makrosunu içerdiğinden emin olun.
3. Token'ınızı alın. Benzersiz token'ınızı AdsGram panelinden kopyalayın.
4. 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.
5. Dönüşüm türünü belirtin. Huni aşamalarını ayırt etmek istiyorsanız uygun goaltype değerini ayarlayın.
6. 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.
2. Tıklamaları bekleyin. Kullanıcılar izleme bağlantısına birkaç kez tıklayana kadar bekleyin.
3. 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.
4. 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.