- 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.- En OneSignal, navegue a Data > Integrations > Catalog y seleccione Amplitude.
- Haga clic en Settings, luego abra la pestaña Outbound.
- Ingrese su token de API de Amplitude, seleccione los eventos de mensaje que desea enviar y haga clic en Save.
En Amplitude
- Encuentre su clave API del proyecto y cópiela y péguela en OneSignal.
- 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.
- Cohortes: Sincronizar cohortes de Amplitude a OneSignal.
- Propiedades de Usuario de Eventos: Enviar eventos personalizados de Amplitude a OneSignal.
Si planea usar tanto la sincronización de cohortes como eventos personalizados, agregue ambos destinos de OneSignal. Cada destino se configura por separado en Amplitude, por lo que ingresará sus credenciales de OneSignal para cada uno.
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.Haga clic en Save cuando termine. Ahora debería poder exportar cohortes y eventos personalizados de Amplitude a OneSignal y recopilar eventos de mensajes de OneSignal a Amplitude.
Probar eventos personalizados
- En el destino de eventos de Amplitude > OneSignal, haga clic en el botón Test Connection.
- 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. - Haga clic en el botón Send Test Event.
- El cuadro Response debe permanecer vacío y debería ver
"OneSignal has successfully received test event."
- 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.- En Amplitude, cree una cohorte. Consulte la documentación de Amplitude sobre cohortes.
- Haga clic en Sync y elija OneSignal como destino.
- 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.| Message Event Kind (OneSignal) | Message Event Name (Amplitude) | Event Description |
|---|---|---|
| Push Sent | [OneSignal] Push Sent | Notificación push enviada exitosamente. |
| Push Received | [OneSignal] Push Confirmed delivery | Notificación push recibida exitosamente |
| Push Clicked | [OneSignal] Push Clicked | Notificación push tocada en el dispositivo |
| Push Failed | [OneSignal] Push Failed | Push falló al enviarse. Verifique el informe de mensajes fallidos en OneSignal. |
| Push Unsubscribed | [OneSignal] Push Unsubscribed | La Subscription se desinscribió del push. |
| In-App Impression | [OneSignal] IAM Displayed | Mensaje en la aplicación mostrado exitosamente en el dispositivo |
| In-App Clicked | [OneSignal] IAM Clicked | Mensaje en la aplicación clicado en el dispositivo |
| In-App Page Displayed | [OneSignal] IAM Page Displayed | Página de mensaje en la aplicación mostrada |
| Email Sent | [Onesignal] Email Delivered | Correo electrónico enviado exitosamente |
| Email Received | [OneSignal] Email Confirmed delivery | Correo electrónico recibido por el destinatario |
| Email Opened | [OneSignal] Email Opened | Correo electrónico abierto por el destinatario |
| Email Link Clicked | [OneSignal] Email Clicked | Enlace de correo electrónico clicado |
| Email Unsubscribed | [OneSignal] Email Unsubscribed | Destinatario desinscrito del correo electrónico |
| Email Reported As Spam | [OneSignal] Email Reported As SPAM | Correo electrónico reportado como spam por el destinatario |
| Email Bounced | [OneSignal] Email Hard Bounced | Correo electrónico devuelto al remitente debido a error permanente |
| Email Failed | [OneSignal] Email Failed delivery | No se pudo entregar el correo electrónico a la bandeja de entrada del destinatario |
| Email Suppressed | [OneSignal] Email Not delivering to suppressed email address | Correo electrónico no entregado ya que el destinatario había suprimido la dirección de correo electrónico desde la cual se envió |
| SMS Sent | [OneSignal] SMS Sent | SMS enviado al destinatario |
| SMS Failed | [OneSignal] SMS Failed delivery | SMS falló al enviarse |
| SMS Delivered | [OneSignal] SMS Confirmed deliveery | SMS entregado exitosamente |
| SMS Undelivered | [OneSignal] SMS Undelivered | El SMS no pudo ser enviado. |
Propiedades de eventos
Cada evento enviado desde OneSignal a Amplitude incluye estas propiedades:| PROPERTY NAME | DESCRIPTION |
|---|---|
| Distinct ID | El external_id asociado con el mensaje |
| Message ID | El identificador del mensaje discreto |
| Message Name | El nombre del mensaje |
| Message Title | El título del mensaje |
| Message Contents | El contenido del mensaje |
| message_type | El tipo de mensaje enviado, push, en la aplicación, correo electrónico, SMS |
| template_id | La plantilla de mensaje utilizada (mensajes de API y Journey) |
| subscription_id | El identificador de dispositivo/correo electrónico/SMS establecido por OneSignal |
| device_type | El tipo de dispositivo que recibió el mensaje |
| language | El código de idioma de dos caracteres del dispositivo |
| source | onesignal (se indica como la fuente para todos los eventos) |
FAQ
¿Por qué no coinciden los recuentos de mi cohorte y segmento?
- 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.
- 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.
- No existir en OneSignal o tener un External ID incorrecto.
- Tener suscripciones desinscritas.
¿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
subscription_id en las propiedades del evento para rastrear la fuente exacta.
Para solucionar problemas de eventos faltantes:
- Asegúrese de que
OneSignal.loginse llame cada vez que se identifique a un usuario para establecer el External ID. - Verifique que
OneSignal.logoutno 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 undevice_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
Resumen de análisis
Resumen de análisis de OneSignal, métricas de entrega y seguimiento de eventos.
Eventos personalizados
Rastrea las acciones del usuario para activar Journeys o potenciar el análisis.
Need help?Chat with our Support team or email
support@onesignal.comPlease include:- Details of the issue you’re experiencing and steps to reproduce if available
- Your OneSignal App ID
- The External ID or Subscription ID if applicable
- The URL to the message you tested in the OneSignal Dashboard if applicable
- Any relevant logs or error messages