Отложенные диплинки в Adapty Attribution

Отложенные диплинки позволяют передавать пользовательские данные в приложение, когда пользователи устанавливают его после перехода по вашей рекламе. Например, можно сразу после установки и запуска направить их в нужный раздел приложения.

Important

Начиная с версии Adapty SDK 4.1, Adapty Attribution отключена по умолчанию. Коллбэк onInstallationDetailsSuccess срабатывает только после того, как вы включите Adapty Attribution при активации SDK.

Вот как это работает:

Когда пользователь нажимает на ваше объявление, Adapty сохраняет данные о клике.
Когда Adapty регистрирует событие установки, он получает отложенные данные из клика.
После того как пользователь установит приложение и запустит его впервые, Adapty извлекает сохранённые данные, и ваше приложение получает пользовательские параметры — это позволяет по-разному реагировать на различные значения в коде приложения.

Adapty поддерживает следующие параметры отложенных данных:

ios_deferred_data
android_deferred_data
deferred_data_sub[1-10]

Чтобы добавить параметры отложенных данных, добавьте их к вашей ссылке в настройках кампании:

Откройте свою кампанию на странице Integrations -> Meta/TikTok Ads или перейдите на страницу Tracking links и откройте нужную трекинговую ссылку. Скопируйте ссылку для клика, которую вы будете использовать в кампании.

В рекламной платформе (Meta, TikTok, Google Ads и т. д.) вставьте ссылку в поле URL назначения объявления, затем добавьте параметры отложенных данных в виде дополнительных query-параметров — каждый с префиксом &. Например, чтобы после установки направить пользователей iOS на экран «Welcome», добавьте &ios_deferred_data=welcome. Итоговый URL назначения будет выглядеть так:

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__

Обрабатывайте параметры в коде приложения. Обратите внимание, что параметры отложенных данных передаются в параметре payload, который является экранированным JSON — его нужно разобрать в коде приложения.

Например, вот как можно обработать установки, где ios_deferred_data равен welcome:

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