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.

Important

A partir de la versión 4.1 del SDK de Adapty, Adapty Attribution está desactivado por defecto. El callback onInstallationDetailsSuccess solo se ejecuta después de que habilites Adapty Attribution al activar el SDK.

Así es como funciona:

Cuando un usuario hace clic en tu anuncio, Adapty guarda los datos del clic.
Cuando Adapty registra el evento de instalación, obtiene los datos diferidos del clic.
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:

Abre tu campaña desde la página Integrations -> Meta/TikTok Ads. O bien, abre tu enlace de seguimiento desde la página Tracking links. Copia el enlace de clic que usarás en tu campaña.

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 de &. Por ejemplo, para enviar a los usuarios de iOS a una pantalla de “Bienvenida” 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/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__

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