Adapty Attribution'da Ertelenmiş Deeplinkler

Ertelenmiş deeplink’ler, kullanıcılar reklamlarınıza tıkladıktan sonra uygulamanızı yüklediğinde özel veri aktarmanıza olanak tanır. Örneğin, kullanıcıları uygulamayı yükleyip başlatır başlatmaz belirli bir sayfaya yönlendirebilirsiniz.

Important

Adapty SDK 4.1 sürümünden itibaren Adapty Attribution varsayılan olarak devre dışıdır. onInstallationDetailsSuccess geri çağrısı yalnızca SDK’yı etkinleştirirken Adapty Attribution’ı etkinleştirdiğinizde tetiklenir.

Nasıl çalıştığı aşağıda açıklanmıştır:

Bir kullanıcı reklamınıza tıkladığında, Adapty tıklama verilerini kaydeder.
Adapty yükleme olayını kaydettiğinde, tıklamadan 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; bu sayede uygulama kodunda 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 parametreleri eklemek için, kampanya ayarlarınızda bunları 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 her birinin önüne & ekleyerek ek sorgu parametreleri olarak ekleyin. Örneğin, iOS kullanıcılarını kurulumun ardından bir ‘Welcome’ ekranına yönlendirmek için &ios_deferred_data=welcome parametresini ekleyin. Nihai hedef URL şu şekilde 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 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');
  }
});