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.

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

1. Bir kullanıcı reklamınıza tıkladığında, Adapty tıklama verilerini kaydeder.
2. Adapty yükleme olayını kaydettiğinde, tıklamadan ertelenmiş verileri alır.
3. 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:

1. Kampanyanız Meta Ads veya TikTok üzerinde yayınlanıyorsa, izleme bağlantınızı Integrations > Meta Ads veya TikTok Ads bölümünde bulabilirsiniz. Kampanyanız farklı bir platformu hedefliyorsa Integrations > Custom kısmını açın. Ardından kullanmak istediğiniz bağlantıyı kopyalayın.

2. Reklam platformunuzda (Meta, TikTok, Google Ads, vb.), bağlantıyı reklam hedef URL alanına yapıştırın, ardından ertelenmiş veri parametrelerini ekstra sorgu parametreleri olarak ekleyin — her birinin önüne & koyun. Örneğin, iOS kullanıcılarını yüklemeden sonra bir ‘Welcome’ ekranına göndermek için &ios_deferred_data=welcome ekleyin. Son 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__

3. 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');
  }
});