Adapty Attribution'da Ertelenmiş Deeplinkler

Ertelenmiş deeplink’ler, kullanıcılar reklamlarınıza tıkladıktan sonra uygulamanızı yüklediğinde özel verileri uygulamanıza aktarmanızı sağlar. Örneğin, kullanıcılar uygulamayı yükleyip ilk kez açar açmaz onları uygulamanızdaki belirli bir konuma yönlendirebilirsiniz.

İşleyiş şekli şöyledir:

Kullanıcı reklamınıza tıkladığında Adapty, tıklama verilerini kaydeder.
Adapty, yükleme olayını kaydettiğinde tıklamaya ait ertelenmiş verileri alır.
Kullanıcı uygulamanızı yükleyip ilk kez başlattığında Adapty, depolanan verileri getirir ve uygulamanız özel parametreleri alır; böylece uygulama kodunuzda farklı değerlere göre tepki verebilirsiniz. Adapty aşağıdaki ertelenmiş veri parametrelerini destekler:

ios_deferred_data
android_deferred_data
deferred_data_sub[1-10]

Ertelenmiş veri parametrelerini eklemek için bunları kampanya ayarlarınızdaki linke ekleyin:

Integrations -> Meta/TikTok Ads sayfasından kampanyanızı açın. Ya da Tracking links sayfasından takip linkinizi açın. Kampanyanızda kullanacağınız tıklama linkini kopyalayın.

Reklam platformunuzda (Meta, TikTok, Google Ads vb.) bu bağlantıyı reklam hedef URL alanına yapıştırın, ardından ertelenmiş veri parametrelerini ekstra sorgu parametreleri olarak ekleyin — her biri & önekiyle başlayacak şekilde. Örneğin, iOS kullanıcılarını yükleme sonrasında bir ‘Welcome’ ekranına göndermek için &ios_deferred_data=welcome ekleyin. Nihai hedef URL şuna benzer:

https://api-ua.adapty.io/api/v1/attribution/click?adpt_cid=__ADAPTY__ID__&ios_deferred_data=welcome&campaign_id=__CAMPAIGN_ID__&adset_id=__AID__&ad_id=__CID__&campaign_name=__CAMPAIGN_NAME__&adset_name=__AID_NAME__&ad_name=__CID_NAME__&redirect_url=__APP_LINK__

Uygulama kodunuzda parametrelere yanıt verin. Ertelenmiş veri parametrelerinin payload parametresi içinde yer aldığını ve payload parametresinin kaçışlı bir JSON olduğunu unutmayın; bu nedenle uygulama kodunuzda parse etmeniz gerekir.

Örneğin, ios_deferred_data değerinin welcome olduğu kurulumları şu şekilde ele alabilirsiniz:

Adapty.delegate = self

nonisolated func onInstallationDetailsSuccess(_ details: AdaptyInstallationDetails) {
    guard
        let payloadStr = details.payload,
        let data = payloadStr.data(using: .utf8),
        let payload = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
        let deeplink = payload["ios_deferred_data"] as? String,
        deeplink == "welcome"
    else { return }

    DispatchQueue.main.async {
        print("Navigate to welcome screen")
        // navigate to your screen here
    }
}

Adapty.setOnInstallationDetailsListener(object : OnInstallationDetailsListener {
    override fun onInstallationDetailsSuccess(details: AdaptyInstallationDetails) {
        details.payload?.let {
            runCatching {
                val json = JSONObject(it)
                if (json.optString("android_deferred_data") == "welcome") {
                    println("Navigate to welcome screen")
                    // navigate here
                }
            }.onFailure(Throwable::printStackTrace)
        }
    }
})

adapty.addEventListener('onInstallationDetailsSuccess', details => {
    // Parse the payload JSON and navigate to welcome screen if needed
    try {
        if (details.payload) {
            const payload = JSON.parse(details.payload);
            if (payload.ios_deferred_data === 'welcome') {
                // Navigate to welcome screen
                // Replace with your app's navigation logic
                // For example, using React Navigation:
                // navigation.navigate('Welcome');
                console.log('Navigate to welcome screen');
            }
        }
    } catch (error) {
        console.error('Error parsing installation details payload:', error);
    }
});

Adapty().onUpdateInstallationDetailsSuccessStream.listen((details) {
  final payloadStr = details.payload;
  if (payloadStr == null) return;

  final payload = json.decode(payloadStr) as Map<String, dynamic>;
  if (payload['ios_deferred_data'] == 'welcome') {
    print('Navigate to welcome screen');
  }
});