AppsFlyer

AppsFlyer, mobil attribution ve pazarlama analitiği alanında önde gelen bir platformdur. Pazarlama kampanyalarından gelen verileri toplayan ve düzenleyen üçüncü taraf bir hizmettir. Bu sayede şirketler, kampanyalarının ne kadar başarılı olduğunu tek bir yerden görebilir.

Adapty, mağazalardan gelen abonelik etkinliklerini tek bir yerde 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 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 ana şekilde çalışır.

1. AppsFlyer’dan attribution verisi alma
   Uygulama kodunuzda AppsFlyer attribution’ını Adapty’ye göndermeyi ayarladıktan sonra Adapty, AppsFlyer’dan attribution verisi almaya başlar. Bu verilere kullanıcının profil sayfasından kolayca ulaşabilirsiniz.

2. AppsFlyer’a abonelik etkinlikleri gönderme
   Adapty, entegrasyonunuzda yapılandırılan tüm abonelik etkinliklerini AppsFlyer’a gönderebilir. Böylece bu etkinlikleri AppsFlyer kontrol panelinde takip edebilirsiniz. Bu entegrasyon, reklam kampanyalarınızın etkinliğini değerlendirmek için oldukça faydalıdır.

Yapılandırmayı ayarlama

Adapty’yi AppsFlyer’a bağlama

AppsFlyer entegrasyonunu kurmak için:

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

2. Entegrasyonu etkinleştirmek için geçiş düğmesini açın.

3. Sonraki adımda kimlik bilgilerini girmeniz gerekiyor.
   iOS için, App Store Connect üzerinde uygulamanızın sayfasını açın, General bölümündeki App Information sayfasına gidin ve ekranın sol alt kısmında yer alan Apple ID’yi kopyalayın.

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

5. iOS ve Android için AppsFlyer sitesini açın ve oturum açı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 düğmesine tıklayın.

8. S2S token’ınız varsa 12. adıma geçin. Yoksa New token düğmesine tıklayın.

9. New token penceresinde token için bir isim girin. Bu isim yalnızca sizin referansınız için kullanılır.

10. Choose type listesinden S2S’i 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 server2server entegrasyonu için Sandbox modu yoktur. Bu nedenle Sandbox Dev Key için AppsFlyer’da ayrı bir uygulama/hesap kullanmanız gerekir. Sandbox etkinliklerini aynı uygulamaya göndermek istiyorsanız production ve sandbox için aynı anahtarı kullanabilirsiniz.

Adapty, bazı etkinlikleri varsayılan olarak AppsFlyer’ın standart etkinlikleriyle eşleştirir. Bu yapılandırma sayesinde AppsFlyer, ek bir kurulum gerektirmeden etkinlikleri kullandığınız her reklam ağına iletebilir.

Önemli bir diğer nokta da AppsFlyer’ın 26 saatten eski etkinlikleri desteklememesidir. 26 saatten eski bir etkinliğiniz varsa, Adapty onu AppsFlyer’a gönderir; ancak etkinliğin tarih ve saati mevcut zaman damgasıyla değiştirilir.

Etkinlikleri ve etiketleri yapılandırma

Kimlik bilgilerinin altında, Adapty’den AppsFlyer’a gönderebileceğiniz üç grup etkinlik bulunur. İhtiyacınız olanları 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 ihtiyacınıza göre etkinlik adlarını değiştirebilirsiniz.

Adapty, abonelik etkinliklerini server-to-server entegrasyonu aracılığıyla AppsFlyer’a gönderir. Bu sayede tüm abonelik etkinliklerini AppsFlyer kontrol panelinizde görüntüleyebilir ve bunları edinim kampanyalarınızla ilişkilendirebilirsiniz.

Uygulamanızı AppsFlyer’a bağlama

Yukarıdaki adımları tamamladıktan sonra, attribution verilerini kaydetmek için updateAttribution metodunu çağırın ve entegrasyon tanımlayıcısını ayarlamak için Adapty.setIntegrationIdentifier() kullanın.

class YourAppsFlyerLibDelegateImplementation {
    // Find your implementation of AppsFlyerLibDelegate 
    // and update onConversionDataSuccess method:
    func onConversionDataSuccess(_ conversionInfo: [AnyHashable : Any]) {
        let uid = AppsFlyerLib.shared().getAppsFlyerUID()
        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;

// before SDK initialization
AppsFlyer.getConversionData(this.name);

// in your IAppsFlyerConversionData
void onConversionDataSuccess(string conversionData) {
    string appsFlyerId = AppsFlyer.getAppsFlyerId();
    
    Adapty.SetIntegrationIdentifier(
      "appsflyer_id", 
      appsFlyerId, 
      (error) => {
        // handle the error
    });
    
    Adapty.UpdateAttribution(
      conversionData, 
      "appsflyer",
      (error) => {
        // handle the error
    });
}

Etkinlik yapısı

Adapty, seçilen etkinlikleri JSON gövdesiyle POST isteği olarak AppsFlyer’a gönderir:

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

Her etkinlik şu yapıdadır:

{
  "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"
}

Parametreler:

eventValue parametresi, aşağıdaki alanları içeren JSON kodlu bir dizedir:

Sorun giderme

Gelir tutarsızlığı

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

Eksik entegrasyon verisi

Etkinlik gönderimi başarısız oluyorsa, bunun nedeni genellikle eksik entegrasyon verisidir. Sorunu çözmek için aşağıdakileri kontrol edin:

• Uygulamanızda AppsFlyer SDK’sı yüklü olmalıdır.
• getAppsFlyerUID metodunu çağırıyor olmalısınız.

Kimlik doğrulama hatası

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

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