Integración con Segment

Se necesita ayuda del desarrollador

Necesitará la ayuda de su equipo de desarrollo para configurar la integración. Por favor, comparta esta guía con ellos.

Segment es una plataforma de datos de clientes que simplifica la recopilación de datos de usuarios y le ayuda a aprovecharlos de manera efectiva. Si almacena los datos de sus clientes en Segment, puede configurar la integración con Pushwoosh en solo unos pocos clics.

Una vez que la integración esté configurada, Segment enviará los siguientes datos a Pushwoosh:

• Atributos de usuario: nombre, dispositivo, preferencias, ubicación, comportamiento, etc. Pushwoosh guardará estos datos como Tags y sus valores para cada usuario.
• Eventos: cada Evento de Segment se transferirá a Pushwoosh y se guardará como un Evento de Pushwoosh con el mismo nombre. Pushwoosh también obtendrá información sobre qué eventos ha activado cada usuario.

Usando los datos de Segment, puede hacer un seguimiento de su audiencia con comunicaciones fluidas en Pushwoosh. A continuación se presentan dos ejemplos de cómo aprovechar el poder de ambas plataformas:

1. Cree campañas dirigidas basadas en datos de comportamiento del usuario. Utilice los datos de Eventos de Segment para construir segmentos de usuarios precisos en Pushwoosh basados en el comportamiento específico del usuario.

Por ejemplo, Segment envía datos sobre el Evento SubscribedToOffers a Pushwoosh. Puede construir un segmento de usuarios en Pushwoosh que consista en usuarios que se han suscrito a ofertas especiales:

Luego, puede crear customer journeys atractivos con mensajes promocionales y descuentos para los usuarios que se suscribieron a sus ofertas:

2. Personalice los mensajes basados en los atributos del usuario de Segment. Puede aprovechar los atributos de usuario obtenidos de Segment para modificar el contenido de sus notificaciones push, mensajes in-app y correos electrónicos. Esto le permitirá configurar comunicaciones relevantes y de alta conversión.

Por ejemplo, Segment envía los valores del atributo searched_product a Pushwoosh. Puede crear un preset de push que ofrezca un descuento en los productos de una categoría que un usuario ha buscado previamente:

Cada usuario recibirá un push ofreciendo un descuento en la categoría de producto exacta que navegó anteriormente. Por ejemplo, aquellos que buscaron zapatillas deportivas verán este mensaje:

Resumen de la integración

Tipo de integración

• Destino: Los datos se envían desde Segment a Pushwoosh.
• Fuente: Los datos se envían desde Pushwoosh a Segment.

Prerrequisitos

Cuentas de pago tanto en Pushwoosh como en Segment

Entidades sincronizadas

Fuente

• Eventos de estadísticas de push, email y SMS

Destino

• Dispositivos
• Tags
• Eventos
• Eliminación de usuarios

Casos de uso

Seguimiento de notificaciones

Envíe notificaciones push y haga un seguimiento de su estado, incluyendo si se enviaron y entregaron con éxito.

Análisis de eventos

Analice los eventos activados por el usuario, como notificaciones push o entregas de correo electrónico, y asegúrese de que estos eventos se registren con precisión en Segment.

Gestión de usuarios

Registre y gestione la información del usuario, incluyendo el etiquetado de usuarios con atributos relevantes o la eliminación de usuarios cuando sea necesario.

Configuración de la integración

Nota

Antes de configurar la integración con Segment, asegúrese de integrar el SDK de Pushwoosh.

Configuración de un Destino

1. En la interfaz de Segment, navegue a Conexiones → Destinos y haga clic en Añadir Destino.

2. Busque Pushwoosh y selecciónelo.

3. Elija las Fuentes que desea conectar al Destino.

4. Vaya a la configuración del Destino:

5. Ingrese la clave de API de Pushwoosh y el código de aplicación. Asegúrese de que el interruptor Habilitar Destino esté activado. Después de eso, haga clic en Guardar Cambios.

¿Dónde puedo encontrar la clave de API y el código de aplicación?

Puede encontrar la clave de API en la sección Configuración → Acceso a la API:

El código de aplicación se puede encontrar en la esquina superior izquierda de la interfaz de Pushwoosh, justo debajo del nombre del proyecto:

6. Vaya a la pestaña Mapeos y asegúrese de que las opciones Crear o Actualizar Perfil de Usuario y Rastrear Eventos estén habilitadas:

Es importante verificar el mapeo de los campos de eventos de su fuente a Pushwoosh como destino para garantizar que sus eventos se procesen correctamente.

El campo device_platform acepta ios, android o web. Pushwoosh omite los eventos con cualquier otro valor. Pushwoosh también rechaza un evento que no tiene ni userId ni deviceId.

Para asegurarse de que su mapeo esté configurado correctamente, vaya a Pushwoosh como Destino > Configuración.

Luego, seleccione la pestaña Mapeo y haga clic en Editar Mapeo para el método Rastrear Eventos.

A continuación, asegúrese de que el mapeo de sus eventos a los eventos enviados a Pushwoosh sea correcto, y que los campos Plataforma del Dispositivo e ID de Usuario Externo (o ID de Dispositivo) coincidan correctamente.

Su evento puede diferir del ejemplo proporcionado anteriormente. Sin embargo, la clave es hacer coincidir la transferencia de datos para la plataforma y el dispositivo para el evento enviado a Pushwoosh.

Si la integración está configurada correctamente, Pushwoosh comenzará a recibir Eventos y atributos de usuario de Segment. Basándose en estos datos, puede crear customer journeys altamente dirigidos y personalizar sus notificaciones push, mensajes in-app y correos electrónicos.

Qué hace Pushwoosh con los datos de Segment

• Create or Update User Profile: Pushwoosh guarda los atributos del usuario (traits) como etiquetas y crea automáticamente las etiquetas que faltan.
  • Si la solicitud incluye un email, Pushwoosh registra un dispositivo de email para el usuario y guarda los atributos en él.
  • Para un dispositivo push, la solicitud necesita un token de dispositivo, un ID de dispositivo y un device_platform con el valor ios, android o web. Sin ellos, los atributos no se guardan en un dispositivo push.
  • Los atributos con el mismo nombre que las etiquetas predeterminadas de Pushwoosh, como Language, Country o Timezone, se ignoran, al igual que los atributos cuyo valor es un objeto.
• Track Events: Pushwoosh registra cada evento con su nombre de Segment y crea automáticamente los eventos y atributos que faltan.
• Eliminación de usuarios: Pushwoosh elimina todos los dispositivos del usuario con el ID de usuario externo indicado (external_id). El campo external_id es obligatorio. Una solicitud sin él recibe una respuesta 400 y no elimina nada.

Si Pushwoosh no puede procesar eventos temporalmente, responde con un estado 503 para que Segment pueda reintentar la entrega. Los eventos que Pushwoosh rechaza por su contenido, como un device_platform no compatible o la falta de un ID de usuario y un ID de dispositivo, reciben una respuesta 200 y no se reintentan.

Configuración de una Fuente

1. Desde la página del catálogo de Fuentes de su espacio de trabajo, haga clic en Añadir Fuente.
2. Busque “Pushwoosh” en el Catálogo de Fuentes, seleccione Pushwoosh y haga clic en Añadir Fuente.
3. En la siguiente pantalla, dé un nombre a la Fuente y configure cualquier otro ajuste.

Nota

El nombre se utiliza como una etiqueta en la aplicación de Segment, y Segment crea un nombre de esquema relacionado en su almacén de datos. El nombre puede ser cualquier cosa, pero Pushwoosh recomienda usar algo que refleje la fuente en sí y distinga entre sus entornos (Por ejemplo: Pushwoosh_Prod, Pushwoosh_Staging, Pushwoosh_Dev).

4. Haga clic en Añadir Fuente para guardar su configuración.
5. Copie la clave de escritura (Write key) de la interfaz de usuario de Segment.
6. Inicie sesión en su cuenta de Pushwoosh y seleccione la Aplicación que desea conectar.
7. Navegue a Configuración > Integración con terceros > Segment, haga clic en el botón Configurar e ingrese su clave de escritura (Write key) de su espacio de trabajo de Segment.
8. En Eventos, seleccione los eventos que desea exportar y luego haga clic en Aplicar. Pushwoosh exporta solo los eventos seleccionados, por lo que la integración no se puede guardar sin seleccionar al menos uno.

Flujo (Stream)

Pushwoosh utiliza el componente de Fuente de flujo de Segment para enviar datos de eventos de Segment. Utiliza un método de seguimiento del lado del servidor para enviar datos a Segment. Estos eventos están disponibles en cualquier destino que acepte eventos del lado del servidor y están disponibles en un esquema en su almacén de datos.

Por defecto, Pushwoosh pasa el ID de Usuario de Pushwoosh como la propiedad userId de Segment. Si no hay un ID de Usuario asociado, Pushwoosh pasará el HWID como el anonymousId de Segment.

Eventos

La siguiente tabla enumera los eventos que Pushwoosh envía a Segment. Estos eventos aparecen como tablas en su almacén de datos y como eventos regulares en otros Destinos.

Nombre del Evento	Descripción
Email Sent	Correo electrónico enviado con éxito
Push Sent	Notificación push enviada con éxito
SMS Sent	SMS enviado al destinatario
Push Opened	Se abrió la notificación push
Email Opened	Se abrió la notificación por correo electrónico
Email Delivered	Correo electrónico entregado con éxito
Push Delivered	Notificación push entregada con éxito
SMS Delivered	SMS entregado con éxito
SMS Not Delivered	Falló la entrega del SMS
Email Bounced	Correo electrónico devuelto al remitente debido a un error permanente
Email Unsubscribed	Se hizo clic en el enlace para cancelar la suscripción del correo electrónico

Propiedades del Evento

La siguiente tabla enumera las propiedades incluidas en los eventos mencionados anteriormente.

Nombre de la Propiedad	Descripción
message_type	Canal del mensaje: push, email o sms. Se omite si el canal es desconocido
campaign_code	Código de la campaña a la que pertenece el mensaje. Solo está presente en los mensajes enviados desde una campaña
device_type	Código de plataforma de Pushwoosh del dispositivo, un número. Consulte los valores de device_type en /registerDevice

Añadir Destinos

Ahora que su Fuente está configurada, puede conectarla con Destinos.

Inicie sesión en sus herramientas posteriores y verifique que sus eventos aparezcan como se esperaba y que contengan todas las propiedades que espera. Si sus eventos y propiedades no aparecen, verifique la Entrega de Eventos y consulte la documentación de Destinos para cada herramienta para solucionar problemas.

Si hay algún problema con cómo llegan los eventos a Segment, contacte a nuestro equipo de soporte.

Cómo funciona la integración

1. Inicio de la notificación push: Un cliente inicia el proceso iniciando una notificación push a través de la interfaz de Pushwoosh.
2. Producción de eventos: El backend de Pushwoosh procesa la solicitud de notificación push y genera un evento. Este evento se envía a un tema de Kafka llamado channels-tracking-log gestionado por Pushwoosh.
3. Consumo de eventos: El servicio de Integración de Segment escucha continuamente el tema de Kafka channels-tracking-log y consume los eventos a medida que llegan.
4. Procesamiento de eventos: Los eventos consumidos son procesados por el servicio de Integración de Segment, que los transforma en Eventos de Seguimiento de Segment.
5. Transmisión de eventos: Los Eventos de Seguimiento de Segment procesados se envían al backend de Segment para su posterior manejo y análisis.

¿Cómo saber si la integración está funcionando?

Destino

track-user

Vaya a su cuenta de Pushwoosh > Su Aplicación Conectada > Audiencia > User Explorer. Encuentre su usuario/dispositivo y verifique las etiquetas que Segment envió.

post-event

Vaya a su cuenta de Pushwoosh > Su Aplicación Conectada > Audiencia > Eventos. Seleccione el evento, haga clic en el menú de tres puntos y elija Estadísticas del Evento. Asegúrese de que el evento se cuente.

delete-user

Vaya a su cuenta de PW > Su Aplicación Conectada > Audiencia > User Explorer. Asegúrese de que el usuario/dispositivo no exista.

Fuente

Utilice el depurador de Fuentes para detectar los eventos que se enviaron desde Pushwoosh a Segment.

Solución de problemas

Verificar el estado de la integración

Para solucionar problemas con la integración de Pushwoosh, comience por verificar lo siguiente:

Destino

• Track-User: Verifique la información del usuario/dispositivo y las etiquetas en Pushwoosh en Audiencia > User Explorer.
• Post-Event: Asegúrese de que el evento se cuente en Pushwoosh verificando las estadísticas del evento.
• Delete-User: Confirme que el usuario/dispositivo ya no existe en Pushwoosh.

Fuente

Utilice el depurador de fuentes en Segment Debugger para verificar si los eventos de Pushwoosh se envían correctamente a Segment.

Los usuarios no se eliminan

Compruebe que la solicitud de eliminación incluya el campo external_id con el ID de usuario. Sin él, Pushwoosh responde con un estado 400 y no elimina nada.

Discrepancia de eventos

Si los eventos no aparecen correctamente en Segment, asegúrese de que los eventos de Pushwoosh estén correctamente mapeados a los Eventos de Seguimiento de Segment según las reglas de mapeo proporcionadas.

Problemas de autenticación

Verifique que se utilicen los tokens de autenticación o las claves de API correctos en las solicitudes a Pushwoosh y Segment.

Problemas de flujo de datos

Confirme que el flujo de datos entre Pushwoosh y Segment no se interrumpe y que los temas de Kafka se están monitoreando correctamente.

Preguntas frecuentes

¿Qué tipos de eventos se envían a Segment desde Pushwoosh?

Pushwoosh envía los eventos que usted selecciona en la configuración de la integración: Push Sent, Push Delivered, Push Opened, Email Sent, Email Delivered, Email Opened, Email Bounced, Email Unsubscribed, SMS Sent, SMS Delivered y SMS Not Delivered.

¿Cómo puedo verificar que los eventos se envían correctamente a Segment?

Utilice el depurador de fuentes de Segment para verificar los eventos enviados desde Pushwoosh y revise las estadísticas de eventos en su cuenta de Pushwoosh para asegurarse de que se cuenten correctamente.

¿Qué debo hacer si encuentro problemas con la integración?

Verifique el estado de la integración comprobando la información del usuario/dispositivo, el recuento de eventos y la eliminación de usuarios en Pushwoosh. Además, asegúrese de que se utilicen los tokens de autenticación correctos y que el flujo de datos no se interrumpa.

¿Cómo se maneja la información del usuario y del dispositivo en la integración?

Pushwoosh registra o actualiza el dispositivo y guarda los atributos del usuario (traits) como etiquetas. Las etiquetas que faltan se crean automáticamente. Los atributos con el mismo nombre que las etiquetas predeterminadas de Pushwoosh, como Language o Country, se ignoran.

¿Dónde puedo encontrar documentación detallada sobre la integración?

La documentación detallada está disponible en los manuales de integración de Segment y Pushwoosh, así como en su respectiva documentación de la API.