Branch
Branch, müşterilerin farklı cihaz, kanal ve platformlarda kullanıcılara ulaşmasını, onlarla etkileşim kurmasını ve sonuçları değerlendirmesini sağlar. Tüm cihaz, kanal ve platformlarda sorunsuz çalışan özel bağlantılar aracılığıyla mobil geliri artırmak için tasarlanmış, kullanımı kolay bir platformdur.
Adapty, mağazalardan gelen abonelik etkinliklerini tek bir yerden takip etmenizi sağlayan eksiksiz bir veri seti sunar. Adapty ile abonelerinizin davranışlarını kolayca izleyebilir, tercihlerini öğrenebilir ve bu bilgileri hedefli ve etkili iletişim için kullanabilirsiniz.
Adapty ile Branch arasındaki entegrasyon iki temel şekilde çalışır.
-
Branch’ten attribution verisi alma Branch entegrasyonunu kurduktan sonra Adapty, Branch’ten attribution verisi almaya başlar. Bu verilere kullanıcının profil sayfasından kolayca erişebilir ve görüntüleyebilirsiniz.
-
Branch’e abonelik etkinlikleri gönderme Adapty, entegrasyonunuzda yapılandırılan tüm abonelik etkinliklerini Branch’e gönderebilir. Bu sayede söz konusu etkinlikleri Branch kontrol panelinden takip edebilirsiniz.
Entegrasyonu kurma
Adapty’yi Branch’e bağlama
Branch entegrasyonu için Adapty Kontrol Paneli’nde Integrations > Branch bölümüne gidin, geçiş düğmesini açık konuma getirin ve gerekli alanları doldurun.
Branch Key değerini almak için Branch Hesap Ayarları sayfasını açın ve Branch Key alanını bulun. Bu değeri Adapty Kontrol Paneli’ndeki Key test (Sandbox için) veya Key live (Prodüksiyon için) alanına girin. Branch’te uygun anahtarı kullanmak için Live ve Test ortamları arasında geçiş yapın.
Etkinlikleri ve etiketleri yapılandırma
Kimlik bilgilerinin altında, Adapty’den Branch’e gönderebileceğiniz üç grup etkinlik yer alır. İhtiyaç duyduklarınızı açmanız yeterli. Adapty’nin sunduğu etkinliklerin tam listesine buradan ulaşabilirsiniz.
Etkinlikleri Gelir (Apple/Google payı düşüldükten sonra) veya yalnızca ciro olarak gönderebilirsiniz. Ayrıca raporlamayı kullanıcının para biriminden yapılacak şekilde ayarlayabilirsiniz.
Adapty’nin sunduğu varsayılan etkinlik adlarını kullanmanızı öneririz. Ancak ihtiyacınıza göre etkinlik adlarını değiştirebilirsiniz.
Adapty, abonelik etkinliklerini sunucudan sunucuya entegrasyon aracılığıyla Branch’e gönderir. Bu sayede tüm abonelik etkinliklerini Branch kontrol panelinizde görüntüleyebilir ve edinim kampanyalarınızla ilişkilendirebilirsiniz.
Uygulamanızı Branch’e bağlama
- Bağlantıyı başlatmak için
.setIntegrationIdentifier()SDK metodunu çağırın. Branch Identity ID’nizicustomerUserIdparametresine geçirebilirsiniz.
Üçüncü taraf bir kullanıcı kimliğini Customer User ID olarak kullanıyorsanız, bunu activate() sırasında geçirmeyin — üçüncü taraf SDK henüz bu kimliği oluşturmamış olabilir. Bunun yerine önce CUID olmadan activate() çağrısı yapın, ardından setIntegrationIdentifier() ve son olarak CUID ile identify() çağrısını gerçekleştirin.
- Attribution verisini kaydetmek için
.updateAttribution()metodunu kullanın. Branch kullanıcı ID’sini bir önceki adımda belirtmediyseniz, buradanetworkUserIdparametresine geçirin.
Etkinlik yapısı
Adapty, seçilen etkinlikleri Branch Entegrasyon sayfasındaki Events names bölümünde yapılandırıldığı şekilde Branch’e gönderir. Her etkinlik şu yapıya sahiptir:
{
"branch_key": "key_live_kaFuWw8WvY7n1ss7...",
"name": "PURCHASE",
"user_data": {
"os": "iOS",
"developer_identity": "user_12345",
"country": "US",
"ip": "192.168.100.1",
"idfa": "00000000-0000-0000-0000-000000000000",
"idfv": "00000000-0000-0000-0000-000000000000",
"aaid": "00000000-0000-0000-0000-000000000000"
},
"event_data": {
"transaction_id": "GPA.3383-4699-1373-07113",
"revenue": 9.99,
"currency": "USD"
},
"custom_data": {
"vendor_product_id": "yearly.premium.6999",
"original_transaction_id": "GPA.3383-4699-1373-07113",
"store": "play_store",
"environment": "production"
}
}
Parametreler:
| Parametre | Tür | Açıklama |
|---|---|---|
branch_key | String | Branch Key’iniz. |
name | String | Branch etkinlik adı (Adapty etkinliğinden eşlenen, örn. “PURCHASE”). |
user_data | Object | Kullanıcı bilgileri. |
user_data.os | String | ”Android” veya “iOS”. |
user_data.developer_identity | String | Kullanıcının Customer User ID’si. |
user_data.country | String | Kullanıcının IP adresine göre belirlenen ülke kodu. |
user_data.ip | String | Kullanıcının IP adresi. |
user_data.idfa | String | Yalnızca iOS. Reklamverenler için ID (ID for Advertisers). |
user_data.idfv | String | Yalnızca iOS. Satıcılar için ID (ID for Vendors). |
user_data.aaid | String | Yalnızca Android. Google Reklam ID’si. |
event_data | Object | Standart etkinlik metrikleri (yalnızca PURCHASE ve benzeri etkinliklerde bulunur). |
event_data.transaction_id | String | Mağaza İşlem ID’si. |
event_data.revenue | Float | Gelir tutarı. |
event_data.currency | String | Para birimi kodu (örn. “USD”). |
custom_data | Object | Ayrıntılı etkinlik nitelikleri (mevcut tüm etkinlik alanlarını içerir). |