Saltar al contenido principal
Adjust es un socio de medición móvil (MMP) que atribuye instalaciones, sesiones y eventos in-app a través de tus canales de marketing. Esta integración envía el External ID de OneSignal a Adjust como el partner parameter onesignal_customer_id, para que Adjust pueda correlacionar los eventos que reenvía a OneSignal con el usuario correcto.

​
Requisitos

  • SDK móvil de OneSignal versión 5.5.0 o superior.
  • Un External ID establecido en el usuario de OneSignal. Las sincronizaciones de datos entre Adjust y OneSignal se basan en este ID, por lo que la integración no puede correlacionar eventos para usuarios anónimos.

​
Configuración

Dos cosas deben estar en su sitio para que los callbacks de Adjust lleguen al usuario correcto de OneSignal: Adjust debe estar configurado para reenviar eventos a OneSignal y tu aplicación debe adjuntar el External ID como partner parameter en cada sesión.

​
1. Habilita el intercambio de datos en el panel de Adjust

En tu panel de Adjust, habilita la integración con OneSignal y elige qué eventos reenviar. Adjust envía actividad de install y session por defecto; adicionalmente puedes mapear eventos personalizados e ingresos in-app. Sigue la guía Set up OneSignal de Adjust para conocer los pasos exactos.
Sin este paso en el panel, Adjust nunca envía callbacks a OneSignal, así que el código del SDK del siguiente paso no tiene nada a lo que adjuntar el parámetro onesignal_customer_id.

​
2. Envía el External ID como partner parameter

Cuando un usuario inicia sesión en tu aplicación, llama al método login de OneSignal para establecer el External ID y, a continuación, llama al método addGlobalPartnerParameter de Adjust con la clave onesignal_customer_id y el mismo External ID como valor. Adjust reenvía ese par clave–valor en cada callback posterior, y OneSignal usa onesignal_customer_id para asociar el callback con el usuario correcto.
Todos los SDK de Adjust que no son de iOS usan el orden de argumentos (key, value). Swift y Objective-C de iOS usan (value, forKey: key). Pasar el External ID como clave por error rompe la integración de forma silenciosa: Adjust reenviará un parámetro con el nombre de tu cadena de ID de usuario y OneSignal nunca verá onesignal_customer_id.
val externalId = "your_user_id"
OneSignal.login(externalId)
Adjust.addGlobalPartnerParameter("onesignal_customer_id", externalId)
Para la referencia del SDK de Adjust subyacente, consulta la documentación de Global Partner Parameters de Adjust para Android e iOS.

​
Deep linking

Adjust usa iOS Universal Links y Android App Links para dirigir los toques de push a pantallas específicas de tu aplicación. Al enviar notificaciones de OneSignal que deban abrir un deep link de Adjust, establece la Launch URL de la notificación al deep link de Adjust, como se describe en la guía Push Notifications de Adjust. Consulta la guía de Deep linking de OneSignal para saber cómo se gestionan las Launch URL en cada plataforma.

​
FAQ

​
¿Qué es el partner parameter onesignal_customer_id?

onesignal_customer_id es la clave exacta que OneSignal lee en los callbacks de Adjust para correlacionar un evento de Adjust con un usuario de OneSignal. Establece su valor con el mismo External ID que pasas a OneSignal.login. Cualquier otro nombre de clave no será reconocido.

​
¿Cuándo debo llamar a Adjust.addGlobalPartnerParameter?

Llámalo cada vez que llames a OneSignal.login: al arrancar la aplicación una vez que se conozca el ID del usuario y, de nuevo, cuando el usuario cambie de cuenta. Esto refleja la guía sobre login de OneSignal y mantiene el partner parameter de Adjust sincronizado con el usuario actual de OneSignal.

​
¿Qué ocurre cuando un usuario cierra sesión o cambia de cuenta?

Adjust conserva los global partner parameters en memoria hasta que los cambies o los elimines. Al cerrar sesión, llama a Adjust.removeGlobalPartnerParameter("onesignal_customer_id") (o sobrescribe el valor en el siguiente inicio de sesión). De lo contrario, Adjust seguirá atribuyendo los eventos posteriores al External ID del usuario anterior.

​
¿Qué datos envía Adjust a OneSignal?

Por defecto, Adjust reenvía la actividad de install y session, además de los eventos que mapees en el panel de Adjust. La lista completa de campos reenviados se documenta en el artículo de integración con OneSignal de Adjust.

​
Páginas relacionadas

External ID

Establece un identificador estable en tu usuario de OneSignal para que las integraciones con partners puedan correlacionar datos.

Mobile SDK: login

Referencia de OneSignal.login, incluyendo cuándo llamarlo y su comportamiento de reintento.

Deep linking

Configura Universal Links, App Links y esquemas URI para push, in-app, email y SMS.

Keys & IDs

Encuentra tu App ID y REST API Key de OneSignal para la configuración del panel de Adjust.