Descripción general
La integración OneSignal + Segment te permite:
- Enviar características de usuario y eventos desde Segment a OneSignal para enriquecer perfiles de usuario, potenciar la segmentación y activar mensajería.
- Enviar eventos de entrega de mensajes y participación desde OneSignal a Segment para análisis centralizados y almacenamiento de datos.
Esta configuración bidireccional soporta todos los canales principales de OneSignal: Push, In-App, Email y SMS.
Requisitos
- Una Cuenta OneSignal Growth, Professional o Enterprise.
- Permisos de Administrador de Segment
- El Mobile SDK y/o Web SDK de OneSignal desde el cual quieres enviar datos. Las integraciones solo de Email o SMS no requieren el SDK.
- La Propiedad de OneSignal: External ID que se mapea al
userId de Segment.com.
Configuración
1. Configurar OneSignal
Usa una app existente o crea una nueva en el dashboard de OneSignal. Luego configura tus canales preferidos:
2. Conectar Segment a OneSignal
Dentro del Dashboard de OneSignal, navega a Data > Integrations y haz clic en Active dentro de la tarjeta Segment.com. Luego continúa con las opciones de configuración.
Entrada de datos
“Data In” a OneSignal te permite enviar segmentos de OneSignal, etiquetas y eventos personalizados desde tu cuenta de Segment.com a OneSignal. Haz clic en Authenticate bajo la sección Data In de la página de configuración de Segment.com en el Dashboard de OneSignal.
Los eventos personalizados están actualmente en beta.
Para solicitar acceso, contacta a [email protected] con:
- El nombre de tu empresa
- Tu ID de Organización de OneSignal
- El(los) App ID(s) que quieres habilitar
Una vez habilitado para rastrear eventos personalizados, la integración de Segment.com enviará tanto Etiquetas de Datos como Eventos, por lo que no necesitarás actualizar ninguna plantilla existente que haga referencia a etiquetas de datos.
Salida de datos
Habilitar “Data Out” a Segment.com sincroniza eventos de mensajes generados de vuelta a tu cuenta de Segment.com. Estos eventos de mensajes se generan al enviar mensajes a tus usuarios en la plataforma OneSignal. Más detalles sobre qué tipo de eventos se pueden generar, y las propiedades con las que se envían se pueden encontrar abajo.
Primero, necesitas agregar OneSignal como una fuente desde tu cuenta de Segment.com. Puedes hacer eso navegando al listado de Fuente OneSignal en el Catálogo de Conexiones de Segment.
Desde allí, puedes agregar tu token API de Segment.com en el Dashboard de OneSignal. Por favor navega a Data > Integrations > Segment en el Dashboard de OneSignal para agregar la clave API de Segment.
Después de configurar la clave API, asegúrate de verificar tu configuración de Política de Datos en Segment.com para determinar si necesitas enviar eventos al Endpoint de Residencia UE de Segment.
Una vez que todos esos ajustes estén completados, puedes seleccionar qué eventos quieres sincronizar con tu Cuenta de Segment dependiendo de qué canales utilizas con OneSignal.
3. Agregar destino OneSignal en Segment
Dentro de Segment.com Dashboard > Destinations deberías ver OneSignal. Si no, agrega OneSignal como un nuevo destino.
Habilita el Destino OneSignal, también deberías ver tu Clave API de OneSignal y App ID ya configurados.
Si la clave API y el App ID no están configurados, navega al dashboard de OneSignal, selecciona la App, y ve a Settings > Keys & IDs. Copia y pega el “App ID” y la “API key” en Segment.com.
Múltiples Fuentes de Segment.com
Si tienes múltiples fuentes, puedes utilizar la función Personas > Spaces de Segment para vincular múltiples fuentes a un destino.
4. Enviar datos desde Segment a OneSignal
OneSignal almacena registros a nivel de canal: Push/IAM, Email y SMS. Estos registros ya deben estar creados en OneSignal y también debes establecer el alias External ID en OneSignal para que coincida con el campo userID enviado por Segment.com.
Los registros que no tengan un mapeo Segment User ID <—> OneSignal External ID serán descartados.
Características o propiedades de usuario
Puedes agregar datos a través de cada punto de contacto del cliente en Segment y luego enviar estas propiedades de usuario en tiempo real a OneSignal como Etiquetas de Datos.
Nota: OneSignal no puede aceptar objetos anidados o arrays como propiedades de usuario.
Identify - Las características o propiedades de usuario enviadas usando la llamada Identify de Segment se almacenan como etiquetas de datos en OneSignal. Por ejemplo:
Track - Para eventos y propiedades asociadas enviadas usando la llamada Track de Segment, OneSignal almacenará todas las propiedades del evento como etiquetas de datos, pero descartará el nombre del evento al almacenar las etiquetas. Si quieres mantener los nombres de eventos en las etiquetas de datos, puedes agregar el nombre del evento a las propiedades antes de enviarlos a OneSignal. Por ejemplo:
let timestampInSeconds = Int(NSDate().timeIntervalSince1970).toString()//convertir a string ya que Segment agrega decimales al final
//el nombre se descartará y solo las propiedades se enviarán a OneSignal como etiqueta "last opened: timestampInSeconds"
analytics.track(
name: "iOS App Last Opened",
properties: ["last opened": timestampInSeconds]
)
Audiencia Personas y Rasgos Computados
Las Audiencias Personas aparecen automáticamente como un segmento en OneSignal.
Los rasgos computados se actualizan como Etiquetas de Datos en los registros de usuario de OneSignal.
Audiencia
Las audiencias enviadas usando la llamada Track de Segment crearán un segmento de OneSignal con el Nombre de Audiencia.
Las audiencias enviadas usando la llamada Identify de Segment:
- crearán un segmento de OneSignal con el Nombre de Audiencia
- agregarán etiquetas de datos (si hay propiedades adicionales en la llamada Identify) en todos los registros de usuario coincidentes.
Las llamadas Identify y Track se envían automáticamente a OneSignal cuando un usuario entra o sale de la Audiencia.
Rasgos Computados Los Rasgos Computados de Personas se almacenan como Etiquetas de Datos en los registros de usuario de OneSignal ya sea que se pasen a OneSignal como una llamada Identify o una llamada Track. Luego puedes usar estas etiquetas de datos para crear manualmente segmentos de OneSignal y automatizar tus flujos de trabajo de mensajería.
Eventos de Mensajes
Tipos de Eventos
Estos son los tipos de eventos de mensajes que OneSignal envía a Segment
| Tipo de MessageEvent | Descripción del Evento |
|---|
| Push Sent | Notificación push enviada exitosamente |
| Push Received | Notificación push recibida exitosamente |
| Push Clicked | Notificación push tocada en dispositivo |
| In-App Message Displayed | Mensaje In-App mostrado exitosamente en dispositivo |
| In-App Message Clicked | Mensaje In-App clicado en dispositivo |
| In-App Message Page Displayed | Página de Mensaje In-App mostrada |
| Email Sent | Email enviado exitosamente |
| Email Opened | Email abierto por destinatario |
| Email Unsubscribed | Email desuscrito por destinatario |
| Email Received | Email recibido por destinatario |
| Email Reported As Spam | Email reportado como spam por destinatario |
| Email Bounced | Email devuelto al remitente debido a error permanente |
| Email Failed | No se pudo entregar el email a la bandeja del destinatario |
| SMS Sent | SMS enviado a destinatario |
| SMS Delivered | SMS entregado exitosamente |
| SMS Failed | SMS falló al enviar |
Propiedades de Eventos
Estas son las propiedades que están presentes en eventos enviados desde OneSignal a Segment.com
| NOMBRE DE PROPIEDAD | DESCRIPCIÓN |
|---|
userId | El external_id asociado con el mensaje |
anonymousId | El subscription_id |
messageId | El identificador del mensaje discreto |
campaign_id | El mismo valor que messageId |
message_name | El nombre del mensaje |
message_title | El título del mensaje |
message_contents | Los contenidos del mensaje |
| |
subscription_type | El canal a través del cual se envió el mensaje |
template_id | La plantilla de mensaje usada |
subscription_id. | El identificador de dispositivo/email/sms establecido en OneSignal |
device_type | El tipo de dispositivo que recibió el mensaje |
language | El código de idioma de dos caracteres del dispositivo |
message_type | El tipo de mensaje enviado, push, in-app, email, SMS |
FAQ
¿Cómo podemos pasar eventos de Suscripción?
Los eventos de suscripción no se están enviando automáticamente actualmente. Esto se puede hacer con los Métodos de Observador de Suscripción del SDK de OneSignal. Consulta Rastreo de Suscripción para más detalles.
Gestión de Propiedades de Usuario Reservadas y Personalizadas de Segment en OneSignal
- Todas las características de usuario de Segment se envían a OneSignal como etiquetas de datos. El número de etiquetas de datos permitidas en OneSignal depende de tu plan de precios de OneSignal. Las etiquetas que excedan el número permitido serán descartadas.
- OneSignal siempre actualiza las propiedades firstName y lastName para usuarios coincidentes. Todas las demás características se agregan/actualizan por orden de llegada. Las etiquetas firstName y lastName se almacenan como “first_name” y “last_name”.
- Las propiedades de usuario enviadas a OneSignal con valores en blanco/nulos se eliminan del registro de usuario de OneSignal. Esto se hace para asegurar que estés dentro de tus límites de etiquetas de datos.
