AppsFlyer

AppsFlyer, mobil attribution ve pazarlama analitiği alanında önde gelen bir platformdur. Pazarlama kampanyalarından veri toplayıp düzenleyen üçüncü taraf bir hizmettir. Bu sayede şirketler, tüm kampanyalarının performansını tek bir yerden takip edebilir. Adapty, abonelik etkinliklerini mağazalardan tek bir yerde takip etmenizi sağlayan eksiksiz bir veri seti sunar. Adapty ile abonelerinizin davranışlarını kolayca gözlemleyebilir, nelerden hoşlandıklarını öğrenebilir ve bu bilgileri onlarla hedefli ve etkili bir şekilde iletişim kurmak için kullanabilirsiniz. Bu entegrasyon sayesinde abonelik etkinliklerini AppsFlyer’da takip edebilir ve kampanyalarınızın tam olarak ne kadar gelir ürettiğini analiz edebilirsiniz.

Adapty ile AppsFlyer arasındaki entegrasyon iki temel şekilde çalışır.

1. AppsFlyer’dan attribution verisi alma AppsFlyer attribution bilgisini Adapty’ye göndermek için uygulama kodunuzda gerekli kurulumu yaptıktan sonra, Adapty AppsFlyer’dan attribution verisi almaya başlar. Bu veriye kullanıcının profil sayfasından kolayca ulaşabilirsiniz.

2. Abonelik etkinliklerini AppsFlyer’a gönderme Adapty, entegrasyonunuzda yapılandırılan tüm abonelik etkinliklerini AppsFlyer’a gönderebilir. Bu sayede söz konusu etkinlikleri AppsFlyer kontrol panelinde takip edebilirsiniz. Bu entegrasyon, reklam kampanyalarınızın etkinliğini değerlendirmek için oldukça kullanışlıdır.

Yapılandırmayı ayarlama

Adapty’yi AppsFlyer’a Bağlama

AppsFlyer ile entegrasyonu kurmak için:

1. Adapty Kontrol Paneli’nde Integrations -> AppsFlyer sayfasını açın.

2. Entegrasyonu etkinleştirmek için toggle’ı açın.

3. Bir sonraki adım, kimlik bilgilerini girmektir. iOS için App ID’yi bulmak üzere App Store Connect üzerindeki uygulama sayfanızı açın, General bölümündeki App Information sayfasına gidin ve ekranın sol alt kısmındaki Apple ID’yi kopyalayın.

3.2. Kopyalanan Apple ID’yi Adapty Kontrol Paneli’ndeki iOS App ID alanına yapıştırın.

5. Hem iOS hem de Android için AppsFlyer sitesini açın ve giriş yapın.
6. Kontrol panelinin sağ üst köşesindeki Your account name -> Security Center seçeneğine tıklayın.

7. Manage your account security penceresinde Manage your AppsFlyer API and S2S tokens butonuna tıklayın.
8. Eğer bir S2S token’ınız varsa lütfen 12. adıma geçin. Yoksa New token butonuna tıklayın.

9. New token penceresinde token adını girin. Bu ad yalnızca kendi referansınız içindir.

10. Choose type listesinden S2S seçeneğini seçin.

11. Yeni token’ı kaydetmek için Create new token düğmesine tıklayın.

12. Tokens penceresinde S2S token’ını kopyalayın.

13. Adapty Kontrol Paneli’nde, kopyaladığınız S2S anahtarını Dev key for iOS ve Dev key for Android alanlarına yapıştırın.

14. Değişiklikleri kaydetmek için Save düğmesine tıklayın.

AppsFlyer’ın sunucudan sunucuya entegrasyon için Sandbox modu bulunmamaktadır. Bu nedenle Sandbox Dev Key için AppsFlyer’da farklı bir uygulama/hesap kullanmanız gerekir. Sandbox olaylarını aynı uygulamaya göndermek istiyorsanız, production ve sandbox için aynı anahtarı kullanabilirsiniz. :::

Adapty, bazı olayları varsayılan olarak AppsFlyer standart olaylarıyla eşleştirir. Bu yapılandırmayla AppsFlyer, ek bir kurulum gerektirmeksizin olayları kullandığınız her reklam ağına iletebilir. AppsFlyer’ın 26 saatten eski olayları desteklemediğini de belirtmek gerekir. Dolayısıyla 26 saatten eski bir olayınız varsa, Adapty bunu AppsFlyer’a iletir; ancak olayın tarih ve saat bilgisi geçerli zaman damgasıyla değiştirilir.

Etkinlikleri ve etiketleri yapılandırın

Kimlik bilgilerinin altında, Adapty’den AppsFlyer’a gönderebileceğiniz üç grup etkinlik yer almaktadır. İhtiyaç duyduklarınızı açmanız yeterli. Adapty’nin sunduğu etkinliklerin tam listesine buradan ulaşabilirsiniz.

Adapty’nin sağladığı varsayılan etkinlik adlarını kullanmanızı öneririz. Ancak ihtiyaçlarınıza göre etkinlik adlarını değiştirebilirsiniz.

Adapty, sunucudan sunucuya entegrasyon aracılığıyla abonelik etkinliklerini AppsFlyer’a gönderir; bu sayede tüm abonelik etkinliklerini AppsFlyer kontrol panelinizde görüntüleyebilir ve bunları edinim kampanyalarınıza bağlayabilirsiniz.

Uygulamanızı AppsFlyer’a bağlayın

Yukarıda açıklanan adımları tamamladıktan sonra, attribution verilerini kaydetmek için updateAttribution metodunu çağırın ve integration identifier’ı ayarlamak için Adapty.setIntegrationIdentifier() kullanın.

AppsFlyer SDK’sını başlatın ve Adapty’de kullanıcıları tanımlamadan önce UID callback’ini bekleyin. Aksi takdirde appsflyer_id, aktivasyon sırasında oluşturulan kısa ömürlü anonim bir Adapty profiline atanır ve tanımlanan profile her zaman aktarılmaz. Bu durumda AppsFlyer gelir yönlendirmesi sessiz sedasız başarısız olur.

class YourAppsFlyerLibDelegateImplementation {
    // AppsFlyerLibDelegate implementasyonunuzu bulun 
    // ve onConversionDataSuccess metodunu güncelleyin:
    func onConversionDataSuccess(_ conversionInfo: [AnyHashable : Any]) {
        let uid = AppsFlyerLib.shared().getAppsFlyerUID()
        // Adapty SDK 4.x
        Adapty.setIntegrationIdentifier(.appsflyerId(uid))
        Adapty.updateAttribution(conversionInfo, source: .appsflyer)
        // Adapty SDK 3.x
        Adapty.setIntegrationIdentifier(key: "appsflyer_id", value: uid)
        Adapty.updateAttribution(conversionInfo, source: "appsflyer")
    }
}

val conversionListener: AppsFlyerConversionListener = object : AppsFlyerConversionListener {
    override fun onConversionDataSuccess(conversionData: Map<String, Any>) {
        val uid = AppsFlyerLib.getInstance().getAppsFlyerUID(context)
        Adapty.setIntegrationIdentifier("appsflyer_id", uid) { error ->
            if (error != null) {
                // handle the error
            }
        }
        Adapty.updateAttribution(conversionData, "appsflyer") { error ->
            if (error != null) {
                //handle the error
            }
        }
    }
}

appsFlyer.onInstallConversionData(installData => {
    appsFlyer.getAppsFlyerUID((error, networkUserId) => {
        if (error) {
            // handle the error
        }
        try {
            adapty.updateAttribution(installData, AttributionSource.AppsFlyer, networkUserId);
        } catch (error) {
            // handle the error
        }
    });
});

// ...
appsFlyer.initSdk(/*...*/);

AppsflyerSdk appsflyerSdk = AppsflyerSdk(<YOUR_OPTIONS>);

appsflyerSdk.onInstallConversionData((data) async {
    try {
        final appsFlyerUID = await appsFlyerSdk.getAppsFlyerUID();
        
        await Adapty().setIntegrationIdentifier(
          key: "appsflyer_id", 
          value: appsFlyerUID,
        );
        
        await Adapty().updateAttribution(data, source: "appsflyer");
    } on AdaptyError catch (adaptyError) {
        // handle the error
    } catch (e) {
        // handle the error
    }
});

appsflyerSdk.initSdk(
    registerConversionDataCallback: true,
    registerOnAppOpenAttributionCallback: true,
    registerOnDeepLinkingCallback: true,
);

using AdaptySDK;
using AppsFlyerSDK;

// SDK başlatılmadan önce
AppsFlyer.getConversionData(this.name);

// IAppsFlyerConversionData içinde
void onConversionDataSuccess(string conversionData) {
    string appsFlyerId = AppsFlyer.getAppsFlyerId();
    
    Adapty.SetIntegrationIdentifier(
      "appsflyer_id", 
      appsFlyerId, 
      (error) => {
        // hatayı işle
    });
    
    Adapty.UpdateAttribution(
      conversionData, 
      "appsflyer",
      (error) => {
        // hatayı işle
    });
}

Olay yapısı

Adapty, seçilen olayları AppsFlyer’a POST isteği olarak JSON gövdesiyle şu adreslere gönderir:

• API v2: https://api2.appsflyer.com/inappevent/{app_id}
• API v3: https://api3.appsflyer.com/inappevent/{app_id} (önerilen)

Her olay şu yapıda oluşturulur:

{
  "appsflyer_id": "1699887556000-6192770",
  "eventName": "subscription_renewed",
  "eventTime": "2024-03-01 12:00:00",
  "eventValue": "{\"af_content_id\":\"yearly.premium.6999\",\"af_order_id\":\"GPA.3383-4699-1373-07113\",\"store_country\":\"US\",\"profile_country\":\"US\",\"af_content_type\":\"in_app\",\"af_revenue\":\"9.9900\",\"af_currency\":\"USD\",\"af_quantity\":\"1\"}",
  "os": "17.0.1",
  "bundleIdentifier": "com.example.app",
  "customer_user_id": "user_12345",
  "eventCurrency": "USD",
  "ip": "192.168.100.1",
  "advertising_id": "00000000-0000-0000-0000-000000000000",
  "idfa": "00000000-0000-0000-0000-000000000000",
  "idfv": "00000000-0000-0000-0000-000000000000",
  "att": "3"
}

Burada:

Sorun giderme

Gelir tutarsızlığı

Adapty ve AppsFlyer arasında gelir tutarsızlığı varsa bunun nedeni, tüm kullanıcılarınızın Adapty SDK’sı içeren uygulama sürümünü kullanmaması olabilir. Veri tutarlılığını sağlamak için kullanıcılarınızı Adapty SDK’sı bulunan bir sürüme güncellemeye zorlayabilirsiniz.

Eksik entegrasyon verisi

Etkinlik gönderimi başarısız oluyorsa bu genellikle eksik entegrasyon verisinden kaynaklanır. Sorunu çözmek için şunları kontrol edin:

• Uygulamanızda AppsFlyer SDK’sı yüklü.
• getAppsFlyerUID metodunu çağırıyorsunuz.

Kimlik doğrulama hatası

Konsolda Failed to authenticate hatası alıyorsanız bu, AppsFlyer sürümü ile kimlik bilgisi sürümü uyumsuzluğundan kaynaklanıyor olabilir.

Geçiş kılavuzuna bakın veya kimlik bilgilerini buradan geçerli olanlarla değiştirin.