# Eventos predeterminados
## Qué son los eventos predeterminados
Los Eventos predeterminados son interacciones básicas que los usuarios realizan en aplicaciones o sitios web, independientemente de su industria o funcionalidad. Estas acciones clave del usuario forman el núcleo de la comunicación con el cliente y pueden aprovecharse para cualquier producto y cliente en cualquier etapa del ciclo de vida del cliente.
Los Eventos predeterminados están disponibles de forma predeterminada para las versiones actualizadas del SDK. No necesitan configuraciones adicionales, excepto para PW_InAppPurchase (consulte los detalles a continuación).
Un Evento predeterminado aparece automáticamente en **Audiencia → Eventos** la primera vez que el SDK lo envía. No necesita activarlo para empezar a recopilar datos.
También puede activar un Evento predeterminado para añadirlo a la lista antes de que el SDK lo envíe. Esto le permite crear un segmento o un Customer Journey antes de que lleguen los primeros datos. Para activar un Evento predeterminado:
1. Vaya a la pestaña **Eventos** dentro de la sección **Audiencia**.
2. Haga clic en **Crear Evento**.
3. Seleccione **Evento predeterminado** en el menú desplegable.
4. En la ventana emergente, elija el evento deseado y haga clic en **Activar**.
Use los Eventos predeterminados en la mensajería basada en el comportamiento. Por ejemplo, úselos como una [Entrada basada en disparadores](/es/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/) en Customer Journey o como un disparador para mensajes In-App.
## Uso de dispositivos y aplicaciones
### PW_DeviceRegistered
Este evento se activa cuando un dispositivo sin token push recibe uno, por ejemplo, en el primer lanzamiento de la aplicación después de que el usuario permita las notificaciones. Se vuelve a activar si un dispositivo que perdió su token obtiene uno nuevo. Reemplazar un token existente por uno nuevo no lo activa.
**Atributos del evento**
* **platform** (string): el nombre de la plataforma del dispositivo registrado.
* **platform_id** (integer): el código de la plataforma, el mismo valor que **device_type** en [registerDevice](/es/developer/api-reference/device-api#registerdevice).
**Casos de uso**
* Lance una campaña de incorporación para usuarios recién registrados. Agregue la Entrada basada en disparadores usando el Evento PW_DeviceRegistered a un [Customer Journey](/es/product/customer-journey/pushwoosh-journey-overview/) de incorporación.
* Identifique las actividades de adquisición que le traen más recién llegados con las estadísticas del Evento.
* Involucre a los usuarios desde su primera visita. Recíbalos con [In-Apps](/es/product/messaging-channels/in-apps/?utm_source=docs&utm_medium=post&utm_campaign=default_events) activados por el Evento DeviceRegistered.
### PW_DeviceUnregistered
Este evento se activa cuando un dispositivo pierde su suscripción push: el servicio push informa que el token no es válido (por ejemplo, después de desinstalar la aplicación), la aplicación da de baja el dispositivo a través del SDK o un usuario se da de baja de los correos electrónicos. Para sincronizar estos dispositivos con su propia base de datos, consulte [Sincronizar dispositivos dados de baja con su sistema](/es/product/integrations/event-streaming/#sync-unregistered-devices-to-your-system).
**Atributos del evento**
* **message_id** (string)
* **message_code** (string)
* **campaign_id** (string)
* **platform** (string)
* **platform_id** (integer)
**Casos de uso**
* Retenga a los usuarios cuando decidan dejar de usar su aplicación. Por ejemplo, puede enviar un [correo electrónico](/es/product/messaging-channels/emails/) con una oferta especial a cada usuario que haya desinstalado la aplicación.
* Mantenga la comunicación con los usuarios que se han dado de baja de uno de sus canales. Por ejemplo, si un usuario ya no quiere recibir notificaciones push, puede enviar un [correo electrónico](/es/product/messaging-channels/emails/) o mostrar un [in-app](/es/product/messaging-channels/in-apps/) animándolos a usar la aplicación más a menudo.
### PW_PushAlertsChanged
_Solo para aplicaciones móviles_
Este evento se activa cuando un usuario desactiva o activa las notificaciones push de su aplicación en los ajustes del dispositivo. Está disponible para dispositivos iOS, Android, Huawei y Amazon. Pushwoosh registra el cambio en ambas direcciones: de activadas a desactivadas (opt-out) y de desactivadas a activadas (opt-in).
El evento se crea automáticamente en su aplicación la primera vez que se activa. No necesita activarlo y no aparece en el menú desplegable **Evento predeterminado**. El Panel de Control no permite eliminarlo.
**Cuándo registra Pushwoosh el cambio**
El SDK informa del permiso de notificaciones al iniciar la aplicación. Un usuario que desactiva las notificaciones en los ajustes del dispositivo se registra solo en el siguiente inicio de la aplicación, que puede ocurrir horas o días después. La hora del evento es el momento en que Pushwoosh recibió el cambio, no el momento en que el usuario modificó el ajuste.
El evento requiere un SDK móvil que informe del permiso: SDK de iOS 5.7.2+ o SDK de Android 5.7.5+.
El evento no se activa en estos casos:
* El dispositivo no tiene token push, por ejemplo, en el primer inicio de la aplicación antes de que se solicite el permiso al usuario. Conceder el permiso por primera vez no activa el evento.
* El usuario cancela la suscripción dentro de su aplicación, o el dispositivo se da de baja. Para estos casos, utilice [PW_DeviceUnregistered](#pw_deviceunregistered).
* El dispositivo es web, correo electrónico, SMS u otro canal no móvil.
**Atributos del evento**
* **old_value** (boolean): el estado anterior del permiso. `true` significa que las notificaciones estaban activadas.
* **new_value** (boolean): el nuevo estado del permiso. `false` significa que el usuario desactivó las notificaciones (opt-out), `true` significa que las activó (opt-in).
* **reason** (string): qué estableció el nuevo estado.
* `sdk`: el SDK de Pushwoosh informó del permiso desde el dispositivo. Utilice este valor para rastrear los cambios realizados por los usuarios.
* `api_field`: el permiso se envió en una solicitud de API desde su servidor o desde una importación de datos.
* `set_tags`: el [Tag](/es/product/audience-data-and-segmentation/user-data-tags/tags/) **Push Alerts Enabled** se modificó directamente, por ejemplo, con `setTags`.
* `default_true`: el dispositivo tiene un token push pero la solicitud no incluía el permiso, por lo que Pushwoosh lo estableció como activado.
* **source** (string): el método de API que informó del cambio, como `registerDevice`, `applicationOpen`, `multiRegisterDevice` o `setTags`.
* **token_in_request** (boolean): si la solicitud incluía un token push. Siempre `false` para `applicationOpen`.
* **request_ts** (integer): hora Unix en que Pushwoosh recibió la solicitud.
* **prev_app_open_at** (integer): hora Unix del inicio anterior de la aplicación antes del cambio. Junto con **request_ts**, muestra la ventana de tiempo en la que el usuario cambió el ajuste. Se incluye solo si se conoce.
* **app_version** (version): la versión de la aplicación. Se incluye solo si la solicitud la contiene.
* **os_version** (version): la versión del SO del dispositivo. Se incluye solo si la solicitud la contiene.
**Casos de uso**
* Recupere a los usuarios que desactivaron las notificaciones. Inicie un [Customer Journey](/es/product/customer-journey/pushwoosh-journey-overview/) con una [Entrada basada en disparadores](/es/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/) en PW_PushAlertsChanged con **new_value** igual a `false` y llegue a ellos por correo electrónico, SMS o un [pop-up de recuperación de opt-out](/es/product/content/in-apps/create-opt-in-and-opt-out-recovery-popups-in-pushwoosh-in-app-editor/#opt-out-recovery-popup).
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios que desactivaron las notificaciones dentro de un período. Filtre por **reason** igual a `sdk` para conservar solo los cambios realizados por los usuarios en sus dispositivos.
* Dé la bienvenida a los usuarios que volvieron a activar las notificaciones con un push que destaque lo que se perdieron.
* Haga un seguimiento de la frecuencia con la que los usuarios optan por no recibir notificaciones tras campañas específicas en el [Historial de eventos](/es/product/audience-data-and-segmentation/user-explorer/#events-history-tab) y en las estadísticas de eventos.
### PW_ApplicationOpen
_Solo para aplicaciones móviles_
El evento ApplicationOpen se activa **cada vez que un usuario inicia su aplicación móvil** en su dispositivo.
**Atributos del evento**
* **device_type** (integer): código del tipo de dispositivo. Consulte [registerDevice](/es/developer/api-reference/device-api#registerdevice) para más detalles.
* **application_version** (string): la versión de la aplicación.
**Casos de uso**
* Recopile estadísticas de retención de usuarios basadas en las estadísticas del evento ApplicationOpen.
* Ejecute campañas de mensajería in-app para usuarios que están activos en la aplicación.
### PW_ScreenOpen
_Solo para aplicaciones móviles_
Este evento se activa cada vez que un usuario ve una **pantalla específica en su aplicación móvil**.
**Atributos del evento**
* **application_version** (string): la versión de la aplicación.
* **device_type** (integer): código del tipo de dispositivo. Consulte [registerDevice](/es/developer/api-reference/device-api#registerdevice) para más detalles.
* **screen_name** (string): nombre técnico de la pantalla obtenido de su aplicación.
**Casos de uso**
* Envíe mensajes perfectamente relevantes a los usuarios que mostraron su interés en secciones específicas de la aplicación iniciando Customer Journeys con el evento PW_ScreenOpen.
* Evalúe y mejore la efectividad de sus promociones. [Pruebe A/B/n](/es/product/customer-journey/journey-elements/flow-controls/abn-split/) dos o varias versiones de su oferta, espere a que ocurra el evento ScreenOpen y luego vea qué contenido ha funcionado mejor.
* Conozca qué pantallas de la aplicación se visitan más. Filtre las estadísticas del Evento por nombre de pantalla.
### PW_ApplicationMinimized
_Solo para aplicaciones móviles_
Este evento se activa cuando un usuario minimiza (pero no fuerza la detención) la aplicación en su dispositivo.
**Atributos del evento**
* **device_type** (integer): código del tipo de dispositivo. Consulte [registerDevice](/es/developer/api-reference/device-api#registerdevice) para más detalles.
* **application_version** (string): la versión de la aplicación.
**Casos de uso**
* Rastree el tiempo promedio de sesión entre los eventos ApplicationOpen y ApplicationMinimized.
* Envíe notificaciones push mientras la aplicación se ejecuta en segundo plano para captar la atención de los usuarios y devolverlos a la aplicación.
### PW_UserIdle
_Solo para aplicaciones móviles_
Este evento se activa cuando un usuario está dentro de su aplicación pero no ha interactuado con la pantalla durante un período configurable. A diferencia de PW_ApplicationMinimized, que se activa después de que el usuario abandona la aplicación, PW_UserIdle se activa mientras el usuario todavía está en la aplicación. Captura el momento en que la atención disminuye, el usuario duda o se distrae. Úselo como una señal del lado del servidor para mostrar un In-App oportuno, ofrecer asistencia o empujar al usuario hacia el siguiente paso.
La detección de inactividad está deshabilitada por defecto en ambas plataformas. Cuando la clave de tiempo de espera falta o está establecida en `0`, no se envían eventos PW_UserIdle. Para habilitarla, establezca el tiempo de espera (mínimo 30 segundos) en la configuración de la plataforma de su aplicación:
* **iOS:** agregue la clave `Pushwoosh_IDLE_TIMEOUT_SECONDS` (Número, mínimo 30) al Info.plist de su aplicación.
* **Android:** agregue los metadatos `com.pushwoosh.idle_timeout_seconds` (entero, mínimo 30) a su **AndroidManifest.xml**.
**Atributos del evento**
* **screen_name** (string): la pantalla donde el usuario quedó inactivo. En Android, formateado como `ActivityName/FragmentName` cuando la pantalla actual está anidada. De lo contrario, el nombre de la actividad. En iOS, formateado como `ParentVC/ChildVC` cuando está anidado. De lo contrario, el nombre del controlador de vista.
* **idle_seconds** (integer): el tiempo de espera de inactividad configurado que transcurrió.
* **session_duration** (integer): segundos desde que la aplicación se trajo por última vez al primer plano.
* **device_type** (integer): código del tipo de dispositivo. Consulte [registerDevice](/es/developer/api-reference/device-api#registerdevice) para más detalles.
* **application_version** (string): la versión de la aplicación.
**Comportamiento**
* Se activa como máximo **una vez por sesión en primer plano**. Volver al segundo plano y de nuevo al primer plano inicia una nueva sesión.
* El temporizador se pausa automáticamente mientras el teclado virtual está abierto, mientras un diálogo modal o un aviso del sistema está en pantalla, y mientras la aplicación está en segundo plano.
* La interacción física con la pantalla (toques, desplazamiento y escritura) reinicia el temporizador.
**Casos de uso**
* Active una oferta In-App o un asistente en contexto cuando los usuarios permanezcan en una pantalla de alta intención (carrito, precios, pago) sin tomar acción.
* Muestre una pista o tutorial cuando los usuarios se detengan en un paso de incorporación.
* Identifique dónde pierden impulso los usuarios filtrando las estadísticas de eventos de inactividad por `screen_name`.
### PW_ApplicationExit
_Solo para aplicaciones móviles_
Este evento se activa cuando un usuario pone la aplicación en segundo plano y **no regresa dentro de un tiempo de espera configurable**. A diferencia de PW_ApplicationMinimized, que se activa inmediatamente cuando el usuario se va, PW_ApplicationExit se activa solo después de que ha transcurrido el retraso configurado. Confirma que el usuario ha abandonado genuinamente la sesión en lugar de cambiar brevemente de aplicación. Úselo para volver a involucrar a los usuarios que han abandonado una sesión a mitad de camino, o para activar campañas de seguimiento después de una salida confirmada.
La detección de intención de salida está deshabilitada por defecto. Para habilitarla, establezca el tiempo de espera (10–30 segundos, los valores fuera de este rango se ajustan automáticamente) en la configuración de la plataforma de su aplicación:
* **Android:** agregue los metadatos `com.pushwoosh.exit_intent_timeout_seconds` (entero, 10–30) a su **AndroidManifest.xml**.
* **iOS:** agregue la clave `Pushwoosh_APPLICATION_EXIT_TIMEOUT_SECONDS` (Número, 10–30) al **Info.plist** de su aplicación.
**Atributos del evento**
* **screen_name** (string): la última pantalla activa cuando el usuario puso la aplicación en segundo plano.
* **session_duration** (integer): segundos desde que la aplicación se trajo por última vez al primer plano.
* **exit_intent_seconds** (integer): el tiempo de espera efectivo que transcurrió antes de que se activara el evento (10–30 s).
* **device_type** (integer): código del tipo de dispositivo. Consulte [registerDevice](/es/developer/api-reference/device-api#registerdevice) para más detalles.
* **application_version** (string): la versión de la aplicación.
**Comportamiento**
* El temporizador comienza cuando la aplicación se pone en segundo plano y se **cancela** si el usuario regresa antes de que expire el tiempo de espera.
* El nombre de la pantalla y la duración de la sesión se capturan en el momento de pasar a segundo plano, no cuando se activa el evento.
* El evento no se activa si la detección de intención de salida está deshabilitada (la clave de tiempo de espera es `0` o no está establecida).
**Casos de uso**
* Vuelva a involucrar a los usuarios que abandonaron un flujo de compra o registro. Active una notificación push o un correo electrónico con un recordatorio o descuento.
* Inicie un Customer Journey de recuperación para los usuarios que salen sin completar una acción clave (por ejemplo, dejar un carrito o detenerse a mitad de la incorporación).
* Identifique las pantallas con alta tasa de abandono filtrando las estadísticas de eventos por `screen_name`.
## Web
### PW_SiteOpened
_Solo para web_
El evento SiteOpened se activa cada vez que un usuario abre cualquiera de las páginas de su sitio web.
**Atributos del evento**
* **device_type** (integer): código del tipo de dispositivo. Consulte [registerDevice](/es/developer/api-reference/device-api#registerdevice) para más detalles.
* **title** (string): el título de la página visitada.
* **url** (string): la URL de la página visitada.
**Casos de uso**
* Analice la distribución del tráfico de su sitio y compare el número de veces que los usuarios abren páginas específicas del sitio. Para ello, filtre las estadísticas del Evento por sus atributos.
* Haga un seguimiento de la visita de un usuario al sitio web con una comunicación relevante. Cree un journey que comience con el evento SiteOpened configurado para un atributo `title` o `url` específico.
## Comercio
### PW_InAppPurchase
_Solo para aplicaciones móviles_
El evento InAppPurchase se activa cada vez que un usuario compra un artículo in-app en su aplicación. Los ejemplos incluyen suscripciones de pago, elementos de mecánica de juego, moneda in-app, etc.
Para implementar el evento de Compra In-App:
* **iOS:** establezca el parámetro `Pushwoosh_PURCHASE_TRACKING_ENABLED` del SDK de Pushwoosh para iOS en `yes`.
* **Android:** configure el envío de información de compra a Pushwoosh [usando esta guía](/es/developer/pushwoosh-sdk/android-sdk/customizing-android-sdk-50#in-app-purchase-tracking).
**Atributos del evento**
* **productIdentifier** (string): obtenido de la App Store.
* **quantity** (integer): el número de artículos comprados.
* **transactionDate** (string): fecha de la compra.
* **status** (string): estado de la compra.
**Casos de uso**
* Recopile estadísticas de compras in-app.
* Ejecute promociones y haga un seguimiento de su éxito. Establezca el evento Esperar Disparador después del mensaje de la promoción.
## Notificaciones push
### PW_NotificationSend
_Solo para móvil y web_
Este evento se activa una vez que se envía un mensaje de Pushwoosh al dispositivo de un usuario.
**Atributos del evento**
* **message_id** (string)
* **message_code** (string)
* **campaign_id** (string)
**Casos de uso**
* Rastree si se envía un mensaje, independientemente del canal utilizado.
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios basados en el número de mensajes enviados.
* Vea todos los mensajes enviados a un usuario en el [historial de Eventos](/es/product/audience-data-and-segmentation/user-explorer/#events-history) y analice el comportamiento posterior del usuario.
### PW_NotificationOpen
_Solo para móvil y web_
Este evento se activa cada vez que un usuario abre una notificación push enviada con Pushwoosh.
**Casos de uso**
* Configure el [momento óptimo para enviar un push](/es/product/messaging-channels/push-notifications/send-push-notifications/one-time-push#optimal-time-paid-subscription-required).
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) basados en el rendimiento de las notificaciones dentro de un período de tiempo específico.
## Correo electrónico
### PW_EmailSent
_Solo para correo electrónico_
Este evento se activa una vez que se envía un correo electrónico al proveedor de correo electrónico. Verifique **status_code** para el resultado.
**Atributos del evento**
* **message_id** (string): el ID del mensaje.
* **message_code** (string): el identificador único del mensaje de correo electrónico específico.
* **status_code** (integer): el código de estado de entrega devuelto por el proveedor de correo electrónico para este intento de envío.
* **campaign_id** (string): el ID de la campaña. Se incluye solo si el correo electrónico se envió como parte de una campaña.
* **campaign_code** (string): el código único de la campaña. Se incluye cuando el envío es parte de una campaña y la búsqueda de la campaña tiene éxito. **campaign_code** puede faltar incluso cuando **campaign_id** está presente.
**Casos de uso**
* Rastree los resultados del envío usando **status_code**, por separado de si el correo electrónico fue abierto o se hizo clic en él más tarde.
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios basados en el número de correos electrónicos enviados.
* Vea todos los correos electrónicos enviados a un usuario en el [historial de Eventos](/es/product/audience-data-and-segmentation/user-explorer/#events-history) y analice el comportamiento posterior del usuario.
### PW_EmailOpen
_Solo para correo electrónico_
Este evento se activa cuando un usuario abre un correo electrónico enviado a través de Pushwoosh.
**Atributos del evento**
* **campaign_code** (string): el código único de la campaña asociada con el correo electrónico.
* **campaign_id** (string): el ID de la campaña.
* **message_code** (string): el identificador único del mensaje de correo electrónico específico.
* **message_id** (string): el ID del mensaje.
* **opened_by** (string): quién o qué activó la apertura: `user` para una apertura genuina por parte del destinatario, o `ampp` para una apertura automatizada activada por la [Protección de Privacidad de Mail de Apple](/es/product/statistics-and-analytics/messaging-statistics/email-statistics#what-each-step-includes) que precarga el píxel de seguimiento.
**Casos de uso**
* Rastree las aperturas de correos electrónicos para identificar a los usuarios que interactúan activamente con sus correos electrónicos. Use estos datos para crear campañas de seguimiento, como enviar códigos de descuento a los usuarios que abren correos electrónicos promocionales.
* Si los usuarios abren un correo electrónico pero no completan la acción deseada (por ejemplo, realizar una compra), puede activar correos electrónicos de seguimiento con recordatorios u ofertas personalizadas.
* Analice las tasas de apertura en todas las campañas para refinar sus líneas de asunto y estrategias de tiempo de correo electrónico para campañas como lanzamientos de productos o promociones de temporada.
* Cree un [segmento](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) basado en **PW_EmailOpen** con **opened_by** igual a `user` para dirigirse a los destinatarios que abrieron el correo electrónico, excluyendo las aperturas activadas por AMPP.
### PW_EmailLinkClicked
_Solo para correo electrónico_
Este evento se activa cada vez que un usuario hace clic en un enlace en un correo electrónico.
**Atributos del evento**
* **message_id** (string)
* **message_code** (string)
* **campaign_id** (string)
* **redirect_link** (string)
* **original_link** (string)
**Casos de uso**
* Ejecute campañas dirigidas a usuarios que hacen clic en un enlace específico en un correo electrónico.
* Envíe otro mensaje a los usuarios que ignoraron el enlace en el primer correo electrónico para animarlos a hacer clic en él (o tomar otra acción).
### PW_EmailSubscribed
_Solo para correo electrónico_
Este evento se activa cuando un usuario se suscribe a una o más categorías de correo electrónico — desde un envío de un [centro de preferencias](/es/product/messaging-channels/emails/email-preferences/) o un enlace para volver a suscribirse, y también en la suscripción automática cuando un nuevo dispositivo de correo electrónico se registra por primera vez.
**Atributos del evento**
* **message_id** (string): el ID del mensaje que activó la suscripción, si corresponde.
* **campaign_id** (string): el ID de la campaña asociada, si corresponde.
* **message_code** (string): el identificador único del mensaje específico, si corresponde.
* **categories** (array de strings): los nombres de las categorías de correo electrónico a las que el usuario se suscribió; se omite si no aplica ninguna (por ejemplo, registro sin categorías suscritas automáticamente).
* **resubscribe** (boolean): `true` para cualquier envío desde el centro de preferencias o el enlace para volver a suscribirse — incluida la primera suscripción de un usuario realizada allí; se omite para la suscripción automática en el registro del dispositivo.
**Casos de uso**
* Use **resubscribe** para aislar las suscripciones impulsadas por el centro de preferencias de la suscripción automática en el registro.
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios suscritos a una categoría específica.
### PW_EmailUnsubscribed
_Solo para correo electrónico_
Este evento se activa cuando un usuario se da de baja de una o más categorías de correo electrónico, y también en una exclusión total de todos los correos electrónicos de marketing (etiqueta **Unsubscribed Emails**) — en ese caso, **categories** se omite. Si un usuario se da de baja de varias categorías a la vez, **categories** las enumera todas.
**Atributos del evento**
* **message_id** (string): el ID del mensaje del que el usuario se dio de baja, si corresponde.
* **campaign_id** (string): el ID de la campaña asociada, si corresponde.
* **message_code** (string): el identificador único del mensaje específico, si corresponde.
* **categories** (array de strings): los nombres de las categorías de correo electrónico de las que el usuario se dio de baja; se omite en una exclusión total.
**Casos de uso**
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios que se dieron de baja de una categoría específica para excluirlos de futuras campañas para esa categoría.
* Active un journey de recuperación para los usuarios que se dan de baja de una categoría.
## Mensajes in-app
### PW_InAppShown
_Solo para aplicaciones móviles_
Este evento se activa cuando se muestra un mensaje in-app al usuario.
**Atributos del evento**
* **message_code** (string): el identificador único del mensaje específico asociado con el in-app.
* **message_id** (integer): el ID del mensaje.
* **campaign_code** (string): el código único de la campaña asociada con el in-app.
* **campaign_id** (integer): el ID de la campaña que activó el in-app.
* **rich_media_code** (string): el identificador único del contenido de rich media mostrado en el in-app.
* **inapp_code** (string): el código único que identifica el mensaje in-app específico mostrado.
**Casos de uso**
* Rastree la frecuencia de las vistas de mensajes in-app para ajustar su estrategia de mensajería, como eliminar mensajes redundantes que podrían molestar a los usuarios.
* Use los datos de impresiones in-app para evaluar el alcance de las campañas promocionales como ventas flash o actualizaciones de suscripción.
* Si se muestra un mensaje in-app pero no se hace clic en él, puede activar una acción de seguimiento, como enviar una notificación push con contenido similar para reforzar el mensaje.
### PW_InAppClicked
_Solo para aplicaciones móviles_
Este evento se activa cuando un usuario interactúa con un mensaje in-app haciendo clic en él.
**Atributos del evento**
* **message_code** (string): el identificador único del mensaje específico asociado con el in-app.
* **message_id** (integer): el ID del mensaje.
* **campaign_code** (string): el código único de la campaña asociada con el in-app.
* **campaign_id** (integer): el ID de la campaña que activó el in-app.
* **rich_media_code** (string): el identificador único del contenido de rich media mostrado en el in-app (si corresponde).
* **inapp_code** (string): el código único que identifica el mensaje in-app específico en el que se hizo clic.
* **element_id** (string): el identificador del elemento específico dentro del mensaje in-app en el que se hizo clic (por ejemplo, un botón o enlace).
* **link** (string): la URL o el deep link asociado con el elemento en el que se hizo clic.
**Casos de uso**
* Analice el comportamiento de los clics para identificar con qué botones o enlaces interactúan más los usuarios y optimice los diseños futuros de los mensajes in-app. Por ejemplo, pruebe diferentes CTA en las campañas de actualización de suscripciones.
* Active acciones automatizadas basadas en los clics de los usuarios, como redirigir a los usuarios a una página de producto específica o enviar una notificación push.
## SMS
### PW_SMSSent
_Solo para SMS_
Este evento se activa una vez que se envía un SMS al proveedor de SMS. Verifique **status_code** para el resultado.
**Atributos del evento**
* **message_id** (string): el ID del mensaje.
* **message_code** (string): el identificador único del mensaje SMS específico.
* **status_code** (integer): el código de estado de entrega devuelto por el proveedor de SMS para este intento de envío. Úselo para distinguir el éxito del fracaso.
* **campaign_id** (string): el ID de la campaña. Se incluye solo si el SMS se envió como parte de una campaña.
* **campaign_code** (string): el código único de la campaña. Se incluye cuando el envío es parte de una campaña y la búsqueda de la campaña tiene éxito. **campaign_code** puede faltar incluso cuando **campaign_id** está presente.
**Casos de uso**
* Rastree los resultados del envío usando **status_code**, independientemente del canal utilizado en otras partes del mismo journey.
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios basados en el número de mensajes SMS enviados.
* Vea todos los mensajes SMS enviados a un usuario en el [historial de Eventos](/es/product/audience-data-and-segmentation/user-explorer/#events-history) y analice el comportamiento posterior del usuario.
## WhatsApp
### PW_WhatsAppSent
_Solo para WhatsApp_
Este evento se activa una vez que se envía un mensaje de WhatsApp al proveedor de WhatsApp. Verifique **status_code** para el resultado.
**Atributos del evento**
* **message_id** (string): el ID del mensaje.
* **message_code** (string): el identificador único del mensaje de WhatsApp específico.
* **status_code** (integer): el código de estado de entrega devuelto por el proveedor de WhatsApp para este intento de envío. Úselo para distinguir el éxito del fracaso.
* **campaign_id** (string): el ID de la campaña. Se incluye solo si el mensaje de WhatsApp se envió como parte de una campaña.
* **campaign_code** (string): el código único de la campaña. Se incluye cuando el envío es parte de una campaña y la búsqueda de la campaña tiene éxito. **campaign_code** puede faltar incluso cuando **campaign_id** está presente.
**Casos de uso**
* Rastree los resultados del envío usando **status_code**, por separado del estado de entrega o lectura.
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios basados en el número de mensajes de WhatsApp enviados.
* Vea todos los mensajes de WhatsApp enviados a un usuario en el [historial de Eventos](/es/product/audience-data-and-segmentation/user-explorer/#events-history) y analice el comportamiento posterior del usuario.
### PW_WhatsAppReceived
_Solo para WhatsApp_
Este evento se activa cuando se recibe un mensaje de WhatsApp a través del sistema.
**Atributos del evento**
* **message** (string): el contenido del mensaje recibido. Para mensajes de ubicación, contiene las coordenadas en formato `"latitud,longitud"` (por ejemplo, `"55.751244,37.618423"`).
* **latitude** (number): la latitud de la ubicación compartida. Se incluye solo cuando el usuario comparte su ubicación actual.
* **longitude** (number): la longitud de la ubicación compartida. Se incluye solo cuando el usuario comparte su ubicación actual.
Estos atributos se incluyen solo si el proveedor de WhatsApp los envía, en el primer mensaje de una conversación de Click-to-WhatsApp:
* **ctwa_clid** (string): el ID de clic del anuncio de Click-to-WhatsApp que inició la conversación. Úselo para la atribución de conversiones — cada valor es único por clic, por lo que no es útil para la segmentación.
* **referral_source_id** (string): el ID del anuncio o publicación que inició la conversación. Cuando la fuente es un anuncio, este es el mismo ID de anuncio que se muestra en el Administrador de anuncios de Meta; las publicaciones no se enumeran allí.
* **referral_source_type** (string): el tipo de la fuente de referencia, como un anuncio o una publicación.
* **referral_source_url** (string): la URL del anuncio o publicación que inició la conversación.
* **referral_headline** (string): el texto del titular del anuncio.
* **referral_body** (string): el texto del cuerpo del anuncio.
**Casos de uso**
* Automatice acciones de seguimiento en respuesta a los mensajes de WhatsApp entrantes (como iniciar un Customer Journey o rastrear eventos de participación del usuario).
* Segmente a los usuarios según sus interacciones con los mensajes de WhatsApp para permitir mensajes dirigidos o campañas personalizadas.
* Use los atributos `latitude` y `longitude` para activar journeys basados en la ubicación cuando un usuario comparte su ubicación.
* Use los atributos `ctwa_clid` y `referral_*` para atribuir una conversación al anuncio específico de Click-to-WhatsApp que la inició.
* Use las etiquetas de dispositivo [`WhatsApp Ad Click ID` y `WhatsApp Ad Click Date`](/es/product/audience-data-and-segmentation/user-data-tags/tags/#default-tags), que persisten más allá de la conversación, para crear [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-tags) de usuarios que hicieron clic en un anuncio y luego se convirtieron.
Use los Eventos predeterminados en la mensajería basada en el comportamiento. Por ejemplo, úselos como una [Entrada basada en disparadores](/es/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/) en Customer Journey o como un disparador para mensajes In-App.
## Uso de dispositivos y aplicaciones
### PW_DeviceRegistered
Este evento se activa cuando un dispositivo sin token push recibe uno, por ejemplo, en el primer lanzamiento de la aplicación después de que el usuario permita las notificaciones. Se vuelve a activar si un dispositivo que perdió su token obtiene uno nuevo. Reemplazar un token existente por uno nuevo no lo activa.
**Atributos del evento**
* **platform** (string): el nombre de la plataforma del dispositivo registrado.
* **platform_id** (integer): el código de la plataforma, el mismo valor que **device_type** en [registerDevice](/es/developer/api-reference/device-api#registerdevice).
**Casos de uso**
* Lance una campaña de incorporación para usuarios recién registrados. Agregue la Entrada basada en disparadores usando el Evento PW_DeviceRegistered a un [Customer Journey](/es/product/customer-journey/pushwoosh-journey-overview/) de incorporación.
* Identifique las actividades de adquisición que le traen más recién llegados con las estadísticas del Evento.
* Involucre a los usuarios desde su primera visita. Recíbalos con [In-Apps](/es/product/messaging-channels/in-apps/?utm_source=docs&utm_medium=post&utm_campaign=default_events) activados por el Evento DeviceRegistered.
### PW_DeviceUnregistered
Este evento se activa cuando un dispositivo pierde su suscripción push: el servicio push informa que el token no es válido (por ejemplo, después de desinstalar la aplicación), la aplicación da de baja el dispositivo a través del SDK o un usuario se da de baja de los correos electrónicos. Para sincronizar estos dispositivos con su propia base de datos, consulte [Sincronizar dispositivos dados de baja con su sistema](/es/product/integrations/event-streaming/#sync-unregistered-devices-to-your-system).
**Atributos del evento**
* **message_id** (string)
* **message_code** (string)
* **campaign_id** (string)
* **platform** (string)
* **platform_id** (integer)
**Casos de uso**
* Retenga a los usuarios cuando decidan dejar de usar su aplicación. Por ejemplo, puede enviar un [correo electrónico](/es/product/messaging-channels/emails/) con una oferta especial a cada usuario que haya desinstalado la aplicación.
* Mantenga la comunicación con los usuarios que se han dado de baja de uno de sus canales. Por ejemplo, si un usuario ya no quiere recibir notificaciones push, puede enviar un [correo electrónico](/es/product/messaging-channels/emails/) o mostrar un [in-app](/es/product/messaging-channels/in-apps/) animándolos a usar la aplicación más a menudo.
### PW_PushAlertsChanged
_Solo para aplicaciones móviles_
Este evento se activa cuando un usuario desactiva o activa las notificaciones push de su aplicación en los ajustes del dispositivo. Está disponible para dispositivos iOS, Android, Huawei y Amazon. Pushwoosh registra el cambio en ambas direcciones: de activadas a desactivadas (opt-out) y de desactivadas a activadas (opt-in).
El evento se crea automáticamente en su aplicación la primera vez que se activa. No necesita activarlo y no aparece en el menú desplegable **Evento predeterminado**. El Panel de Control no permite eliminarlo.
**Cuándo registra Pushwoosh el cambio**
El SDK informa del permiso de notificaciones al iniciar la aplicación. Un usuario que desactiva las notificaciones en los ajustes del dispositivo se registra solo en el siguiente inicio de la aplicación, que puede ocurrir horas o días después. La hora del evento es el momento en que Pushwoosh recibió el cambio, no el momento en que el usuario modificó el ajuste.
El evento requiere un SDK móvil que informe del permiso: SDK de iOS 5.7.2+ o SDK de Android 5.7.5+.
El evento no se activa en estos casos:
* El dispositivo no tiene token push, por ejemplo, en el primer inicio de la aplicación antes de que se solicite el permiso al usuario. Conceder el permiso por primera vez no activa el evento.
* El usuario cancela la suscripción dentro de su aplicación, o el dispositivo se da de baja. Para estos casos, utilice [PW_DeviceUnregistered](#pw_deviceunregistered).
* El dispositivo es web, correo electrónico, SMS u otro canal no móvil.
**Atributos del evento**
* **old_value** (boolean): el estado anterior del permiso. `true` significa que las notificaciones estaban activadas.
* **new_value** (boolean): el nuevo estado del permiso. `false` significa que el usuario desactivó las notificaciones (opt-out), `true` significa que las activó (opt-in).
* **reason** (string): qué estableció el nuevo estado.
* `sdk`: el SDK de Pushwoosh informó del permiso desde el dispositivo. Utilice este valor para rastrear los cambios realizados por los usuarios.
* `api_field`: el permiso se envió en una solicitud de API desde su servidor o desde una importación de datos.
* `set_tags`: el [Tag](/es/product/audience-data-and-segmentation/user-data-tags/tags/) **Push Alerts Enabled** se modificó directamente, por ejemplo, con `setTags`.
* `default_true`: el dispositivo tiene un token push pero la solicitud no incluía el permiso, por lo que Pushwoosh lo estableció como activado.
* **source** (string): el método de API que informó del cambio, como `registerDevice`, `applicationOpen`, `multiRegisterDevice` o `setTags`.
* **token_in_request** (boolean): si la solicitud incluía un token push. Siempre `false` para `applicationOpen`.
* **request_ts** (integer): hora Unix en que Pushwoosh recibió la solicitud.
* **prev_app_open_at** (integer): hora Unix del inicio anterior de la aplicación antes del cambio. Junto con **request_ts**, muestra la ventana de tiempo en la que el usuario cambió el ajuste. Se incluye solo si se conoce.
* **app_version** (version): la versión de la aplicación. Se incluye solo si la solicitud la contiene.
* **os_version** (version): la versión del SO del dispositivo. Se incluye solo si la solicitud la contiene.
**Casos de uso**
* Recupere a los usuarios que desactivaron las notificaciones. Inicie un [Customer Journey](/es/product/customer-journey/pushwoosh-journey-overview/) con una [Entrada basada en disparadores](/es/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/) en PW_PushAlertsChanged con **new_value** igual a `false` y llegue a ellos por correo electrónico, SMS o un [pop-up de recuperación de opt-out](/es/product/content/in-apps/create-opt-in-and-opt-out-recovery-popups-in-pushwoosh-in-app-editor/#opt-out-recovery-popup).
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios que desactivaron las notificaciones dentro de un período. Filtre por **reason** igual a `sdk` para conservar solo los cambios realizados por los usuarios en sus dispositivos.
* Dé la bienvenida a los usuarios que volvieron a activar las notificaciones con un push que destaque lo que se perdieron.
* Haga un seguimiento de la frecuencia con la que los usuarios optan por no recibir notificaciones tras campañas específicas en el [Historial de eventos](/es/product/audience-data-and-segmentation/user-explorer/#events-history-tab) y en las estadísticas de eventos.
### PW_ApplicationOpen
_Solo para aplicaciones móviles_
El evento ApplicationOpen se activa **cada vez que un usuario inicia su aplicación móvil** en su dispositivo.
**Atributos del evento**
* **device_type** (integer): código del tipo de dispositivo. Consulte [registerDevice](/es/developer/api-reference/device-api#registerdevice) para más detalles.
* **application_version** (string): la versión de la aplicación.
**Casos de uso**
* Recopile estadísticas de retención de usuarios basadas en las estadísticas del evento ApplicationOpen.
* Ejecute campañas de mensajería in-app para usuarios que están activos en la aplicación.
### PW_ScreenOpen
_Solo para aplicaciones móviles_
Este evento se activa cada vez que un usuario ve una **pantalla específica en su aplicación móvil**.
**Atributos del evento**
* **application_version** (string): la versión de la aplicación.
* **device_type** (integer): código del tipo de dispositivo. Consulte [registerDevice](/es/developer/api-reference/device-api#registerdevice) para más detalles.
* **screen_name** (string): nombre técnico de la pantalla obtenido de su aplicación.
**Casos de uso**
* Envíe mensajes perfectamente relevantes a los usuarios que mostraron su interés en secciones específicas de la aplicación iniciando Customer Journeys con el evento PW_ScreenOpen.
* Evalúe y mejore la efectividad de sus promociones. [Pruebe A/B/n](/es/product/customer-journey/journey-elements/flow-controls/abn-split/) dos o varias versiones de su oferta, espere a que ocurra el evento ScreenOpen y luego vea qué contenido ha funcionado mejor.
* Conozca qué pantallas de la aplicación se visitan más. Filtre las estadísticas del Evento por nombre de pantalla.
### PW_ApplicationMinimized
_Solo para aplicaciones móviles_
Este evento se activa cuando un usuario minimiza (pero no fuerza la detención) la aplicación en su dispositivo.
**Atributos del evento**
* **device_type** (integer): código del tipo de dispositivo. Consulte [registerDevice](/es/developer/api-reference/device-api#registerdevice) para más detalles.
* **application_version** (string): la versión de la aplicación.
**Casos de uso**
* Rastree el tiempo promedio de sesión entre los eventos ApplicationOpen y ApplicationMinimized.
* Envíe notificaciones push mientras la aplicación se ejecuta en segundo plano para captar la atención de los usuarios y devolverlos a la aplicación.
### PW_UserIdle
_Solo para aplicaciones móviles_
Este evento se activa cuando un usuario está dentro de su aplicación pero no ha interactuado con la pantalla durante un período configurable. A diferencia de PW_ApplicationMinimized, que se activa después de que el usuario abandona la aplicación, PW_UserIdle se activa mientras el usuario todavía está en la aplicación. Captura el momento en que la atención disminuye, el usuario duda o se distrae. Úselo como una señal del lado del servidor para mostrar un In-App oportuno, ofrecer asistencia o empujar al usuario hacia el siguiente paso.
La detección de inactividad está deshabilitada por defecto en ambas plataformas. Cuando la clave de tiempo de espera falta o está establecida en `0`, no se envían eventos PW_UserIdle. Para habilitarla, establezca el tiempo de espera (mínimo 30 segundos) en la configuración de la plataforma de su aplicación:
* **iOS:** agregue la clave `Pushwoosh_IDLE_TIMEOUT_SECONDS` (Número, mínimo 30) al Info.plist de su aplicación.
* **Android:** agregue los metadatos `com.pushwoosh.idle_timeout_seconds` (entero, mínimo 30) a su **AndroidManifest.xml**.
**Atributos del evento**
* **screen_name** (string): la pantalla donde el usuario quedó inactivo. En Android, formateado como `ActivityName/FragmentName` cuando la pantalla actual está anidada. De lo contrario, el nombre de la actividad. En iOS, formateado como `ParentVC/ChildVC` cuando está anidado. De lo contrario, el nombre del controlador de vista.
* **idle_seconds** (integer): el tiempo de espera de inactividad configurado que transcurrió.
* **session_duration** (integer): segundos desde que la aplicación se trajo por última vez al primer plano.
* **device_type** (integer): código del tipo de dispositivo. Consulte [registerDevice](/es/developer/api-reference/device-api#registerdevice) para más detalles.
* **application_version** (string): la versión de la aplicación.
**Comportamiento**
* Se activa como máximo **una vez por sesión en primer plano**. Volver al segundo plano y de nuevo al primer plano inicia una nueva sesión.
* El temporizador se pausa automáticamente mientras el teclado virtual está abierto, mientras un diálogo modal o un aviso del sistema está en pantalla, y mientras la aplicación está en segundo plano.
* La interacción física con la pantalla (toques, desplazamiento y escritura) reinicia el temporizador.
**Casos de uso**
* Active una oferta In-App o un asistente en contexto cuando los usuarios permanezcan en una pantalla de alta intención (carrito, precios, pago) sin tomar acción.
* Muestre una pista o tutorial cuando los usuarios se detengan en un paso de incorporación.
* Identifique dónde pierden impulso los usuarios filtrando las estadísticas de eventos de inactividad por `screen_name`.
### PW_ApplicationExit
_Solo para aplicaciones móviles_
Este evento se activa cuando un usuario pone la aplicación en segundo plano y **no regresa dentro de un tiempo de espera configurable**. A diferencia de PW_ApplicationMinimized, que se activa inmediatamente cuando el usuario se va, PW_ApplicationExit se activa solo después de que ha transcurrido el retraso configurado. Confirma que el usuario ha abandonado genuinamente la sesión en lugar de cambiar brevemente de aplicación. Úselo para volver a involucrar a los usuarios que han abandonado una sesión a mitad de camino, o para activar campañas de seguimiento después de una salida confirmada.
La detección de intención de salida está deshabilitada por defecto. Para habilitarla, establezca el tiempo de espera (10–30 segundos, los valores fuera de este rango se ajustan automáticamente) en la configuración de la plataforma de su aplicación:
* **Android:** agregue los metadatos `com.pushwoosh.exit_intent_timeout_seconds` (entero, 10–30) a su **AndroidManifest.xml**.
* **iOS:** agregue la clave `Pushwoosh_APPLICATION_EXIT_TIMEOUT_SECONDS` (Número, 10–30) al **Info.plist** de su aplicación.
**Atributos del evento**
* **screen_name** (string): la última pantalla activa cuando el usuario puso la aplicación en segundo plano.
* **session_duration** (integer): segundos desde que la aplicación se trajo por última vez al primer plano.
* **exit_intent_seconds** (integer): el tiempo de espera efectivo que transcurrió antes de que se activara el evento (10–30 s).
* **device_type** (integer): código del tipo de dispositivo. Consulte [registerDevice](/es/developer/api-reference/device-api#registerdevice) para más detalles.
* **application_version** (string): la versión de la aplicación.
**Comportamiento**
* El temporizador comienza cuando la aplicación se pone en segundo plano y se **cancela** si el usuario regresa antes de que expire el tiempo de espera.
* El nombre de la pantalla y la duración de la sesión se capturan en el momento de pasar a segundo plano, no cuando se activa el evento.
* El evento no se activa si la detección de intención de salida está deshabilitada (la clave de tiempo de espera es `0` o no está establecida).
**Casos de uso**
* Vuelva a involucrar a los usuarios que abandonaron un flujo de compra o registro. Active una notificación push o un correo electrónico con un recordatorio o descuento.
* Inicie un Customer Journey de recuperación para los usuarios que salen sin completar una acción clave (por ejemplo, dejar un carrito o detenerse a mitad de la incorporación).
* Identifique las pantallas con alta tasa de abandono filtrando las estadísticas de eventos por `screen_name`.
## Web
### PW_SiteOpened
_Solo para web_
El evento SiteOpened se activa cada vez que un usuario abre cualquiera de las páginas de su sitio web.
**Atributos del evento**
* **device_type** (integer): código del tipo de dispositivo. Consulte [registerDevice](/es/developer/api-reference/device-api#registerdevice) para más detalles.
* **title** (string): el título de la página visitada.
* **url** (string): la URL de la página visitada.
**Casos de uso**
* Analice la distribución del tráfico de su sitio y compare el número de veces que los usuarios abren páginas específicas del sitio. Para ello, filtre las estadísticas del Evento por sus atributos.
* Haga un seguimiento de la visita de un usuario al sitio web con una comunicación relevante. Cree un journey que comience con el evento SiteOpened configurado para un atributo `title` o `url` específico.
## Comercio
### PW_InAppPurchase
_Solo para aplicaciones móviles_
El evento InAppPurchase se activa cada vez que un usuario compra un artículo in-app en su aplicación. Los ejemplos incluyen suscripciones de pago, elementos de mecánica de juego, moneda in-app, etc.
Para implementar el evento de Compra In-App:
* **iOS:** establezca el parámetro `Pushwoosh_PURCHASE_TRACKING_ENABLED` del SDK de Pushwoosh para iOS en `yes`.
* **Android:** configure el envío de información de compra a Pushwoosh [usando esta guía](/es/developer/pushwoosh-sdk/android-sdk/customizing-android-sdk-50#in-app-purchase-tracking).
**Atributos del evento**
* **productIdentifier** (string): obtenido de la App Store.
* **quantity** (integer): el número de artículos comprados.
* **transactionDate** (string): fecha de la compra.
* **status** (string): estado de la compra.
**Casos de uso**
* Recopile estadísticas de compras in-app.
* Ejecute promociones y haga un seguimiento de su éxito. Establezca el evento Esperar Disparador después del mensaje de la promoción.
## Notificaciones push
### PW_NotificationSend
_Solo para móvil y web_
Este evento se activa una vez que se envía un mensaje de Pushwoosh al dispositivo de un usuario.
**Atributos del evento**
* **message_id** (string)
* **message_code** (string)
* **campaign_id** (string)
**Casos de uso**
* Rastree si se envía un mensaje, independientemente del canal utilizado.
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios basados en el número de mensajes enviados.
* Vea todos los mensajes enviados a un usuario en el [historial de Eventos](/es/product/audience-data-and-segmentation/user-explorer/#events-history) y analice el comportamiento posterior del usuario.
### PW_NotificationOpen
_Solo para móvil y web_
Este evento se activa cada vez que un usuario abre una notificación push enviada con Pushwoosh.
**Casos de uso**
* Configure el [momento óptimo para enviar un push](/es/product/messaging-channels/push-notifications/send-push-notifications/one-time-push#optimal-time-paid-subscription-required).
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) basados en el rendimiento de las notificaciones dentro de un período de tiempo específico.
## Correo electrónico
### PW_EmailSent
_Solo para correo electrónico_
Este evento se activa una vez que se envía un correo electrónico al proveedor de correo electrónico. Verifique **status_code** para el resultado.
**Atributos del evento**
* **message_id** (string): el ID del mensaje.
* **message_code** (string): el identificador único del mensaje de correo electrónico específico.
* **status_code** (integer): el código de estado de entrega devuelto por el proveedor de correo electrónico para este intento de envío.
* **campaign_id** (string): el ID de la campaña. Se incluye solo si el correo electrónico se envió como parte de una campaña.
* **campaign_code** (string): el código único de la campaña. Se incluye cuando el envío es parte de una campaña y la búsqueda de la campaña tiene éxito. **campaign_code** puede faltar incluso cuando **campaign_id** está presente.
**Casos de uso**
* Rastree los resultados del envío usando **status_code**, por separado de si el correo electrónico fue abierto o se hizo clic en él más tarde.
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios basados en el número de correos electrónicos enviados.
* Vea todos los correos electrónicos enviados a un usuario en el [historial de Eventos](/es/product/audience-data-and-segmentation/user-explorer/#events-history) y analice el comportamiento posterior del usuario.
### PW_EmailOpen
_Solo para correo electrónico_
Este evento se activa cuando un usuario abre un correo electrónico enviado a través de Pushwoosh.
**Atributos del evento**
* **campaign_code** (string): el código único de la campaña asociada con el correo electrónico.
* **campaign_id** (string): el ID de la campaña.
* **message_code** (string): el identificador único del mensaje de correo electrónico específico.
* **message_id** (string): el ID del mensaje.
* **opened_by** (string): quién o qué activó la apertura: `user` para una apertura genuina por parte del destinatario, o `ampp` para una apertura automatizada activada por la [Protección de Privacidad de Mail de Apple](/es/product/statistics-and-analytics/messaging-statistics/email-statistics#what-each-step-includes) que precarga el píxel de seguimiento.
**Casos de uso**
* Rastree las aperturas de correos electrónicos para identificar a los usuarios que interactúan activamente con sus correos electrónicos. Use estos datos para crear campañas de seguimiento, como enviar códigos de descuento a los usuarios que abren correos electrónicos promocionales.
* Si los usuarios abren un correo electrónico pero no completan la acción deseada (por ejemplo, realizar una compra), puede activar correos electrónicos de seguimiento con recordatorios u ofertas personalizadas.
* Analice las tasas de apertura en todas las campañas para refinar sus líneas de asunto y estrategias de tiempo de correo electrónico para campañas como lanzamientos de productos o promociones de temporada.
* Cree un [segmento](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) basado en **PW_EmailOpen** con **opened_by** igual a `user` para dirigirse a los destinatarios que abrieron el correo electrónico, excluyendo las aperturas activadas por AMPP.
### PW_EmailLinkClicked
_Solo para correo electrónico_
Este evento se activa cada vez que un usuario hace clic en un enlace en un correo electrónico.
**Atributos del evento**
* **message_id** (string)
* **message_code** (string)
* **campaign_id** (string)
* **redirect_link** (string)
* **original_link** (string)
**Casos de uso**
* Ejecute campañas dirigidas a usuarios que hacen clic en un enlace específico en un correo electrónico.
* Envíe otro mensaje a los usuarios que ignoraron el enlace en el primer correo electrónico para animarlos a hacer clic en él (o tomar otra acción).
### PW_EmailSubscribed
_Solo para correo electrónico_
Este evento se activa cuando un usuario se suscribe a una o más categorías de correo electrónico — desde un envío de un [centro de preferencias](/es/product/messaging-channels/emails/email-preferences/) o un enlace para volver a suscribirse, y también en la suscripción automática cuando un nuevo dispositivo de correo electrónico se registra por primera vez.
**Atributos del evento**
* **message_id** (string): el ID del mensaje que activó la suscripción, si corresponde.
* **campaign_id** (string): el ID de la campaña asociada, si corresponde.
* **message_code** (string): el identificador único del mensaje específico, si corresponde.
* **categories** (array de strings): los nombres de las categorías de correo electrónico a las que el usuario se suscribió; se omite si no aplica ninguna (por ejemplo, registro sin categorías suscritas automáticamente).
* **resubscribe** (boolean): `true` para cualquier envío desde el centro de preferencias o el enlace para volver a suscribirse — incluida la primera suscripción de un usuario realizada allí; se omite para la suscripción automática en el registro del dispositivo.
**Casos de uso**
* Use **resubscribe** para aislar las suscripciones impulsadas por el centro de preferencias de la suscripción automática en el registro.
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios suscritos a una categoría específica.
### PW_EmailUnsubscribed
_Solo para correo electrónico_
Este evento se activa cuando un usuario se da de baja de una o más categorías de correo electrónico, y también en una exclusión total de todos los correos electrónicos de marketing (etiqueta **Unsubscribed Emails**) — en ese caso, **categories** se omite. Si un usuario se da de baja de varias categorías a la vez, **categories** las enumera todas.
**Atributos del evento**
* **message_id** (string): el ID del mensaje del que el usuario se dio de baja, si corresponde.
* **campaign_id** (string): el ID de la campaña asociada, si corresponde.
* **message_code** (string): el identificador único del mensaje específico, si corresponde.
* **categories** (array de strings): los nombres de las categorías de correo electrónico de las que el usuario se dio de baja; se omite en una exclusión total.
**Casos de uso**
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios que se dieron de baja de una categoría específica para excluirlos de futuras campañas para esa categoría.
* Active un journey de recuperación para los usuarios que se dan de baja de una categoría.
## Mensajes in-app
### PW_InAppShown
_Solo para aplicaciones móviles_
Este evento se activa cuando se muestra un mensaje in-app al usuario.
**Atributos del evento**
* **message_code** (string): el identificador único del mensaje específico asociado con el in-app.
* **message_id** (integer): el ID del mensaje.
* **campaign_code** (string): el código único de la campaña asociada con el in-app.
* **campaign_id** (integer): el ID de la campaña que activó el in-app.
* **rich_media_code** (string): el identificador único del contenido de rich media mostrado en el in-app.
* **inapp_code** (string): el código único que identifica el mensaje in-app específico mostrado.
**Casos de uso**
* Rastree la frecuencia de las vistas de mensajes in-app para ajustar su estrategia de mensajería, como eliminar mensajes redundantes que podrían molestar a los usuarios.
* Use los datos de impresiones in-app para evaluar el alcance de las campañas promocionales como ventas flash o actualizaciones de suscripción.
* Si se muestra un mensaje in-app pero no se hace clic en él, puede activar una acción de seguimiento, como enviar una notificación push con contenido similar para reforzar el mensaje.
### PW_InAppClicked
_Solo para aplicaciones móviles_
Este evento se activa cuando un usuario interactúa con un mensaje in-app haciendo clic en él.
**Atributos del evento**
* **message_code** (string): el identificador único del mensaje específico asociado con el in-app.
* **message_id** (integer): el ID del mensaje.
* **campaign_code** (string): el código único de la campaña asociada con el in-app.
* **campaign_id** (integer): el ID de la campaña que activó el in-app.
* **rich_media_code** (string): el identificador único del contenido de rich media mostrado en el in-app (si corresponde).
* **inapp_code** (string): el código único que identifica el mensaje in-app específico en el que se hizo clic.
* **element_id** (string): el identificador del elemento específico dentro del mensaje in-app en el que se hizo clic (por ejemplo, un botón o enlace).
* **link** (string): la URL o el deep link asociado con el elemento en el que se hizo clic.
**Casos de uso**
* Analice el comportamiento de los clics para identificar con qué botones o enlaces interactúan más los usuarios y optimice los diseños futuros de los mensajes in-app. Por ejemplo, pruebe diferentes CTA en las campañas de actualización de suscripciones.
* Active acciones automatizadas basadas en los clics de los usuarios, como redirigir a los usuarios a una página de producto específica o enviar una notificación push.
## SMS
### PW_SMSSent
_Solo para SMS_
Este evento se activa una vez que se envía un SMS al proveedor de SMS. Verifique **status_code** para el resultado.
**Atributos del evento**
* **message_id** (string): el ID del mensaje.
* **message_code** (string): el identificador único del mensaje SMS específico.
* **status_code** (integer): el código de estado de entrega devuelto por el proveedor de SMS para este intento de envío. Úselo para distinguir el éxito del fracaso.
* **campaign_id** (string): el ID de la campaña. Se incluye solo si el SMS se envió como parte de una campaña.
* **campaign_code** (string): el código único de la campaña. Se incluye cuando el envío es parte de una campaña y la búsqueda de la campaña tiene éxito. **campaign_code** puede faltar incluso cuando **campaign_id** está presente.
**Casos de uso**
* Rastree los resultados del envío usando **status_code**, independientemente del canal utilizado en otras partes del mismo journey.
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios basados en el número de mensajes SMS enviados.
* Vea todos los mensajes SMS enviados a un usuario en el [historial de Eventos](/es/product/audience-data-and-segmentation/user-explorer/#events-history) y analice el comportamiento posterior del usuario.
## WhatsApp
### PW_WhatsAppSent
_Solo para WhatsApp_
Este evento se activa una vez que se envía un mensaje de WhatsApp al proveedor de WhatsApp. Verifique **status_code** para el resultado.
**Atributos del evento**
* **message_id** (string): el ID del mensaje.
* **message_code** (string): el identificador único del mensaje de WhatsApp específico.
* **status_code** (integer): el código de estado de entrega devuelto por el proveedor de WhatsApp para este intento de envío. Úselo para distinguir el éxito del fracaso.
* **campaign_id** (string): el ID de la campaña. Se incluye solo si el mensaje de WhatsApp se envió como parte de una campaña.
* **campaign_code** (string): el código único de la campaña. Se incluye cuando el envío es parte de una campaña y la búsqueda de la campaña tiene éxito. **campaign_code** puede faltar incluso cuando **campaign_id** está presente.
**Casos de uso**
* Rastree los resultados del envío usando **status_code**, por separado del estado de entrega o lectura.
* Cree [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-events) de usuarios basados en el número de mensajes de WhatsApp enviados.
* Vea todos los mensajes de WhatsApp enviados a un usuario en el [historial de Eventos](/es/product/audience-data-and-segmentation/user-explorer/#events-history) y analice el comportamiento posterior del usuario.
### PW_WhatsAppReceived
_Solo para WhatsApp_
Este evento se activa cuando se recibe un mensaje de WhatsApp a través del sistema.
**Atributos del evento**
* **message** (string): el contenido del mensaje recibido. Para mensajes de ubicación, contiene las coordenadas en formato `"latitud,longitud"` (por ejemplo, `"55.751244,37.618423"`).
* **latitude** (number): la latitud de la ubicación compartida. Se incluye solo cuando el usuario comparte su ubicación actual.
* **longitude** (number): la longitud de la ubicación compartida. Se incluye solo cuando el usuario comparte su ubicación actual.
Estos atributos se incluyen solo si el proveedor de WhatsApp los envía, en el primer mensaje de una conversación de Click-to-WhatsApp:
* **ctwa_clid** (string): el ID de clic del anuncio de Click-to-WhatsApp que inició la conversación. Úselo para la atribución de conversiones — cada valor es único por clic, por lo que no es útil para la segmentación.
* **referral_source_id** (string): el ID del anuncio o publicación que inició la conversación. Cuando la fuente es un anuncio, este es el mismo ID de anuncio que se muestra en el Administrador de anuncios de Meta; las publicaciones no se enumeran allí.
* **referral_source_type** (string): el tipo de la fuente de referencia, como un anuncio o una publicación.
* **referral_source_url** (string): la URL del anuncio o publicación que inició la conversación.
* **referral_headline** (string): el texto del titular del anuncio.
* **referral_body** (string): el texto del cuerpo del anuncio.
**Casos de uso**
* Automatice acciones de seguimiento en respuesta a los mensajes de WhatsApp entrantes (como iniciar un Customer Journey o rastrear eventos de participación del usuario).
* Segmente a los usuarios según sus interacciones con los mensajes de WhatsApp para permitir mensajes dirigidos o campañas personalizadas.
* Use los atributos `latitude` y `longitude` para activar journeys basados en la ubicación cuando un usuario comparte su ubicación.
* Use los atributos `ctwa_clid` y `referral_*` para atribuir una conversación al anuncio específico de Click-to-WhatsApp que la inició.
* Use las etiquetas de dispositivo [`WhatsApp Ad Click ID` y `WhatsApp Ad Click Date`](/es/product/audience-data-and-segmentation/user-data-tags/tags/#default-tags), que persisten más allá de la conversación, para crear [Segmentos](/es/product/audience-data-and-segmentation/segmentation/create-segments/by-tags) de usuarios que hicieron clic en un anuncio y luego se convirtieron.