Telegram ekosistemi açılış bağlantıları için dönüşüm postback'lerinin kurulumu

DİKKAT

Bu bölümdeki talimatlar Telegram Ads kampanyaları için geçerli değildir. Telegram Ads kampanyalarında Telegram içi bağlantılar için dönüşüm takibi hakkında daha fazla bilgi için bu bölüme bakın.

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.

  

• tgid — reklam bağlantısına tıklayan kullanıcının Telegram kimliği.

• 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 kampanya seçin. Mevcut aktif bir kampanyayı kullanın veya yeni bir tane oluşturun.
2. Reklam 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&tgid=98110997&goaltype=2&campaignid=72156

Bu örnekte goaltype=2, ilk yatırım veya satın alma gibi bir dönüşümü ifade eder.

Örnek değerleri gerçek verilerinizle değiştirin:

• YOUR_UNIQUE_TOKEN — AdsGram hesabınızın token'ı;
• 98110997 — reklam bağlantısına tıklayan kullanıcının Telegram kimliği;
• 72156 — reklam kampanyanızın kimliği.

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. Reklam bağlantısını belgelere uygun şekilde yapılandırın ve {campaign_id} makrosunu içerdiğinden emin olun.
2. Tıklamaları bekleyin. Kullanıcılar reklam bağlantısına birkaç kez tıklayana kadar bekleyin.
3. Kullanıcının Telegram kimliğini alın. Seçilen kampanyanın bağlantısına tıklayan bir kullanıcının tgid değerini alın.
4. Manuel olarak bir test postback'i gönderin. goaltype=1 ayarlayın ve geçerli bir token, tgid parametresinde kullanıcının Telegram kimliğini ve campaignid parametresinde test kampanyasının kimliğini belirtin.
5. 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, tgid, 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.