> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Amplitude

> Integre OneSignal con Amplitude para sincronizar cohortes de comportamiento, rastrear eventos de mensajes y dirigirse a los usuarios a través de canales push, correo electrónico, SMS y en la aplicación.

Integre OneSignal con [Amplitude](https://amplitude.com) 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](https://amplitude.com/pricing)
* [Plan de pago de OneSignal](https://onesignal.com/pricing)
* Aplicación de OneSignal con [usuarios](./users) y External ID configurado.

<Warning>
  Esta integración no crea usuarios. Mapea los usuarios en Amplitude con los usuarios existentes en OneSignal mediante la coincidencia de identificadores.
</Warning>

***

## 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**.

<Frame caption="Agregar destino de OneSignal en Amplitude">
  <img src="https://mintcdn.com/onesignal/TbJ7SH8gAntayRJq/images/integrations/amplitude-destination.png?fit=max&auto=format&n=TbJ7SH8gAntayRJq&q=85&s=fe7b7967e5e219556a6356915b0238fa" alt="Catálogo de destinos de Amplitude con OneSignal seleccionado" width="2288" height="1168" data-path="images/integrations/amplitude-destination.png" />
</Frame>

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.

<Note>
  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.
</Note>

### Mapeo de User ID

El **[External ID](./users)** 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](./custom-events) en OneSignal. Esto es útil para el procesamiento condicional de eventos.

<Check>
  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.
</Check>

***

## Probar eventos personalizados

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

<Frame caption="Amplitude > Destino de eventos OneSignal">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/integrations/amplitude-test-connection.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=8202b1ee8513456d78777425db4a7753" alt="Página de destino de eventos de Amplitude con el botón Test Connection resaltado" width="1970" height="1160" data-path="images/integrations/amplitude-test-connection.png" />
</Frame>

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."`

<Frame caption="Ejemplo de respuesta">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/integrations/amplitude-test-connection-response.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=14b5824d639a748252a36315bc491383" alt="Respuesta de evento de prueba exitosa que muestra el mensaje de confirmación" width="2438" height="1500" data-path="images/integrations/amplitude-test-connection-response.png" />
</Frame>

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

<Frame caption="Evento personalizado en OneSignal">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/integrations/onesignal-custom-event.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=18c287884737e192fde2da0e28d65676" alt="Lista de eventos personalizados de OneSignal que muestra el evento de prueba de Amplitude" width="2736" height="1032" data-path="images/integrations/onesignal-custom-event.png" />
</Frame>

<Warning>
  Si la prueba falla o el evento no aparece en OneSignal, verifique que su ID de aplicación de OneSignal y la clave API REST estén ingresados correctamente en Amplitude, que su aplicación esté configurada para [eventos personalizados](./custom-events) y que el `"user_id"` coincida con el External ID de un usuario existente en su aplicación de OneSignal.
</Warning>

## 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](https://amplitude.com/docs/analytics/behavioral-cohorts).
2. Haga clic en **Sync** y elija **OneSignal** como destino.
3. Elija la frecuencia de sincronización.

<Frame caption="Establecer una cadencia de sincronización para las cohortes de Amplitude con OneSignal">
  <img src="https://mintcdn.com/onesignal/yt4lRKoquAlWvRvF/images/integrations/amplitude-sync-cadence.png?fit=max&auto=format&n=yt4lRKoquAlWvRvF&q=85&s=9ba4b69273f73ccdd1f095c2a3ede63c" alt="Configuración de sincronización de cohortes de Amplitude que muestra las opciones de frecuencia para el destino OneSignal" width="602" height="499" data-path="images/integrations/amplitude-sync-cadence.png" />
</Frame>

### 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.

<Frame caption="Cómo crear un segmento desde una cohorte de Amplitude">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/526a986-Screenshot_2023-09-22_at_7.01.09_PM.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=e5de1d6896a542a980b9840a05200586" alt="Constructor de segmentos de OneSignal usando el filtro de cohorte de Amplitude" width="1622" height="878" data-path="images/docs/526a986-Screenshot_2023-09-22_at_7.01.09_PM.png" />
</Frame>

***

## 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 receipt                           | 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](./subscriptions) 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 receipt                          | 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)                    |

<Warning>
  Los recuentos de entrega pueden diferir entre Amplitude y OneSignal. Consulte [¿Por qué no coinciden los datos de entrega?](#why-doesnt-delivery-data-match) para más detalles.
</Warning>

***

## 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](./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](./subscriptions) o su tipo de Subscription lo admite.

### ¿Por qué no coinciden los datos de entrega?

Un solo usuario puede tener múltiples [Subscriptions](./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](./mobile-sdk-reference#addobserver-user-state), [Web SDK](./web-sdk-reference#addeventlistener-user-state)
* Permission Observer: [Mobile SDK](./mobile-sdk-reference#addpermissionobserver-push), [Web SDK](./web-sdk-reference#permissionchange)

### ¿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](https://amplitude.com/docs/apis/analytics/http-v2#event-deduplication) para obtener más información.

***

## Páginas relacionadas

<Columns cols={2}>
  <Card title="Resumen de análisis" icon="chart-line" href="./analytics-overview">
    Resumen de análisis de OneSignal, métricas de entrega y seguimiento de eventos.
  </Card>

  <Card title="Eventos personalizados" icon="bolt" href="./custom-events">
    Rastrea las acciones del usuario para activar Journeys o potenciar el análisis.
  </Card>
</Columns>

***

<Info>
  Need help?

  Chat with our Support team or email `support@onesignal.com`

  Please 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](/docs/en/capturing-a-debug-log)

  We're happy to help!
</Info>