AppsFlyer

AppsFlyer, mobil attribution ve pazarlama analitiği alanında önde gelen bir platformdur. Pazarlama kampanyalarından veri toplayan ve düzenleyen bir üçüncü taraf hizmetidir. Şirketlerin kampanya performanslarını tek bir yerden takip etmelerine yardımcı olur. Adapty, abonelik etkinliklerini tek bir yerden takip etmenizi sağlayan eksiksiz bir veri seti sunar. Adapty sayesinde abonelerinizin nasıl davrandığını kolayca görebilir, neyi sevdiklerini öğrenebilir ve bu bilgileri hedefli ve etkili bir şekilde onlarla iletişim kurmak için kullanabilirsiniz. Bu entegrasyon, AppsFlyer’da abonelik etkinliklerini takip etmenize ve kampanyalarınızın tam olarak ne kadar gelir ürettiğini analiz etmenize olanak tanır.

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

1. AppsFlyer’dan attribution verisi alma AppsFlyer attribution verilerini uygulamanızın kodunda Adapty’ye gönderecek şekilde ayarladıktan sonra, Adapty AppsFlyer’dan attribution verisi almaya başlar. Bu verilere kullanıcı profil sayfasından kolayca erişebilir ve görüntüleyebilirsiniz.

2. AppsFlyer’a abonelik etkinlikleri gönderme Adapty, entegrasyonunuzda yapılandırılmış tüm abonelik etkinliklerini AppsFlyer’a gönderebilir. Böylece bu etkinlikleri AppsFlyer kontrol panelinden 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ğlayın

AppsFlyer entegrasyonunu kurmak için:

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

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

3. Entegrasyonun bir sonraki adımı kimlik bilgilerini ayarlamaktır. iOS için, App Store Connect’teki Apple ID’yi kopyalayarak App ID’yi bulun (bunu yapmak için App Store Connect’teki uygulama sayfanızı açın, General bölümündeki App Information sayfasına gidin ve ekranın sol alt kısmında Apple ID’yi bulun).

3.2. Kopyaladığınız 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öşesinde 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 adım 12’ye geçin. Yoksa New token butonuna tıklayın.

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

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 sunucudan sunucuya entegrasyon için Sandbox modu yoktur. 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, üretim 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, kullandığınız her reklam ağına ek kurulum gerektirmeksizin olayları iletebilir. AppsFlyer’ın 26 saatten eski etkinlikleri desteklemediğini de belirtmek gerekir. Dolayısıyla 26 saatten daha eski bir etkinliğiniz varsa, Adapty bunu AppsFlyer’a gönderir; ancak etkinlik tarih ve saati o anki 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 bulunur. İhtiyacınız olanları açmanız yeterli. Adapty’nin sunduğu etkinliklerin tam listesine buradan ulaşabilirsiniz.

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

Adapty, abonelik etkinliklerini sunucudan sunucuya entegrasyon 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ğlayın

Yukarıda açıklanan 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.

AppsFlyer SDK’sını başlatın ve Adapty’de kullanıcıları tanımlamadan önce UID geri çağrısını bekleyin. Aksi takdirde appsflyer_id, aktivasyon sırasında oluşturulan kısa ömürlü anonim bir Adapty profiline kaydedilir ve tanımlanan profile her zaman aktarılamaz. Bu durumda AppsFlyer gelir iletimi sessizce başarısız olur.

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;

// 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
    });
}

Etkinlik yapısı

Adapty, seçilen etkinlikleri AppsFlyer’a JSON gövdeli POST isteği olarak aşağıdaki adreslere gönderir:

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

Her etkinlik şu şekilde yapılandırılmıştı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"
}

The input appears to be empty or incomplete — there is no MDX content to translate. Please provide the full MDX document you’d like translated from English to Turkish (tr-TR).

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.