Adapty User Acquisition'da Ertelenmiş Deeplinkler

Ertelenmiş deep link’ler, kullanıcılar reklamlarınıza tıkladıktan sonra uygulamanızı kurduklarında özel verileri uygulamanıza aktarmanızı sağlar. Örneğin, kurulum ve ilk açılışın hemen ardından kullanıcıları uygulamanızın belirli bir bölümüne yönlendirebilirsiniz.

İşleyiş şekli şöyle:

Kullanıcı reklamınıza tıkladığında Adapty, tıklama verilerini kaydeder.
Adapty kurulum olayını kaydettiğinde, tıklamadan gelen ertelenmiş verileri alır.
Kullanıcı uygulamanızı kurduktan sonra ilk kez açtığında Adapty, depolanan verileri getirir ve uygulamanız özel parametreleri alarak uygulama kodunda farklı değerlere tepki verebilir. Adapty aşağıdaki ertelenmiş veri parametrelerini destekler:

ios_deferred_data
android_deferred_data
deferred_data_sub[1-10]

Ertelenmiş veri parametreleri eklemek için bunları kampanya ayarlarınızdaki bağlantınıza ekleyin:

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

Reklam platformunuzda (Meta, TikTok, Google Ads vb.) bağlantıyı reklam hedef URL alanına yapıştırın, ardından ertelenmiş veri parametrelerini fazladan sorgu parametreleri olarak ekleyin; her birinin önüne & koyun. Örneğin, iOS kullanıcılarını yüklemeden sonra ‘Welcome’ ekranına yönlendirmek için &ios_deferred_data=welcome ekleyin. Son hedef URL şöyle görünecektir:

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 parametresinde olduğunu ve payload parametresinin escaped bir JSON olduğunu unutmayın; bu nedenle uygulama kodunuzda bunu parse etmeniz gerekir.

Örneğin, ios_deferred_data değerinin welcome olduğu yüklemeleri şu şekilde işleyebilirsiniz:

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 => {
    // Payload JSON'ını ayrıştır ve gerekirse karşılama ekranına git
    try {
        if (details.payload) {
            const payload = JSON.parse(details.payload);
            if (payload.ios_deferred_data === 'welcome') {
                // Karşılama ekranına git
                // Uygulamanızın navigasyon mantığıyla değiştirin
                // Örneğin, React Navigation kullanarak:
                // 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');
  }
});