Amplitude

Integre OneSignal con Amplitude para habilitar la segmentación en tiempo real basada en el comportamiento a través de push, en la aplicación, correo electrónico y SMS. Esta integración a nivel de aplicación admite tres flujos de datos:

• Eventos de mensajes → Amplitude: Rastree entregas, clics, fallos y más para todos los canales.
• Eventos personalizados → OneSignal: Envíe eventos de Amplitude a OneSignal para activar Journeys o Segmentos.
• Cohortes → OneSignal: Sincronice cohortes de Amplitude basadas en el comportamiento como filtros de segmentación en OneSignal.

---

​

Requisitos

• Cuenta de Amplitude
• Plan de pago de OneSignal
• Aplicación de OneSignal con usuarios y External ID configurado.

---

​

Configuración

​

Agregar Amplitude a OneSignal (Salida)

Envía eventos de mensajes de OneSignal a su proyecto de Amplitude.

1. En OneSignal, navegue a Data > Integrations > Catalog y seleccione Amplitude.
2. Haga clic en Settings, luego abra la pestaña Outbound.
3. Ingrese su token de API de Amplitude, seleccione los eventos de mensaje que desea enviar y haga clic en Save.

​

En Amplitude

1. Encuentre su clave API del proyecto y cópiela y péguela en OneSignal.
2. Si usa los servidores de la UE de Amplitude, marque Enviar eventos exclusivamente al Endpoint de Residencia EU de Amplitude. Puede verificar esto mediante su URL de Amplitude. Si ve eu.amplitude.com, entonces está usando los servidores de la UE de Amplitude.

​

Agregar OneSignal a Amplitude (Entrada)

En sus Destinos de Amplitude, busque OneSignal. Amplitude proporciona dos tipos de destino OneSignal en el catálogo:

• Cohortes: Sincronizar cohortes de Amplitude a OneSignal.
• Propiedades de Usuario de Eventos: Enviar eventos personalizados de Amplitude a OneSignal.

​

Mapeo de User ID

El External ID en OneSignal debe coincidir con la propiedad de usuario de Amplitude que seleccione (por ejemplo, user_id). Verifique que esta propiedad esté completada en ambos sistemas — la sincronización de cohortes y el seguimiento de eventos dependen de una coincidencia exacta.

​

Propiedades adicionales

Puede incluir propiedades adicionales que se adjuntarán a los eventos personalizados en OneSignal. Esto es útil para el procesamiento condicional de eventos.

---

​

Probar eventos personalizados

1. En el destino de eventos de Amplitude > OneSignal, haga clic en el botón Test Connection.

2. Asegúrese de que el "user_id" en la carga útil esté establecido en el External ID de un usuario existente en su aplicación de OneSignal.
3. Haga clic en el botón Send Test Event.
4. El cuadro Response debe permanecer vacío y debería ver "OneSignal has successfully received test event."

5. En OneSignal, navegue a Data > Custom Events y verifique que el evento de prueba aparezca en la lista.

​

Exportar cohortes de Amplitude a OneSignal

Sincronice las cohortes de Amplitude con OneSignal usando el External ID coincidente configurado anteriormente. Exportar no crea usuarios — cada usuario ya debe existir en OneSignal.

1. En Amplitude, cree una cohorte. Consulte la documentación de Amplitude sobre cohortes.
2. Haga clic en Sync y elija OneSignal como destino.
3. Elija la frecuencia de sincronización.

​

Creación de segmento de OneSignal

La cohorte sincronizada aparece en OneSignal como un filtro de segmento de Amplitude. OneSignal crea automáticamente un segmento para la cohorte si:

• Los usuarios en la cohorte de Amplitude también existen en OneSignal con un External ID coincidente.
• No ha excedido su límite de segmentos en OneSignal.

---

​

Rastrear eventos de mensajes en Amplitude

OneSignal envía los siguientes eventos de mensajes a Amplitude en tiempo real. Seleccione qué eventos enviar en Data > Integrations > Amplitude > Outbound.

​

Propiedades de eventos

Cada evento enviado desde OneSignal a Amplitude incluye estas propiedades:

---

​

FAQ

​

¿Por qué no coinciden los recuentos de mi cohorte y segmento?

1. External IDs faltantes o no coincidentes Solo se incluyen usuarios con un External ID de OneSignal y un User ID de Amplitude coincidentes. Esta integración no crea usuarios ni suscripciones.
2. Usuarios desincritos Los segmentos de OneSignal solo muestran el recuento de Subscriptions suscritas. Las Subscriptions desinscritas están disponibles para Journeys o mensajes en la aplicación.

Por ejemplo, si una cohorte de Amplitude tiene 10 usuarios pero el segmento de OneSignal muestra 8 Subscriptions, los 2 usuarios faltantes pueden:

• No existir en OneSignal o tener un External ID incorrecto.
• Tener suscripciones desinscritas.

Para verificar, revise la pestaña Audience > Users en OneSignal para ver si los usuarios existen y tienen suscripciones activas.

​

¿Se sincronizan los usuarios desincritos desde Amplitude?

Sí, pero están excluidos de los recuentos de segmentos de OneSignal en este momento. Aún puede enviarles mensajes a través de Journeys o mensajes en la aplicación si tienen otras Subscriptions o su tipo de Subscription lo admite.

​

¿Por qué no coinciden los datos de entrega?

Un solo usuario puede tener múltiples Subscriptions (dispositivos push, direcciones de correo electrónico, números de teléfono). Cada Subscription genera su propio evento de entrega. Por ejemplo:

• 1 usuario = 2 Android + 1 iOS + 2 Web = 5 Subscriptions push
• 1 mensaje push = hasta 5 eventos enviados/recibidos/clicados

Use el subscription_id en las propiedades del evento para rastrear la fuente exacta. Para solucionar problemas de eventos faltantes:

• Asegúrese de que OneSignal.login se llame cada vez que se identifique a un usuario para establecer el External ID.
• Verifique que OneSignal.logout no esté eliminando el External ID.
• Revise las solicitudes de API o cargas de CSV que puedan alterar el External ID.

​

¿Cómo podemos enviar eventos de usuario/suscripción?

Los eventos a nivel de usuario y suscripción (por ejemplo, permiso otorgado, inicio/cierre de sesión de usuario) no se envían automáticamente. El SDK de OneSignal tiene detectores de eventos que se pueden usar para rastrear estos eventos para que los envíe a Amplitude:

• User State Observer: Mobile SDK, Web SDK
• Permission Observer: Mobile SDK, Web SDK

​

¿Por qué se agrega el Subscription ID de OneSignal a Amplitude como device_id?

Amplitude espera un device_id para la deduplicación. OneSignal usa subscription_id para esto, que se mapea automáticamente en device_id. Consulte la documentación de Amplitude para obtener más información.

---

​

Páginas relacionadas

---