AppsFlyer

Adapty, AppsFlyer ile çift yönlü veri alışverişi yapar. AppsFlyer, Adapty’ye her kullanıcıyı hangi kampanyanın getirdiğini bildirir. Adapty ise AppsFlyer’a o kullanıcının ne ödediğini aktarır — satın almalar, yenilemeler, denemeler ve iadeler; gelir ve ürün ayrıntılarıyla birlikte.

• Yalnızca ilk satın almayı değil, aboneliğin tüm yaşam döngüsünü görüntüleyin. Yenilemeler ve deneme dönemi dönüşümleri, AppsFlyer’ın istemci tarafı SDK’sının raporlayabileceği bir uygulama oturumuna sahip olmayan mağaza olaylarıdır. Adapty, abonelik olaylarını sunucu tarafında alır ve bunları AppsFlyer’a iletir; böylece kampanya rakamları ilk kurulumdan çok sonra da güncellemeye devam eder. Geri ödemeler de aynı şekilde iletilir ve AppsFlyer bunları kampanya gelirinden düşer.
• Abonelik etkinliği verileriyle reklam kampanyalarınızı optimize edin. AppsFlyer, Adapty’den gelen uygulama içi etkinlikleri postback olarak reklam ağlarınıza iletir. Reklam bütçenizi yöneten hizmetler, kullanıcıların gerçekte ödediği değer üzerinden optimizasyon yapabilir.
• Adapty analizlerini kampanyaya göre filtreleyin. Adapty, her profilde AppsFlyer’ın attribution bilgisini reklam seti ve kreatife kadar kaydeder; abonelik grafikleri bu bilgilere göre filtrelenebilir.
• Kampanyaya göre farklı bir paywall gösterin. Adapty segmentleri aynı attribution alanlarını — kampanya, reklam seti ve kreatif — filtreler. Bir segmenti kitle olarak kullanarak paywall’u kullanıcıyı getiren reklamla eşleştirin.

Entegrasyon nasıl çalışır

Adapty, AppsFlyer’dan attribution verisi alır ve abonelik olaylarını geri AppsFlyer’a gönderir. Her ikisi de tek bir değere bağlıdır: AppsFlyer ID — uygulamanız ilk başlatıldığında AppsFlyer’ın oluşturduğu bir dize.

1. Kullanıcı uygulamanızı yüklediğinde, AppsFlyer SDK’sı ona benzersiz bir ID atar.
2. Uygulamanız bu ID’yi Adapty’ye iletir; Adapty de bunu kullanıcının profilinde appsflyer_id olarak saklar.
3. Uygulamanız aynı zamanda AppsFlyer’ın attribution verisini de Adapty’ye iletir ve Adapty bunu aynı profilde kaydeder.
4. Daha sonra kullanıcı bir abonelik olayı tetiklediğinde — örneğin deneme sürümü başlattığında veya bir ürün satın aldığında — Adapty’nin sunucuları bu olayı aynı appsflyer_id ile AppsFlyer’ın S2S API’sine gönderir.
5. AppsFlyer, ID’yi daha önce attribution yaptığı yüklemeyle eşleştirir; böylece satın alma işlemi o yüklemenin kampanya ve medya kaynağı bilgilerini devralır.

Kurulum talimatları

Başlamadan önce:

• AppsFlyer planınızın S2S in-app event’lerini kabul ettiğini doğrulayın. AppsFlyer’ın giriş seviyesi Zero paketi bunu desteklemiyor: API’si, Adapty’nin gönderdiği her event’i 403 Forbidden ile reddeder.
• AppsFlyer SDK’sını uygulamanıza ekleyin. Entegrasyonun dayandığı AppsFlyer ID’si, yalnızca o SDK başlatıldıktan sonra oluşur. Yalnızca sunucu tarafı entegrasyonu bu ID’yi üretmez.
• Diğer tüm attribution entegrasyonlarını kapatın. Adapty, profil başına tek bir attribution kaynağı kabul eder ve mevcut bir değerin üzerine yazamaz. iOS’ta, organik olmayan Apple Ads attribution her zaman önceliklidir — bkz. Tek bir attribution kaynağı seçin.

AppsFlyer’da S2S token oluşturma

Adapty, AppsFlyer’ın S2S API’sine sizin oluşturduğunuz bir token ile kimlik doğrulaması yapar. Tokens sayfasını yalnızca AppsFlyer yöneticileri açabilir; bu nedenle hesabınız yönetici değilse token oluşturması için bir yöneticiden yardım isteyin. Zaten bir token’ınız varsa Adapty’yi yapılandırma adımına geçin.

1. AppsFlyer’a giriş yapın.

2. Sağ üst köşedeki hesap adınıza tıklayın ve Security center sayfasını açın.

   

3. Hesap güvenliğinizi yönetin sayfasında AppsFlyer API and S2S tokens kartını bulun ve Manage your AppsFlyer tokens seçeneğine tıklayın. Tokens sayfası açılır.

4. New token seçeneğine tıklayın.

   

5. Token için bir Name girin. Bu isim yalnızca sizin referansınız içindir ve daha sonra değiştirebilirsiniz.

6. S2S token türünü seçin. Başka bir tür seçmek entegrasyonu bozar.

7. Create new token seçeneğine tıklayın.

8. Yeni token’ınızı listede bulun. AppsFlyer değeri maskelediğinden, token’ı almak için Token sütunundaki kopyalama simgesine tıklayın.

   

Adapty’yi Yapılandırın

1. Adapty Kontrol Paneli’nde Integrations > AppsFlyer bölümünü açın.
2. AppsFlyer geçiş düğmesini etkinleştirin.
3. Uygulamanızı App Store’a zaten bağladıysanız, iOS App ID alanı uygulamanızın sayısal Apple ID’siyle otomatik olarak doldurulur. Alan boşsa, önce App Store hesabınızı bağlayın. Android için eşdeğer bir alan gerekmez.
4. S2S token’ını S2S key for iOS, S2S key for Android veya her ikisinin Production alanına yapıştırın.
5. Test satın almalarının production verilerinize karışmaması için Sandbox alanlarını doldurun — bkz. Sandbox verilerini production’dan ayrı tutma.

6. How the revenue data should be send bölümünde, Adapty’nin af_revenue olarak hangi gelir rakamını göndereceğini seçin. Üç seçenek, Adapty Analytics gelir görünümleriyle örtüşür; bu nedenle seçiminiz, AppsFlyer rakamlarınızın hangi görünümle eşleşmesi gerektiğini de belirler.

7. Kalan seçenekleri ayarlayın:

8. Events names bölümündeki tek tek etkinlikleri yeniden adlandırın veya devre dışı bırakın — bkz. Etkinlik adları.

   

9. Save düğmesine tıklayın.

Sandbox verilerini prodüksiyondan uzak tutun

Test satın almalarını gerçek verilerinize karıştırmamak için bunları ayrı bir AppsFlyer uygulamasına gönderin. Geliştirme build’leriniz için ikinci bir uygulama kaydedin, ardından token’ını her platform bölümünün Sandbox alanına yapıştırın.

Adapty her işlemi ortamına göre yönlendirir — gerçek satın almalar token’ı Production alanında olan uygulamaya, test satın almaları ise Sandbox alanındaki uygulamaya gider. Her şeyi tek bir uygulamada raporlamak isterseniz aynı token’ı her iki alana da yapıştırmanız yeterlidir.

App Store inceleme ve TestFlight satın alımları, üretim derlemesi üzerinde çalışsalar bile sandbox işlemleridir. Adapty bu satın alımları Sandbox anahtarıyla gönderir.

Uygulama kodunuzu yapılandırın

1. AppsFlyer SDK ile bir dönüşüm callback’i kaydedin. iOS’ta AppsFlyerLibDelegate protokolünü; Android’de AppsFlyerConversionListener arayüzünü; Unity’de IAppsFlyerConversionData arayüzünü uygulayın. React Native ve Flutter’da ise onInstallConversionData metoduna bir handler geçirin.
2. AppsFlyer’ın bu callback’i çağırmasını bekleyin. AppsFlyer her kurulumu kendi sunucularında ilişkilendirir; dolayısıyla sonuç uygulamanıza başlatma anında değil, asenkron olarak ulaşır. SDK, sonraki her oturumda callback’i yeniden çağırır.
3. Callback içinde kullanıcının AppsFlyer ID’sini getAppsFlyerUID ile okuyun ve setIntegrationIdentifier() aracılığıyla Adapty’e iletin. Adapty’nin etkinlikleri doğru AppsFlyer kullanıcısına ulaşması için bu değer zorunludur.
4. Aynı callback içinde, AppsFlyer’ın attribution verisini updateAttribution() ile Adapty’e aktarın. Bu, Adapty’e kurulumu hangi kampanyanın sağladığını bildirir. iOS ve Android SDK 4.1 ve sonrasında metodun adı updateExternalAttribution() olarak değişmiştir.
5. Adapty.identify() metodunu 3. ve 4. adımlarla eş zamanlı çalıştırmak yerine await ile bekleyin. Adapty, etkinleştirme sırasında anonim bir profil oluşturur; identify() tamamlandığında tanımlı profile geçer. Bu geçiş sırasında ayarlanan appsflyer_id her zaman korunmayabilir.

Tam sıralama için iOS, Android, React Native, Flutter, Unity, Capacitor ve Kotlin Multiplatform SDK’larındaki çağrı sırasına bakın.

class YourAppsFlyerLibDelegateImplementation {
    // Find your implementation of AppsFlyerLibDelegate
    // and update onConversionDataSuccess method:
    func onConversionDataSuccess(_ conversionInfo: [AnyHashable : Any]) {
        let uid = AppsFlyerLib.shared().getAppsFlyerUID()
        Adapty.setIntegrationIdentifier(.appsflyerId(uid))
        Adapty.updateExternalAttribution(conversionInfo, provider: .appsflyer)
    }
}

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

appsFlyer.onInstallConversionData(installData => {
    appsFlyer.getAppsFlyerUID(async (error, appsFlyerUID) => {
        if (error) {
            // handle the error
            return;
        }
        try {
            await adapty.setIntegrationIdentifier('appsflyer_id', appsFlyerUID);
            await adapty.updateAttribution(installData, 'appsflyer');
        } catch (error) {
            // handle `AdaptyError`
        }
    });
});

// ...
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.UpdateExternalAttribution(
      conversionData,
      "appsflyer",
      (error) => {
        // handle the error
    });
}

Entegrasyonu doğrulayın

1. Bir sandbox satın alma işlemi başlatın ve uygulamanızın Event Feed sayfasını açın. Her gönderim denemesi burada görünür. Başarısız bir denemenin AppsFlyer yanıtını okumak için ilgili satırın üzerine gelin.
2. AppsFlyer’da Settings > SDK Integration Tests > Live Events bölümünü açın ve test cihazınızı seçin. Live Events, S2S olaylarını AppFlyer’ın Activity kontrol paneline ulaşmadan çok önce listeler.
3. Uygulamanızın Activity kontrol panelini açın ve olayı, gelirini ve medya kaynağını doğrulayın. Yaklaşık bir saat bekleyin; S2S olayları bu kontrol paneline hemen ulaşmaz.

AppsFlyer olay yapısı

Adapty, her olay için https://api3.appsflyer.com/inappevent/{app_id} adresine bir POST isteği gönderir ve S2S token’ı authentication başlığında iletir. API 2, https://api2.appsflyer.com/inappevent/{app_id} adresini kullanır.

{
  "appsflyer_id": "1699887556000-6192770",
  "eventName": "af_subscribe",
  "eventTime": "2026-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"
}

eventValue satın alma işlemini taşır. Son dört parametre yalnızca gelir içeren olaylarda görünür:

Etkinlik adları

Adapty, gelir içeren etkinliklerini kendi adlarını özel etkinlik olarak göndermek yerine varsayılan olarak AppsFlyer’ın standart etkinlik adlarıyla eşleştirir. Bu, etkinlikleri reklam ağlarına iletiyorsanız önemlidir: bir ağ, zaten tanıdığı standart adlara göre işlem yapar; dolayısıyla her biri için ayrı bir eşleme oluşturmanıza gerek kalmaz.

Diğer tüm Adapty olayları kendi adlarını korur; örneğin subscription_refunded. AppsFlyer entegrasyon sayfasının Events names bölümünden herhangi bir olayı yeniden adlandırabilir ya da ihtiyaç duymadıklarınızı kapatabilirsiniz. Adapty’nin gönderebileceği olayların tam listesi için Olaylar sayfasına bakın.

Sınırlamalar

• appsflyer_id olmayan bir profil hiçbir event üretmez. AppsFlyer, bir event’i ID’yi oluşturan kurulumla eşleştirir ve kampanyayı o kurulumdan okur. Adapty, bu olmadan hiçbir şey göndermez; Event Feed ise bu profilleri işaretler — bkz. Event’ler AppsFlyer’a ulaşmıyor.
• Geçmişe dönük veri aktarımı yoktur. Adapty, entegrasyonu etkinleştirdiğiniz andan itibaren event’leri iletir. Geçmişteki satın almalar hiçbir zaman AppsFlyer’a ulaşmaz.
• AppsFlyer ham verilerinde cihaz bilgileri boş kalır. Bir S2S event’i yalnızca isteğin içerdiği bilgileri taşır. Cihaz Modeli, Cihaz Kategorisi, Dil, Operatör, WIFI, Uygulama Sürümü ve Uygulama Adı için S2S parametresi bulunmadığından, bu yolla gönderilen hiçbir şey bu alanları dolduramaz.

Sorun Giderme

• Olaylar AppsFlyer’a ulaşmıyor
• Satın almalar organik olarak görünüyor
• Eski olaylar bugünün tarihiyle geliyor
• Yenilemeler yanlış güne düşüyor
• AppsFlyer’daki gelir Adapty Analytics ile eşleşmiyor
• Event Feed’de Failed to authenticate
• Event Feed’de access_level_updated başarısız olarak görünüyor

Olaylar AppsFlyer’a Ulaşmıyor

Önce Event Feed sayfasını açın. Başarısız bir teslimat, AppsFlyer’ın döndürdüğü hatayı gösterir. Bunların büyük çoğunluğu şu nedenlerden kaynaklanır:

• Profilin appsflyer_id’si yok. Uygulamanızın getAppsFlyerUID’yi çağırdığını ve sonucu gönderdiğiniz her platformda setIntegrationIdentifier’a ilettiğini doğrulayın — bkz. Uygulama kodunuzu yapılandırın.
• O platforma ait uygulama kimliği eksik. AppsFlyer her uygulamayı kimliğiyle tanımlar, bu yüzden kimlik olmadan Adapty hiçbir şey göndermez. iOS etkinlikleri için entegrasyon sayfasındaki iOS App ID gereklidir; Android etkinlikleri için App settings > Android SDK bölümündeki paket adı gereklidir — bkz. Adapty’yi yapılandırın.
• Satın alma bir sandbox işlemidir ve Sandbox anahtarı boş. Bkz. Sandbox verilerini üretim ortamından uzak tutun.
• Etkinlik, Events names bölümünde kapalı.

Başarılı bir teslimat, AppsFlyer’ın etkinliği sakladığını garantilemez. AppsFlyer, düzgün biçimlendirilmiş her istek için 200 OK döner; ardından appsflyer_id’si gerçek bir kurulumla eşleşmeyen etkinlikleri atar.

Satın almalar organik olarak görünüyor

Her appsflyer_id bir kurulumu tanımlar ve o ID’yi taşıyan her etkinlik, kurulumun attribution’ını devralır — onu üreten kampanyayı ya da kurulum organikse hiçbirini. AppsFlyer, yeni bir kurulumu ilişkilendirmek için 20-30 saniye veya daha fazlasına ihtiyaç duyar. Bu süreden önce gelen bir etkinlik, devralacak attribution bulamaz; bu nedenle AppsFlyer onu atıfsız organik olarak işaretler.

İlk açılışta gerçekleşen satın almaların organik olarak raporlanmasını bekleyin — uygulama açılışından saniyeler içinde başlayan denemeler böyle görünür. Bunu önlemek için, AppsFlyer kurulum işlemini tamamlamaya yetecek kadar paywallı geciktirin.

Her event organik görünüyorsa, yalnızca ara sıra gerçekleşen ilk açılış satın almaları değil, sorun zamanlama değil attribution kaynaklıdır: başka bir kaynak profili daha önce talep etmiştir. Bkz. Tek bir attribution kaynağı seçin.

Eski eventler bugünün tarihiyle geliyor

Olaylar iki nedenden dolayı Adapty’ye geç ulaşabilir:

• App Store Connect’te App Store Server Notifications Delayed (Gecikmiş) olarak göründüğünde, Apple bildirimlerini kuyruğa alır. Bir yenileme, gerçekleşmesinden çok sonra Adapty’ye ulaşır — bkz. App Store Server Notifications “Delayed” gösteriyor.
• Exclude historical events kapalıyken geçmişe dönük olaylar her zaman iletilir.

AppsFlyer bu kadar eski zaman damgalarını kabul etmez. Tutarlı event işleme sağlamak için Adapty, 26 saatten eski herhangi bir event için eventTime değerini geçerli zamanla değiştirir. Bu yeniden yazmayı devre dışı bırakamazsınız.

Yenilemeler yanlış güne düşüyor

Apple, yenilemeleri ve deneme sürümü dönüşümlerini gerçekleşmeden önce Adapty’ye bildirir ve Adapty bunları geleceğe ait eventTime değiştirilmeden hemen iletir. AppsFlyer bir gelecek zaman damgasını yalnızca varış günüyle örtüşüyorsa saklar — yarın tarihli bir yenileme, bugünkü varış zamanıyla damgalanır.

integration settings bölümünden Delay events with a future datetime seçeneğini etkinleştirin. Adapty her etkinliği zamanı gelene kadar bekletir, böylece AppsFlyer Apple’ın açıkladığı tarihi kaydeder. Bkz. Gelecek tarihli etkinlik zaman damgaları.

AppsFlyer’daki gelir Adapty Analytics ile eşleşmiyor

Adapty ve AppsFlyer aynı satın almaları farklı şekillerde sayar. Bu farklılıklar neredeyse her uyumsuzluğu açıklar.

• AppsFlyer’ın Genel Bakış panosu geliri kurulum tarihine göre gruplar; Adapty grafikleri ise etkinlik tarihine göre gruplar. AppsFlyer’da, Ocak tarihli bir kurulumdan gelen Temmuz yenilemesi Ocak ayına sayılır. Bu panoyu, geliri kurulum ayına göre gruplandıran Adapty kohort analiziyle karşılaştırın. AppsFlyer’ın ham veri raporları etkinlik tarihine göre gruplandığından, bunları Adapty grafikleriyle karşılaştırabilirsiniz.
• appsflyer_id olmayan profillerden yapılan satın almalar hiçbir zaman AppsFlyer’a ulaşmaz. Bunlar Adapty Analytics’te kalır. Bkz. Etkinlikler AppsFlyer’a ulaşmıyor.
• AppsFlyer yalnızca Adapty’de seçtiğiniz gelir rakamını gösterir. How the revenue data should be send ayarı, Adapty’nin brüt gelir, gelir payı veya net gelir gönderip göndermediğini belirler. Bunu başka bir Adapty Analytics görünümüyle karşılaştırdığınızda komisyon, vergi veya her ikisine eşit bir fark oluşur.
• Adapty uygulamanızın raporlama saat dilimini kullanır; AppsFlyer ise UTC alır. Entegrasyonlar, App Settings bölümünde ne ayarlamış olursanız olun her zaman UTC zaman damgaları alır. Raporlama saat diliminiz +02:00 ise 1 Temmuz 23:30 UTC’deki bir satın alma, Adapty’de 2 Temmuz olarak görünür.
• AppsFlyer’da geçmiş etkinlikler eksik. Bunun iki olası nedeni vardır. Exclude historical events açıkken bir kullanıcının AppsFlyer geçmişi, Adapty build’ini ilk başlattıklarında başlar. Adapty ayrıca entegrasyonu etkinleştirmeden önce işlediği etkinlikleri hiçbir zaman geriye dönük olarak doldurmaz.
• Sandbox satın almaları, Sandbox anahtarıyla belirlenen AppsFlyer uygulamasına ulaşır. Bu üretim uygulamasıysa test satın almaları onun gelirini şişirir. Bkz. Sandbox verilerini üretim ortamından uzak tutma.
• Entegrasyonda kapalı olan etkinlikler hiçbir zaman AppsFlyer’a ulaşmaz. Adapty Analytics bunları yine de sayar. Events names bölümünü inceleyin; subscription_renewed kapatmak, yerleşik bir uygulama için gelirin büyük bölümünü kaldırır.

Event Feed’de Failed to authenticate

AppsFlyer, kimlik bilgileri API sürümüyle eşleşmediğinde isteği reddeder. API 2 bir Dev key beklerken, API 3 bir S2S token bekler. Sürümü değiştirip anahtarı güncellemezseniz her event’te bu hata oluşur.

AppsFlyer Security Center üzerinden yeni bir token oluşturun ve S2S key alanlarına yapıştırın ya da AppsFlyer S2S API 2’den 3’e geçiş yönergelerini izleyin.

Event Feed’de access_level_updated başarısız olarak görünüyor

access_level_updated yalnızca webhook’a özgü bir event’tir. Adapty bu event’i bu entegrasyona hiçbir zaman göndermez. Ancak Adapty, etkinleştirilmiş her entegrasyon için bir sonuç kaydeder ve desteklenmeyen bir event başarısızlık olarak görüntülenir.