Segment (Twilio)

Descripción general de la integración OneSignal Segment

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 support@onesignal.com 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.

Configuración de autenticación Data In

Una vez que hagas clic en Authenticate, se abrirá una página web de Segment.com y se te pedirá que inicies sesión en tu cuenta de Segment.com. Luego se te pedirá que configures un nuevo destino de datos desde tu cuenta de Segment.com.

Pantalla de configuración de Segment

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.

Configuración de clave API Data Out

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.

Configuración de destino OneSignal en Segment

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:

Ejemplo de llamada identify de usuario

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]
)

Ejemplo de propiedades de llamada Track

Interfaz de características y propiedades de usuario

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

Interfaz de audiencia Personas y rasgos computados

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.

Segmentos creados en OneSignal desde Segment

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 Hardbounced	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.

Primeros pasos & configuraciones

Canales de mensajería

Journeys

Audiencia & eventos personalizados

Analítica & Integraciones

Privacidad & Seguridad

Descripción general

Requisitos