Deeplinks diferidos en Adapty Attribution

Los deeplinks diferidos te permiten pasar datos personalizados a tu app cuando los usuarios la instalan después de hacer clic en tus anuncios. Por ejemplo, puedes llevarlos a una sección específica de tu app justo después de que la instalen y la abran.

Así es como funciona:

1. Cuando un usuario hace clic en tu anuncio, Adapty guarda los datos del clic.
2. Cuando Adapty registra el evento de instalación, obtiene los datos diferidos del clic.
3. Después de que el usuario instala tu app y la abre por primera vez, Adapty recupera los datos almacenados y tu app recibe los parámetros personalizados, lo que te permite reaccionar a distintos valores en el código de la app.

Adapty admite los siguientes parámetros de datos diferidos:

• ios_deferred_data
• android_deferred_data
• deferred_data_sub[1-10]

Para añadir parámetros de datos diferidos, agrégalos a tu enlace en la configuración de tu campaña:

1. Si tu campaña se ejecuta en Meta Ads o TikTok, busca tu enlace de seguimiento en Integrations > Meta Ads o TikTok Ads. Si tu campaña apunta a una plataforma diferente, abre Integrations > Custom. Luego copia el enlace que quieras usar.

2. En tu plataforma publicitaria (Meta, TikTok, Google Ads, etc.), pega el enlace en el campo de URL de destino del anuncio y añade los parámetros de datos diferidos como parámetros de consulta adicionales, cada uno precedido por &. Por ejemplo, para enviar a los usuarios de iOS a una pantalla de ‘Welcome’ tras la instalación, añade &ios_deferred_data=welcome. La URL de destino final tendrá este aspecto:

https://api-ua.adapty.io/api/v1/attribution/c/YOUR_CODE?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__&ios_deferred_data=welcome

3. Responde a los parámetros en el código de tu app. Ten en cuenta que los parámetros de datos diferidos están en el parámetro payload, y que payload es un JSON escapado, por lo que necesitas parsearlo en el código de tu app.

Por ejemplo, así puedes gestionar las instalaciones donde ios_deferred_data es 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');
  }
});