Web 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'te web bağlantıları için dönüşüm postback'lerinin kurulumu hakkında 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.

  

• record — her tıklama veya gösterim için benzersiz bir değer; {record_data} makrosuna karşılık gelir. AdsGram bu değeri izleme bağlantısına otomatik olarak ekler.

• 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. İzleme bağlantısını yapılandırın. Bağlantının {record_data} 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&record=7f3a1b6c5d2e4f8a&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ı, 7f3a1b6c5d2e4f8a yerine izleme bağlantısındaki gerçek {record_data} değerini 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. İzleme bağlantısını belgelere uygun şekilde yapılandırın ve {record_data} makrosunu içerdiğinden 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. token parametresinde geçerli bir token, record parametresinde ise tıklanan izleme bağlantısındaki gerçek {record_data} değerini belirtin.
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, record 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.