Partner entegrasyonları

AdsGram, popüler atıflandırma ve izleme platformlarıyla entegrasyonu destekler. Bu platformlar, AdsGram reklamlarıyla etkileşimden sonra tıklamaları, yüklemeleri ve kullanıcı eylemlerini izlemenizi ve dönüşüm verilerini AdsGram'a geri göndermenizi sağlayarak kampanyaları dönüşüm maliyetine (tCPA) göre optimize etmenize olanak tanır.

Aşağıdaki entegrasyonlar kullanılabilir:

• AppsFlyer
• Adjust
• AppMetrica
• Kochava
• Keitaro

Diğer izleme platformlarından gelen bağlantıları da kullanabilirsiniz. Ancak bu durumda AdsGram, daha ayrıntılı analitik için gerekli tüm bilgileri tracker'a aktaramaz.

Adjust

1. Ağı Seçme

Kampanya Laboratuvarı bölümünde, Partnerlere gidin

• Yeni Partnere tıklayın.
• Arama çubuğuna AdsGram yazın ve bu ağı seçin.
• Seçtikten sonra, İleriye tıklayın.

2. Uygulamayı Seçme

Bir sonraki ekranda, bağlantıyı oluşturmak istediğiniz uygulamayı seçin. Uygulamanızı bulmak için arama çubuğunu kullanın veya bulmak için listede kaydırın. Bir seferde bir uygulama için bağlantı kurabilirsiniz.
Uygulamayı seçtikten sonra, İleriye tıklayın.

3. Veri Paylaşım Seçeneklerini Ayarlama

Bu bölümde, hangi etkinliklerin ve uygulama parametrelerinin analiz için AdsGram'a gönderileceğini seçerek AdsGram ile veri paylaşım parametrelerini ayarlayacaksınız.
Adjust dokümantasyon sayfasında ayrıntılı talimatlar mevcuttur.

4. İzleme Bağlantısını Alma

Tüm parametreleri ve eşlemeleri yapılandırdıktan sonra, AdsGram'da reklam kampanyları oluştururken kullanılması gereken benzersiz bir izleme bağlantısı alacaksınız.
Ek olarak, trafik kaynaklarının daha hassas izlenmesi için UTM etiketleri gibi ekstra parametreler ekleyebilirsiniz.

5. Dönüşüm Verisi Aktarımı

Varsayılan olarak, kullanıcı etkinlik verileri Adjust'tan AdsGram'a aktarılır ve otomatik olarak ilgili hedeflere atanır:

• Oturumlar (Sessions) - Goal 1'e
• Yüklemeler (Installs) - Goal 2'ye

ÖNEMLİ

Bir tCPA kampanyası başlatmak için, seçilen hedef için en az 10 dönüşüm almanız gerekir. Örneğin, kampanya Goal 2 ile başlatılırsa, Goal 2 için en az 10 dönüşüm almanız gerekir.

AppMetrica

Tracker oluşturma:

1. AppMetrica kişisel hesabında kayıt olduktan, SDK'yı uygulamaya entegre ettikten ve hedef eylem izlemeyi ayarladıktan sonra, tracker oluşturmaya geçebilirsiniz.
2. Tracker adını belirtin.
3. Uygulamayı ekleyin.

AppMetrica dokümantasyon sayfasında ayrıntılı talimatlar mevcuttur.

Kurulum verisi aktarımı:

4. Postback alıcısını seçin (AdsGram).
5. AdsGram'a gönderilmesi gereken etkinlik türünü belirtin.
6. Postback URL'sini alın — etkinliklerin ve kurulumların AdsGram sunucusuna gönderileceği bağlantı.
7. Postbackleri oluşturduktan sonra, bir izleme bağlantısı alacaksınız. Bu bağlantı, AdsGram'da kampanyalar oluştururken kullanılmalıdır. Ek olarak, gerekirse UTM etiketleri gibi ekstra parametreler ekleyebilirsiniz.

Keitaro

1. Keitaro'da Tracker Oluşturma

1. Keitaro paneline giriş yaptıktan sonra, Trackerlar bölümüne gidin.
2. Tracker oluştur veya Yeni tracker'a tıklayın.
3. Tracker adını girin ve trafik kaynak türü olarak AdsGram'ı seçin.
4. Tracker'ı oluşturmak için Kaydet'e tıklayın.

2. Keitaro'da Postback Yapılandırma

1. Oluşturulan tracker ayarlarında, Postback veya API Entegrasyonu bölümüne gidin.

2. Postback URL alanına AdsGram endpoint'ini girin:

   https://api.adsgram.ai/confirm_conversion?

3. Gerekli token parametresini ve record parametresini ekleyin. Parametre adı, Tracking Link'te belirtilen record parametresiyle eşleşmelidir.

   Örneğin, AdsGram makrosunu Tracking Link'te şu şekilde iletiyorsanız:

   https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&record={record_data}

   Keitaro postback'inde şunu belirtmeniz gerekir:

   https://api.adsgram.ai/confirm_conversion?token=BENZERSIZ_TOKENİNİZ&record={_record}

   Burada:

   • BENZERSIZ_TOKENİNİZ — AdsGram profilinizdeki token
   • record — Tracking Link'te ilettiğiniz parametre
   • {_record} — record parametresinin orijinal değerini postback'e ileten bir makro

   WARNING

   İzleme sisteminden ham bir değer almak için makro adından önce "_" (alt çizgi) ekleyin. Bu yalnızca Keitaro tracker'ı için geçerlidir ve XSS saldırısını önlemek için gereklidir.

3. AdsGram'da Kampanya Kurulumu

1. Keitaro tracker ayarlarınızdan Tıklama URL'sini kopyalayın (örneğin: https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}).
2. AdsGram panelinde, kampanya oluştururken bu bağlantıyı Tıklama URL'si alanına yapıştırın.
3. Bağlantıya gerekli AdsGram makrolarını ekleyin:

   https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&publisher={publisher_id}&banner={banner_id}&record={record_data}

4. {record_data} makrosunun son bağlantıda dahil edildiğinden emin olun.

4. Keitaro'da Hedefleri Kurulumu

1. Keitaro tracker ayarlarınızda, Hedefler veya Dönüşümler bölümüne gidin.
2. Yeni bir hedef oluşturun veya mevcut birini seçin.
3. Bu hedef için daha önce belirtilen URL'ye postback gönderimini etkinleştirin.
4. Tetikleyici koşulları tanımlayın (örn. dönüşüm onayı veya belirli bir durumda).

Kochava

1. Kochava'da Tracker Oluşturma

1. Kochava paneline giriş yaptıktan sonra, Uygulamalar ve Varlıklar bölümüne gidin.
2. Yeni Ekle'ye tıklayın ve yeni bir uygulama tracker'ı oluşturmak için Uygulama'yı seçin.
3. Gerekli alanları doldurun:
   • Platform: Uygulama platformunu seçin (iOS, Android, Web).
   • Uygulama Adı: Uygulamanızın adını girin.
   • Mağaza Kimliği: Uygulamanın mağaza tanımlayıcısını girin (App Store Kimliği, Paket Adı vb.).
4. Uygulamayı oluşturmak için Kaydet'e tıklayın.

2. Partner Entegrasyonunu Kurulumu

1. Oluşturulan uygulamanın sayfasında, Partner Yönetimi bölümüne gidin.
2. Partner Ekle'ye tıklayın.
3. Partnerler listesinden AdsGram'ı bulun ve seçin.
4. Yapılandırma ayarlarına geçmek için İleri'ye tıklayın.

3. Entegrasyon Parametrelerini Yapılandırma

1. Entegrasyon Ayarları bölümünde, izleme türünü seçin (Tıklama Üzerinden, Görüntüleme Üzerinden veya Hibrit).

2. Sunucudan-Sunucuya Postbackler seçeneğini etkinleştirin.

3. Postback URL alanına AdsGram endpoint'ini girin:

   https://api.adsgram.ai/confirm_conversion

4. Postback Parametrelerine aşağıdaki parametreleri ekleyin:

   • Gerekli parametre: {record_data} (Kochava tarafından otomatik olarak eklenir).
   • Parametre ekle: BENZERSIZ_TOKENİNİZ değerine sahip token (AdsGram profilinizden alınır).

5. Veri eşleme makrolarını kurun:

   • {campaign_id} → campaign_id
   • {click_id} → click_id
   • {publisher_id} → publisher_id

4. AdsGram'da Kampanya Kurulumu

1. Kochava'daki İzleme Bağlantıları bölümüne dönün ve bir izleme bağlantısı oluşturun (örneğin: https://your-app.kochava.com/install?data={encrypted_data}).
2. AdsGram panelinde, kampanya oluştururken bu bağlantıyı Tıklama URL'si alanına yapıştırın.
3. Bağlantıya zorunlu AdsGram makrolarını parametre olarak ekleyin:

   https://your-app.kochava.com/install?data={encrypted_data}&campaign_id={campaign_id}&click_id={click_id}&publisher_id={publisher_id}&record={record_data}

4. {record_data} makrosunun son URL'de dahil edildiğinden emin olun.

5. Kochava'da Etkinlikleri Yapılandırma

1. Kochava panelinde, Etkinlikler bölümüne gidin.
2. Yeni bir etkinlik oluşturun veya standart bir tane seçin (örneğin, yükleme, satın alma).
3. Seçilen etkinlik için postback'i yapılandırın:
   • Postback Gönder'i etkinleştirin.
   • Daha önce oluşturulan AdsGram entegrasyonunu seçin.
   • Filtreleri ve tetikleyici koşulları tanımlayın.
4. Etkinlik yapılandırmasını kaydedin.

6. Entegrasyonu Test Etme

1. Kurulum izlemeyi doğrulamak için Kochava'da Test Modunu kullanın.
2. Kochava ve AdsGram günlüklerinde gelen istekleri kontrol edin.
3. record_data parametresinin doğru şekilde aktarıldığından emin olun.

AppsFlyer

AdsGram'ın AppsFlyer ile entegrasyonu, uygulama yüklemeleri ve uygulama içindeki kullanıcı eylemleri hakkındaki verileri AdsGram'a göndermenizi sağlar.

Entegrasyon yapılandırıldıktan sonra AdsGram şunları alacaktır:

• Uygulama yüklemeleri (Installs) - otomatik olarak Goal 1'e atanır
• Diğer tüm In-App Events - otomatik olarak Goal 2'ye atanır

AdsGram'da ek bir yapılandırma veya etkinlik-hedef eşleştirmesi gerekmez. Örneğin, AppsFlyer'dan registration, purchase, deposit vb. etkinlikler gönderilirse, hepsi otomatik olarak Goal 2 altında sayılır.

IMPORTANT

tCPA kampanyaları yalnızca Goal 1 ile başlatılabilir. Bu, tCPA kampanyalarının yalnızca uygulama yüklemeleri için optimize edilebileceği anlamına gelir. Goal 2'ye gönderilen In-App Events, tCPA kampanyaları için hedef olarak kullanılamaz.

1. AdsGram'ı Integrated Partners Üzerinden Bağlama

AdsGram, AppsFlyer'ın entegre bir partneridir. Bağlamak için:

• AppsFlyer'da Collaboration → Partner Marketplace'e gidin
• AdsGram'ı (pazarlama adı) veya adsgram1e_int'i (teknik ad) arayın ve partneri seçin

2. Yükleme Postback'lerini Yapılandırma

Integration sekmesini açın:

• Activate Partner'ı etkinleştirin
• AAP'yi devre dışı bırakın (hem uygulama ayarlarında hem de bu sekmede devre dışı bırakılmalıdır)
• Install Postback alanında This partner only'yi seçin. Bu, AdsGram'ın AdsGram'a atfedilen yüklemeleri alacağı anlamına gelir. Bu yüklemeler AdsGram'da Goal 1 olarak sayılacaktır.

IMPORTANT

Yüklemeler için optimize edilmiş bir kampanya başlatmak istiyorsanız, yüklemelerin AdsGram'a gönderildiğinden ve Goal 1 altında görüntülendiğinden emin olun. Yüklemeler için optimize edilmiş tCPA kampanyaları yalnızca Goal 1 ile başlatılabilir.

3. Uygulama İçi Etkinlik Postback'lerini Yapılandırma

In-App Event Postbacks bölümünde In-App Events (satın almalar, kayıtlar vb.) için postback'leri yapılandırın:

• Gerekli etkinlikleri ekleyin, örneğin:
  • purchase - satın almalar
  • af_complete_registration - kayıtlar
• For users from alanında This partner only'yi seçin
• AdsGram yalnızca etkinliğin kendisini alır, parametrelerini veya gelirini almaz. Bu nedenle Including altında No values & no revenue'yu seçebilirsiniz

Önerilen:

• Entegrasyon yapılandırmasına izin verin (uygulama içi etkinlik postback'leri hariç)
• Uygulama içi etkinlik postback yapılandırmasına izin verin

Diğer izinler (elde tutma raporları, gelir vb.) isteğe bağlıdır.

Entegrasyonu yapılandırdıktan sonra Save Integration'a tıklayın.

4. Tracking Link'i Yapılandırma

Tracking Link sekmesini açın:

• AppsFlyer, AdsGram için otomatik olarak bir izleme bağlantısı oluşturacak ve gerekli partner tanımlayıcısını ekleyecektir: pid=adsgram1e_int
• 4 AdsGram makrosu otomatik olarak doldurulacaktır (af_storeid, c vb.)
• Gerekirse ek parametre olarak statik parametreler ekleyin
• Click-through attribution alanında atıflandırma penceresini seçin. Varsayılan 7 gündür, ancak gerekirse değiştirebilirsiniz

5. Permissions'ı Yapılandırma

Permissions sekmesini açın ve gerekli izinleri etkinleştirin:

• Uygulama panosuna erişim
• Toplu dönüşümler
• Etkinlikler
• Protect360

👉 Save Integration'a tıklayın

6. AdsGram'da Kampanya Kurulumu

AdsGram'da bir kampanya oluştururken:

• Link alanına Click link'i ekleyin. Sistem otomatik olarak bir AppsFlyer izleme bağlantısı oluşturacak ve gerekli makroları ekleyecektir
• AppsFlyer izleme bağlantısında package/bundle adınızı, henüz dahil edilmemişse belirtin (örneğin, id12345678 veya com.app.name)
• Görünen Link alanına, ürününüzün Google Play / App Store / RuStore'daki doğrudan bağlantısını girin

7. Notlar

• Yapılandırma, kampanya içindeki tüm bannerlar için geçerlidir
• Bağlantı parametrelerinin ve atıflandırmanın doğruluğundan reklamveren sorumludur
• Özel bir bağlantı kullanırken, Link alanında doğrudan bir ürün bağlantısı da belirtmelisiniz