Event Streams

​

Casos de uso comunes

1. Mapeo y personalización del recorrido del cliente: transmite eventos a un CRM o Plataforma de Datos de Clientes (CDP) para construir perfiles de clientes completos y adaptar campañas en varios puntos de contacto.
2. Análisis e informes: envía eventos de mensajes (por ejemplo, envíos, aperturas, clics) a un almacén de datos para analizar patrones de compromiso o tendencias a largo plazo en todos los canales.
3. Cumplimiento e informes regulatorios: transmite todos los datos de mensajes enviados a un almacén de datos para propósitos de auditoría y cumplimiento.
4. IA y modelos predictivos: envía datos de eventos de mensajes a modelos de IA o predictivos internos para crear cohortes de clientes completas y comprender riesgos de abandono, como cancelaciones de suscripción de email o descartes de mensajes, que pueden indicar un posible abandono.
5. Automatización de marketing: envía eventos de compromiso (como aperturas o clics de mensajes) a otras herramientas para activar automáticamente los siguientes pasos en el recorrido del usuario o actualizar perfiles de clientes y actividad reciente.
6. Fragmentación de datos: los datos valiosos de clientes a menudo residen en herramientas separadas (como plataformas de compromiso de clientes, CRMs, herramientas de análisis y almacenes de datos). La transmisión de eventos ayuda a centralizar estos datos, aumentando la visibilidad en datos valiosos de primera parte y permitiendo resultados de ingresos más rápidos.
7. Comunicación lenta entre sistemas: al enviar eventos de compromiso en vivo a otros sistemas, puedes activar acciones inmediatamente después de que ocurra un evento, en lugar de esperar horas o días por actualizaciones por lotes. Esto elimina la dependencia de importaciones manuales o sincronizaciones de datos.
8. Inflación de gastos y deuda técnica: en lugar de gestionar múltiples herramientas intermediarias, puedes conectar directamente OneSignal con tu almacén de datos. Esto reduce los costos de gestionar múltiples integraciones o pipelines de datos personalizados, disminuye la deuda técnica y preserva recursos técnicos valiosos para producto y marketing.

​

Cómo asociarte con tu equipo técnico

1. Explica los beneficios: comparte tu estrategia para usar estos datos y cómo pueden mejorar las campañas de marketing, personalizar experiencias de usuario, consolidar datos y reducir la deuda técnica.
2. Define el alcance: identifica dónde quieres que se envíen los datos, qué eventos quieres rastrear y el volumen de datos estimado. Esto ayudará a configurar el endpoint apropiado.
3. Proporciona documentación técnica: comparte la documentación técnica e instrucciones de configuración de OneSignal. Tu equipo de desarrollo necesitará configurar los endpoints receptores y el event stream en OneSignal, asegurando que los datos se enruten correctamente.
4. Discute el volumen y gestión de datos: confirma que tus sistemas pueden manejar flujos de datos en tiempo real. Se recomienda que el manejador de API registre eventos sin procesamiento adicional en línea para mantener tiempos de respuesta bajos.
5. Prueba y soluciona problemas: realiza pruebas para asegurar que todo funcione sin problemas antes de entrar en producción.

​

Configuración

​

Requisitos

• Una URL o dirección IP válida que apunte a tu servidor HTTP(S)
• Las URLs y direcciones IP deben ser enrutables públicamente
• Los dominios deben incluir un dominio de nivel superior reconocido (por ejemplo, “.com”, “.net”)

​

Selección de eventos

Activar Webhook

Selección de eventos

​

Filtros de event stream

Filtrado de eventos por plantilla

Copiando el Template ID de una plantilla

• Template – https://dashboard.onesignal.com/apps/{APP_ID}/templates/{TEMPLATE_ID}
• Push – https://dashboard.onesignal.com/apps/{APP_ID}/notifications/{MESSAGE_ID}
• Email – https://dashboard.onesignal.com/apps/{APP_ID}/email/{MESSAGE_ID}
• SMS – https://dashboard.onesignal.com/apps/{APP_ID}/sms/{MESSAGE_ID}

​

Configurar el Event Stream

​

Encabezados de autenticación

• Encabezado de autorización: Agrega un encabezado Authorization, donde YOUR_TOKEN es proporcionado por tu sistema o un tercero como:
  • Basic {{YOUR_TOKEN}}
  • Bearer {{YOUR_TOKEN}}
  • ApiKey {{YOUR_API_KEY}}
• Encabezados personalizados: También puedes agregar encabezados personalizados como:
  • X-API-Key: {{YOUR_API_KEY}}

​

Probando tu configuración

Configurar Webhook

​

Encabezados no permitidos

• content-length
• referer
• metadata-flavor
• x-google-metadata-request
• host
• x-onesignal*

​

Cuerpo

Opciones de cuerpo del Event Stream

Vista previa cURL del Event Stream

​

Personalización

​

Ejemplo de cuerpo

{
  "Event Data": {
    "event.kind": "{{ event.kind }}",
    "event.id": "{{ event.id }}",
    "event.timestamp": "{{ event.timestamp }}",
    "event.datetime": "{{ event.datetime }}",
    "event.app_id": "{{ event.app_id }}",
    "event.subscription_device_type": "{{ event.subscription_device_type }}",
    "event.subscription_id": "{{ event.subscription_id }}",
    "event.onesignal_id": "{{ event.onesignal_id }}",
    "event.external_id": "{{ event.external_id }}"
  },
  "Message Data": {
    "message.id": "{{ message.id }}",
    "message.name": "{{ message.name }}",
    "message.title": "{{ message.title.en }}",
    "message.contents": "{{ message.contents.en }}",
    "template_id": "{{ message.template_id }}",
    "message.template_id": "{{ message.template_id }}",
    "message.url": "{{ message.url }}",
    "message.app_url": "{{ message.app_url }}",
    "message.web_url": "{{ message.web_url }}"
  }
}

Cuerpo personalizado

​

Usando Sintaxis Liquid en JSON

• Cadenas → Deben envolverse en comillas.
• Números → No envolver en comillas.
• Objetos → No deben envolverse en comillas.

​

Cadenas

// Wrap string values in quotes
{
  "user_id": "{{ user.onesignal_id }}"
}

{
  "user_id": {{ user.onesignal_id }}
}

​

Números y Booleanos

// Don't wrap numbers or booleans in quotes
{
  "user_score": {{ user.tags.score }}
}

{
  "user_score": "{{ user.tags.score }}"
}

​

Objetos

// Don't wrap objects in quotes.
{
  "user_data": {{ user.tags }}
}

{
  "user_data": "{{ user.tags }}"
}

1. Usa verificaciones directas de idioma: Siempre verifica user.language directamente en los condicionales, no en variables como userLang, para mejor compatibilidad.
2. Comienza simple: Empieza con frases básicas, luego agrega complejidad gradualmente.
3. Evita el anidamiento excesivo: Mantén los condicionales planos para prevenir problemas de análisis.
4. Prueba la puntuación básica primero: Comienza con oraciones simples y puntuación antes de usar caracteres especiales.
5. Usa respaldos: Asegura un idioma predeterminado (por ejemplo, inglés) en caso de traducciones faltantes.
6. Apégate a claves estándar: Usa claves estándar de OneSignal como content/title/en para confiabilidad.

​

Resultados y depuración

Registros y métricas del Event Stream

​

Reintentos / Deshabilitación

​

Consejos para el éxito

• Normalmente querrás que los event streams se conecten a tus propios servidores, no a servicios de terceros.
  • Si bien no hay nada malo en conectarse directamente a un tercero, lo siguiente puede ser más difícil de gestionar: Será más desafiante configurar/depurar
• El volumen de solicitudes no se gestionará en OneSignal.
  • Los eventos de event stream se enviarán tan rápido como los usuarios alcancen los pasos en tu journey y esto podría abrumar otros servicios, alcanzar límites de tasa o aumentar TU factura inesperadamente. Esto es especialmente común cuando se intenta usar otro canal de mensajería para algo como SMS. La flexibilidad de los event streams significa que OneSignal no sabe qué estás tratando de lograr con ellos, por lo que es posible que desees crear un servicio simple propio que acepte las solicitudes de event stream y luego maneje correctamente los límites de conexión de terceros, límites de tasa y cola.
• Muchos servicios tienen APIs HTTP públicas, lo que significa que puedes conectarte a ellos con un event stream; busca su documentación de API y ejemplos de cómo hacer una solicitud HTTP para encontrar el lugar correcto para comenzar.

​

Limitaciones de datos de eventos de mensajes

​

Pruebas

La URL coincide con la "Your unique URL" de webhook.site

Eventos de mensajes push seleccionados, pero cualquiera puede usarse para pruebas.

Ejemplo usando webhook.site

• Host: la dirección IP de donde provino la solicitud. Consulta Descripción general de la API REST para una lista de IPs posibles.
• Request Content los datos enviados dentro del cuerpo del event stream.