Segment

Segment es una plataforma de datos de clientes que te ayuda a recopilar, limpiar y activar los datos de tus clientes.

La integración de Braze y Segment te permite realizar un seguimiento de tus usuarios y enviar datos a varios proveedores de análisis de usuarios. Segment te permite:

• Sincronizar Segment Engage con Braze para utilizarlo en la segmentación de Campaign y Canvas de Braze.
• Importar datos entre las dos plataformas. Ofrecemos una integración en paralelo de SDK para tus aplicaciones Android, iOS y web, y una integración de servidor a servidor para sincronizar tus datos con las REST API de Braze.
• Conectar datos a Segment a través de Currents.

Requisitos previos

Integración

Para integrar Braze y Segment, debes configurar Braze como destino de acuerdo con el tipo de integración elegido (modo de conexión). Si eres un cliente nuevo de Braze, puedes transmitir datos históricos a Braze mediante repeticiones de Segment. A continuación, debes configurar los mapeados y probar tu integración para garantizar un flujo de datos fluido entre Braze y Segment.

Paso 1: Crear un destino Braze

Después de configurar correctamente tus fuentes, tendrás que configurar Braze como destino para cada fuente (iOS, Android, web, etc.). Tendrás muchas opciones para personalizar el flujo de datos entre Braze y Segment mediante la configuración de la conexión.

Paso 2: Elige el marco de destino y el tipo de conexión

En Segment, ve a Destinations > Braze > Configure Braze > Select your Source > Setup.

Puedes integrar la fuente web de Segment (Analytics.js) y las bibliotecas nativas del lado del cliente con Braze utilizando una integración en paralelo (modo dispositivo) o una integración de servidor a servidor (modo nube).

Tu elección del modo de conexión vendrá determinada por el tipo de fuente para el que esté configurado el destino.

Nota

Visita Segment para obtener más información sobre las dos opciones de integración (modos de conexión), incluidas las ventajas de cada una.

Integración en paralelo de SDK

También llamada modo dispositivo, esta integración mapea el SDK y los métodos de Segment al SDK de Braze, permitiendo el acceso a todas las características que proporciona nuestro SDK, como push, mensajería dentro de la aplicación y otros métodos nativos de Braze.

Nota

Cuando utilices el modo dispositivo de Segment, no necesitas integrar directamente el SDK de Braze. Al añadir Braze como destino del modo dispositivo para Segment, el SDK de Segment inicializará el SDK de Braze y llamará a los métodos de Braze mapeados pertinentes.

Importante

Para las integraciones en modo dispositivo en móvil, debes añadir el complemento de destino de Braze a tu aplicación, además de configurar el destino en el panel de Segment. El SDK de Segment no incluye el complemento de Braze de forma predeterminada; sin él, el SDK de Segment no puede reenviar datos ni llamadas a métodos mapeados a Braze, y características como push, mensajes dentro de la aplicación y Content Cards no funcionarán. Consulta las pestañas específicas de cada plataforma a continuación para obtener instrucciones de instalación.

Cuando se utiliza una conexión en modo dispositivo, de forma similar a la integración del SDK de Braze de forma nativa, el SDK de Braze asignará un device_id y un identificador de backend, braze_id, a cada usuario. Esto permite a Braze capturar la actividad anónima del dispositivo haciendo coincidir esos identificadores en lugar de userId.

Nota

Si utilizas filtros de destino con destinos en modo dispositivo (Kotlin o Swift), debes configurar el complemento de destino con el soporte de filtros habilitado. Consulta la documentación de filtros de destino de Segment para obtener detalles sobre las versiones de complementos compatibles.

• android
• ios
• web o javascript
• react native

Importante

Braze mantiene el código fuente de la integración del modo dispositivo Android y lo actualiza periódicamente para reflejar las nuevas versiones del SDK de Braze.

El SDK de Braze que utilices dependerá del SDK de Segment que utilices:

	SDK de Segment	SDK de Braze
Preferido	Analytics-Kotlin	Braze Segment Kotlin
Legado	Analytics-Android	Braze Segment Android

Para configurar Braze como destino en modo dispositivo para tu fuente Android, elige Actions como Destination framework y, a continuación, selecciona Save.

Para completar la integración en paralelo, debes añadir el complemento de destino Braze Kotlin a tu aplicación Android. Este complemento conecta el SDK de Segment y el SDK de Braze, permitiendo que los datos en modo dispositivo fluyan hacia Braze. Sigue las instrucciones de instalación de Segment para añadir la dependencia del complemento e inicializarlo con tu instancia de análisis de Segment.

Braze mantiene el código fuente de la integración del modo dispositivo Android y lo actualiza regularmente para reflejar las nuevas versiones del SDK de Braze.

Importante

Braze mantiene el código fuente de la integración del modo dispositivo iOS y lo actualiza regularmente para reflejar las nuevas versiones del SDK de Braze.

El SDK de Braze que utilices dependerá del SDK de Segment que utilices:

	SDK de Segment	SDK de Braze
Preferido	Analytics-Swift	Braze Segment Swift
Legado	Analytics-iOS	Braze Segment iOS

Para configurar Braze como destino en modo dispositivo para tu fuente iOS, elige Actions como Destination framework y, a continuación, selecciona Save.

Para completar la integración en paralelo, debes añadir el complemento de destino Braze Swift a tu aplicación iOS. Este complemento conecta el SDK de Segment y el SDK de Braze, permitiendo que los datos en modo dispositivo fluyan hacia Braze. Sigue las instrucciones de instalación de Segment para añadir la dependencia del complemento (a través de Swift Package Manager o CocoaPods) e inicializarlo con tu instancia de análisis de Segment.

Braze mantiene el código fuente de la integración del modo dispositivo iOS y lo actualiza regularmente para reflejar las nuevas versiones del SDK de Braze.

Se recomienda el marco Braze Web Mode (Actions) de Segment para configurar Braze como destino del modo dispositivo para tu fuente web.

En Segment, selecciona Actions como marco de destino y Device Mode como modo de conexión.

Segment mantiene el código fuente del complemento Braze para React Native y lo actualiza periódicamente para reflejar las nuevas versiones del SDK de Braze.

Al conectar una fuente de React Native de Segment a Braze, debes configurar una fuente y un destino por sistema operativo. Por ejemplo, configurar un destino iOS y un destino Android.

Dentro de la base de código de tu aplicación, inicializa condicionalmente el SDK de Segment por tipo de dispositivo, utilizando la respectiva clave de escritura de origen asociada a cada aplicación.

Cuando se registra un token de notificaciones push desde un dispositivo y se envía a Braze, se asocia al identificador de la aplicación utilizado al inicializar el SDK. La inicialización condicional del tipo de dispositivo ayuda a confirmar que cualquier token de notificaciones push enviado a Braze está asociado a la aplicación correspondiente.

Importante

Si la aplicación React Native inicializa Braze con el mismo identificador de aplicación de Braze para todos los dispositivos, todos los usuarios de React Native se considerarán usuarios de Android o iOS en Braze, y todos los tokens de notificaciones push estarán asociados a ese sistema operativo.

Para configurar Braze como destino en modo dispositivo para cada fuente, elige Actions como Destination framework y, a continuación, selecciona Save.

Integración de servidor a servidor

También llamada modo nube, esta integración reenvía datos de Segment a las REST API de Braze. Utiliza el marco Braze Cloud Mode (Actions) de Segment para configurar un destino en modo nube para cualquiera de tus fuentes.

A diferencia de la integración en paralelo, la integración de servidor a servidor no es compatible con las características de la interfaz de usuario de Braze, como la mensajería dentro de la aplicación, Content Cards o el registro automático de tokens de notificaciones push. También existen datos capturados automáticamente (como usuarios anónimos y campos a nivel de dispositivo) que no están disponibles a través del modo nube.

Si deseas utilizar estos datos y estas características, considera la posibilidad de utilizar la integración en paralelo (modo dispositivo) del SDK.

El código fuente del destino Braze Cloud Mode (Actions) lo mantiene Segment.

Paso 3: Configuración

Define la configuración de tu destino. No todas las configuraciones se aplicarán a todos los tipos de destino.

• mobile device-mode
• web device-mode
• cloud-mode

Paso 4: Métodos de mapeado

Braze admite los métodos de Segment Page, Identify y Track. Los tipos de identificadores utilizados en estos métodos dependerán de si los datos se envían a través de una integración de servidor a servidor (modo nube) o en paralelo (modo dispositivo). En los destinos Braze Web Mode Actions y Cloud Mode Actions, también puedes elegir configurar un mapeado para una llamada de alias de Segment.

Nota

Aunque los alias de usuario se admiten como identificador en el destino Braze Cloud Mode (Actions), hay que tener en cuenta que la llamada de alias de Segment no está directamente relacionada con los alias de usuario de Braze.

El destino Cloud Mode (Actions) ofrece una acción Crear alias que puede utilizarse para crear un usuario de solo alias o añadir un alias a un perfil existente de external_id. La acción Identificar usuario puede utilizarse junto con la acción Crear alias para fusionar un usuario de solo alias con un external_id después de que haya uno disponible para el usuario.

También es posible ingeniárselas y utilizar braze_id para enviar datos de usuario anónimos en modo nube. Esto requiere incluir manualmente el braze_id del usuario en todas tus llamadas a la API de Segment. Puedes obtener más información sobre cómo configurar esta solución en la documentación de Segment.

Los datos de destino enviados a Braze se pueden procesar por lotes dentro de Cloud Mode Actions. El tamaño de los lotes está limitado a 75 eventos, y estos lotes se acumularán durante un periodo de 30 segundos antes de ser enviados. El procesamiento por lotes de solicitudes se realiza por acción. Por ejemplo, las llamadas Identify (atributos) se agruparán en una solicitud y las llamadas Track (eventos personalizados) se agruparán en una segunda solicitud. Braze recomienda habilitar esta característica, ya que reducirá el número de solicitudes que se envían desde Segment a Braze. A su vez, esto reducirá el riesgo de que el destino alcance los límites de velocidad de Braze y reintente las solicitudes.

Puedes activar el procesamiento por lotes de una acción navegando a tu destino Braze > Mappings. Desde ahí, haz clic en el icono de 3 puntos situado a la derecha del mapeado y selecciona Edit Mapping. Desplázate hasta la parte inferior de la sección Select mappings y asegúrate de que Batch Data to Braze está establecido en Yes.

• identify
• track
• page

Identify

La llamada Identify te permite vincular a un usuario a sus acciones y registrar atributos sobre él.

Algunos rasgos especiales de Segment están mapeados en campos de perfil de atributo estándar en Braze:

Rasgos especiales de Segment	Atributos estándar de Braze
userId	external_id
firstName	first_name
lastName	last_name
email	email
birthday	dob
address.country	country
address.city	home_city
gender	gender

Otros campos reservados del perfil de Braze, como email_subscribe y push_subscribe, pueden enviarse utilizando la convención de nomenclatura de Braze para estos campos y pasándolos como rasgos dentro de una llamada Identify.

Añadir un usuario a un grupo de suscripción

También puedes suscribir o cancelar la suscripción de un usuario de un determinado grupo de suscripción utilizando los siguientes campos del parámetro de rasgos.

Utiliza el campo reservado del perfil de Braze llamado braze_subscription_groups, que puede asociarse a una matriz de objetos. Cada objeto de la matriz debe tener dos claves reservadas:

1. subscription_group_state: indica si el usuario está "subscribed" o "unsubscribed" en un grupo de suscripción específico.
2. subscription_group_id: representa el ID único del grupo de suscripción. Puedes encontrar este ID en el panel de Braze, en Administración del grupo de suscripción.

• swift
• kotlin
• typescript

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
analytics.identify(
  userId: "{your-user}",
  traits: [
    "braze_subscription_groups": [
      [
        "subscription_group_id": "{your-group-id}",
        "subscription_group_state": "subscribed"
      ],
      [
        "subscription_group_id", "{your-group-id}",
        "subscription_group_state": "unsubscribed"
      ]
    ]
  ]
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
analytics.identify(
  "{your-user}",
  buildJsonObject {
    put("braze_subscription_groups", buildJsonArray {
        add(
          buildJsonObject {
            put("subscription_group_id", "{your-group-id}")
            put("subscription_group_state", "subscribed")
          }
        )
        add(
          buildJsonObject {
            put("subscription_group_id", "{your-group-id}")
            put("subscription_group_state", "unsubscribed")
          }
        )
      }
    )
  }
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
analytics.identify(
  "{your-user}",
  {
    braze_subscription_groups: [
      {
        subscription_group_id: "{your-group-id}",
        subscription_group_state: "subscribed"
      },
      {
        subscription_group_id: "{your-group-id}",
        subscription_group_state: "unsubscribed"
      }
    ]
  }
)

Atributos personalizados

Todos los demás rasgos se registrarán como atributos personalizados.

Método de Segment	Método de Braze	Ejemplo
Identify con ID de usuario	Configurar ID externo	Segment: analytics.identify("dawei"); Braze: Braze.changeUser("dawei")
Identify con rasgos reservados	Establecer atributos del usuario	Segment: analytics.identify({email: "[email protected]"}); Braze: Braze.getUser().setEmail("[email protected]");
Identify con rasgos personalizados	Establecer atributos personalizados	Segment: analytics.identify({fav_cartoon: "Naruto"}); Braze: Braze.getUser().setCustomAttribute("fav_cartoon": "Naruto");
Identify con ID de usuario y rasgos	Segment: establecer ID externo y atributo	Combina los métodos anteriores.

En los destinos Web Mode Actions y Cloud Mode Actions, los mapeados anteriores pueden establecerse mediante la acción Actualizar perfil de usuario.

Importante

Cuando pases datos de atributos de usuario, comprueba que solo pasas valores de atributos que hayan cambiado desde la última actualización. Así te asegurarás de no registrar innecesariamente puntos de datos. Para las fuentes del lado del cliente, utiliza la herramienta Middleware de código abierto de Segment para optimizar tu integración y limitar el uso de puntos de datos eliminando las llamadas duplicadas a identify() desde Segment.

Track

Cuando realices el seguimiento de un evento, registraremos ese evento como un evento personalizado utilizando el nombre proporcionado.

Los metadatos enviados dentro del objeto de propiedades de la llamada Track se registrarán en Braze como propiedades del evento personalizado para el evento asociado. Se admiten todos los tipos de datos de propiedades de eventos personalizados.

En los destinos Web Mode Actions y Cloud Mode Actions, los mapeados anteriores pueden establecerse mediante la acción Track Event.

Método de Segment	Método de Braze	Ejemplo
Track	Registrado como evento personalizado.	Segment: analytics.track("played_game"); Braze: Braze.logCustomEvent("played_game");
Track con propiedades	Registrado como propiedad del evento.	Segment: analytics.track("played_game", {name: "BotW", weapon: "boomerang"}); Braze: Braze.logCustomEvent("played_game", { "name": "BotW", "weapon": "boomerang"});
Track con producto	Registrado como evento de compra.	Segment: analytics.track("Order Completed", {products: [product_id: "ab12", price: 19]}); Braze: Braze.logPurchase("ab12", 19);

Pedido completado

Cuando realices el seguimiento de un evento con el nombre Order Completed utilizando el formato descrito en la API de comercio electrónico de Segment, registraremos los productos que hayas indicado como compras.

En los destinos Web Mode Actions y Cloud Mode Actions, el mapeado predeterminado puede personalizarse a través de la acción Track Purchase.

Page

La llamada Page te permite registrar cada vez que un usuario ve una página de tu sitio web, junto con cualquier propiedad opcional sobre la página.

Este tipo de evento puede utilizarse como desencadenante en los destinos Web Mode Actions y Cloud Actions para registrar un evento personalizado en Braze.

Paso 5: Prueba tu integración

Al utilizar la integración en paralelo (modo dispositivo), tus métricas de resumen (sesiones de toda la vida, MAU, DAU, adherencia, sesiones diarias y sesiones diarias por MAU) pueden utilizarse para garantizar que Braze está recibiendo datos de Segment.

Puedes ver tus datos en las páginas de eventos personalizados o de ingresos, o creando un segmento. La página Eventos personalizados del panel te permite ver los recuentos de eventos personalizados a lo largo del tiempo. Ten en cuenta que no podrás utilizar fórmulas que incluyan estadísticas de MAU y DAU cuando utilices una integración de servidor a servidor (modo nube).

Si envías datos de compra a Braze (consulta pedido completado en la pestaña Track del Paso 3), la página de ingresos te permite ver datos sobre ingresos o compras durante periodos específicos o los ingresos totales de tu aplicación.

Crear un segmento te permite filtrar a tus usuarios en función de los datos de eventos y atributos personalizados.

Importante

Si utilizas una integración de servidor a servidor (modo nube), los filtros relacionados con los datos de sesión recopilados automáticamente (como “primera aplicación utilizada” y “última aplicación utilizada”) no funcionarán. Utiliza una integración en paralelo (modo dispositivo) si quieres utilizarlos en tu integración de Segment y Braze.

Eliminación y supresión de usuarios

Si necesitas eliminar o suprimir usuarios, ten en cuenta que la característica de eliminación de usuarios de Segment está mapeada en el punto final /users/delete de Braze. Ten en cuenta que la verificación de estas eliminaciones puede tardar hasta 30 días.

Debes asegurarte de que seleccionas un identificador de usuario común entre Braze y Segment (como external_id). Después de haber iniciado una solicitud de eliminación con Segment, puedes ver el estado en la pestaña de solicitudes de eliminación de tu panel de Segment.

Repeticiones de Segment

Segment proporciona un servicio a los clientes para “reproducir” todos los datos históricos a un nuevo socio tecnológico. Los nuevos clientes de Braze que deseen importar todos los datos históricos relevantes pueden hacerlo a través de Segment. Habla con tu representante de Segment si esto te interesa.

Segment se conectará a nuestro punto final /users/track para importar datos de usuario a Braze en tu nombre.

Importante

Todos los identificadores admitidos en el destino Cloud Mode Actions son compatibles como parte de las repeticiones de Segment.

Buenas prácticas

Matices del mapeado de datos.

Escenarios en los que los datos no pasarán como se espera:

1. Atributos personalizados anidados
   • Aunque los atributos personalizados anidados pueden enviarse técnicamente a Braze a través de Segment, cada vez se enviará la carga útil completa. Esto incurrirá en puntos de datos por clave pasada en el objeto anidado cada vez que se envíe la carga útil.
     
     Para gastar solo un subconjunto de puntos de datos cuando se envía la carga útil, puedes utilizar la característica de funciones de destino personalizadas, propiedad de Segment. Esta característica de la plataforma Segment te permite personalizar cómo se envían los datos a los destinos posteriores.

Nota

Las funciones de destino personalizadas se controlan dentro de Segment, y Braze tiene información limitada sobre las funciones que se han configurado externamente.

2. Pasar datos anónimos de servidor a servidor.
   • Los clientes pueden utilizar las bibliotecas de servidor a servidor de Segment para canalizar datos anónimos a otros sistemas. Consulta la sección de métodos de mapeado para obtener más información sobre el envío de usuarios sin external_id a Braze mediante una integración de servidor a servidor (modo nube).