Eventos predeterminados

Nota

Disponible a partir del SDK 5.2.2

¿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 inmediata para las versiones actualizadas del SDK. No necesitan configuraciones adicionales, excepto PW_InAppPurchase (consulte los detalles a continuación).

Para encontrar y activar los eventos predeterminados disponibles en Pushwoosh, siga estos pasos:

1. Vaya a la pestaña Events dentro de la sección Audience.
2. Haga clic en Create Event.
3. Seleccione Default Event en el menú desplegable.
4. En la ventana emergente, elija el evento deseado y haga clic en Activate.

Una vez activados, los eventos predeterminados se pueden utilizar en la mensajería basada en el comportamiento. Por ejemplo, úselos como una Entrada basada en disparadores en Customer Journey o como un disparador para mensajes In-App.

Consejo

Para ver cómo puede usar los eventos predeterminados para crear una campaña de marketing en Pushwoosh y convertir automáticamente a los usuarios gratuitos en clientes de pago, vea este tutorial:

Video de YouTube: Cómo puede usar los eventos predeterminados para crear una campaña de marketing en Pushwoosh y convertir automáticamente a los usuarios gratuitos en clientes de pago

PW_DeviceRegistered

Este evento se dispara solo una vez por cada dispositivo, en el primer lanzamiento de la aplicación y la inicialización del SDK. Como su nombre indica, este evento rastrea el registro del dispositivo en su aplicación.

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 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 mensajes In-App activados por el evento DeviceRegistered.

PW_DeviceUnregistered

Este evento se dispara cuando la aplicación se desinstala o un usuario opta por no recibir correos electrónicos o notificaciones push.

Atributos del evento

• message_id (cadena)
• message_code (cadena)
• campaign_id (cadena)

Casos de uso

• Retenga a los usuarios cuando decidan dejar de usar su aplicación. Por ejemplo, puede enviar un correo electrónico 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 o mostrar un mensaje In-App animándolos a usar la aplicación más a menudo.

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 (código de tipo de dispositivo entero, consulte registerDevice para más detalles)
• application_version

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 dispara cada vez que un usuario ve una pantalla específica en su aplicación móvil.

Atributos del evento

• application_version
• device_type (código de tipo de dispositivo entero, consulte registerDevice para más detalles)
• screen_name (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: realice una prueba A/B/n de dos o varias versiones de su oferta, espere a que ocurra el evento ScreenOpen y luego vea qué contenido ha tenido mejor rendimiento.
• Descubra 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 dispara cuando un usuario minimiza (pero no fuerza la detención) la aplicación en su dispositivo.

Atributos del evento

• device_type (código de tipo de dispositivo entero, consulte registerDevice para más detalles)
• application_version

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

Se necesita asistencia del desarrollador

Para comenzar a recibir eventos PW_UserIdle, necesitará la ayuda de su equipo de desarrolladores. Comparta las notas de configuración del SDK a continuación.

Este evento se dispara 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 dispara mientras el usuario todavía está en la aplicación, capturando 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 mensaje In-App oportuno, ofrecer asistencia o guiar 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:

• Para iOS:
  • agregue la clave Pushwoosh_IDLE_TIMEOUT_SECONDS (Número, mínimo 30) al Info.plist de su aplicación.
• Para Android:
  • agregue los metadatos com.pushwoosh.idle_timeout_seconds (entero, mínimo 30) a su AndroidManifest.xml.

Atributos del evento

• screen_name (cadena) — la pantalla donde el usuario quedó inactivo. Formateado como ActivityName/FragmentName en Android y ParentVC/ChildVC en iOS cuando la pantalla actual está anidada; de lo contrario, el nombre de la actividad o del controlador de vista.
• idle_seconds (entero) — el tiempo de espera de inactividad configurado que transcurrió.
• session_duration (entero) — segundos desde que la aplicación se trajo por última vez al primer plano.
• device_type (código de tipo de dispositivo entero, consulte registerDevice para más detalles)
• application_version (cadena)

Comportamiento

• Se dispara 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 detiene automáticamente mientras el teclado virtual está abierto, mientras hay un diálogo modal o un aviso del sistema 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 contextual cuando los usuarios permanezcan en una pantalla de alta intención (carrito, precios, pago) sin realizar ninguna acción.
• Muestre una pista o un tutorial cuando los usuarios se detengan en un paso de la 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

Se necesita asistencia del desarrollador

Para comenzar a recibir eventos PW_ApplicationExit, necesitará la ayuda de su equipo de desarrolladores. Comparta las notas de configuración del SDK a continuación.

Este evento se dispara 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 dispara inmediatamente cuando el usuario se va, PW_ApplicationExit se dispara solo después de que ha transcurrido el retraso configurado, confirmando que el usuario realmente ha abandonado 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:

• Para Android:
  • agregue los metadatos com.pushwoosh.exit_intent_timeout_seconds (entero, 10–30) a su AndroidManifest.xml.
• Para 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 (cadena) — la última pantalla activa cuando el usuario puso la aplicación en segundo plano.
• session_duration (entero) — segundos desde que la aplicación se trajo por última vez al primer plano.
• exit_intent_seconds (entero) — el tiempo de espera efectivo que transcurrió antes de que se disparara el evento (10–30 s).
• device_type (código de tipo de dispositivo entero, consulte registerDevice para más detalles)
• application_version (cadena)

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 dispara el evento.
• El evento no se dispara 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 (p. ej., abandonar 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.

PW_SiteOpened

Solo para plataformas web

El evento SiteOpened se dispara cada vez que un usuario abre cualquiera de las páginas de su sitio web.

Atributos del evento

• device_type (código de tipo de dispositivo entero, consulte registerDevice para más detalles)
• title – el título de la página visitada
• url – 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: construya un journey que comience con el evento SiteOpened configurado para un atributo ‘title’ o ‘url’ específico.

PW_InAppPurchase

Solo para aplicaciones móviles

Se necesita asistencia del desarrollador

Para configurar el evento de compra In-App, necesitará la ayuda de su equipo de desarrolladores. Comparta la guía con ellos.

El evento InAppPurchase se dispara 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.

Nota

Tenga en cuenta que estos artículos deben especificarse en la página de la App Store de su aplicación.

Para implementar el evento de compra In-App:

• Para iOS:
  • active el evento PW_InAppPurchase en su Panel de Control;
  • establezca el parámetro Pushwoosh_PURCHASE_TRACKING_ENABLED del SDK de Pushwoosh para iOS en ‘yes’.
• Para Android:
  • active el evento PW_InAppPurchase en su Panel de Control;
  • configure el envío de información de compra a Pushwoosh usando esta guía.

Atributos del evento

• productIdentifier (obtenido de la App Store)
• quantity – el número de artículos comprados
• transactionDate – fecha de compra
• status – 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.

PW_NotificationOpen

Para plataformas móviles y web

Este evento se dispara cada vez que un usuario abre una notificación push enviada con Pushwoosh.

Casos de uso

• Configure la hora óptima para enviar un push.
• Cree Segmentos basados en el rendimiento de las notificaciones dentro de un período de tiempo específico.

PW_NotificationSend

Para plataformas móviles y web

Este evento se dispara una vez que se envía un mensaje de Pushwoosh al dispositivo de un usuario.

Atributos del evento

• message_id (cadena)
• message_code (cadena)
• campaign_id (cadena)

Casos de uso

• Rastree si se envía un mensaje, independientemente del canal utilizado.
• Cree Segmentos de usuarios basados en el número de mensajes enviados.
• Vea todos los mensajes enviados a un usuario en el historial de eventos y analice el comportamiento posterior del usuario.

PW_EmailLinkClicked

Solo para la plataforma de correo electrónico

Este evento se dispara cada vez que un usuario hace clic en un enlace de un correo electrónico.

Atributos del evento

• message_id (cadena)
• message_code (cadena)
• campaign_id (cadena)
• redirect_link (cadena)
• original_link (cadena)

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 a realizar otra acción).

PW_EmailOpen

Este evento se dispara cuando un usuario abre un correo electrónico enviado a través de Pushwoosh.

Atributos del evento

• campaign_code (cadena): El código único de la campaña asociada con el correo electrónico.
• campaign_id (cadena): El ID de la campaña.
• message_code (cadena): El identificador único del mensaje de correo electrónico específico.
• message_id (cadena): El ID del mensaje.

Casos de uso

• Rastree las aperturas de correos electrónicos para identificar a los usuarios que interactúan activamente con sus correos. Utilice estos datos para crear campañas de seguimiento, como enviar códigos de descuento a los usuarios que abren correos promocionales.
• Si los usuarios abren un correo electrónico pero no completan la acción deseada (p. ej., realizar una compra), puede activar correos 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 envío de correos para campañas como lanzamientos de productos o promociones de temporada.

PW_InAppShown

Este evento se dispara cuando se muestra un mensaje In-App al usuario.

Atributos del evento

• message_code (cadena): El identificador único del mensaje específico asociado con el In-App.
• message_id (entero): El ID del mensaje.
• campaign_code (cadena): El código único de la campaña asociada con el In-App.
• campaign_id (entero): El ID de la campaña que activó el In-App.
• rich_media_code (cadena): El identificador único del contenido rich media mostrado en el In-App.
• inapp_code (cadena): El código único que identifica el mensaje In-App específico mostrado.

Casos de uso

• Rastree la frecuencia de las visualizaciones de mensajes In-App para ajustar su estrategia de mensajería, como eliminar mensajes redundantes que podrían molestar a los usuarios.
• Utilice 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

Este evento se dispara cuando un usuario interactúa con un mensaje In-App haciendo clic en él.

Atributos del evento

• message_code (cadena): El identificador único del mensaje específico asociado con el In-App.
• message_id (entero): El ID del mensaje.
• campaign_code (cadena): El código único de la campaña asociada con el In-App.
• campaign_id (entero): El ID de la campaña que activó el In-App.
• rich_media_code (cadena): El identificador único del contenido rich media mostrado en el In-App (si corresponde).
• inapp_code (cadena): El código único que identifica el mensaje In-App específico en el que se hizo clic.
• element_id (cadena): El identificador del elemento específico dentro del mensaje In-App en el que se hizo clic (p. ej., un botón o enlace).
• link (cadena): 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.

PW_WhatsAppReceived

Este evento se dispara cuando se recibe un mensaje de WhatsApp a través del sistema.

Atributos del evento

• message (cadena): El contenido del mensaje recibido. Para mensajes de ubicación, contiene las coordenadas en formato "latitud,longitud" (p. ej., "55.751244,37.618423").
• latitude (número): La latitud de la ubicación compartida. Se incluye solo cuando el usuario comparte su ubicación actual.
• longitude (número): La longitud de la ubicación compartida. Se incluye solo cuando el usuario comparte su ubicación actual.

Casos de uso

• Automatice las 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 en función de 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.