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 que hayas elegido (modo de conexión). Si eres un cliente nuevo de Braze, puedes retransmitir datos históricos a Braze utilizando las 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

Tras 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 conexión.

Paso 2: Elegir el framework 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 (device-mode) o una integración servidor a servidor (cloud-mode).

Tu elección del modo de conexión estará determinada por el tipo de fuente para la 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 del SDK

También llamada device-mode, esta integración mapea el SDK de Segment y los métodos al SDK de Braze, lo que permite acceder a todas las características que proporciona nuestro SDK, como push, mensajes dentro de la aplicación y otros métodos nativos de Braze.

Nota

Cuando utilices el device-mode de Segment, deja que Segment inicialice Braze. No inicialices también el SDK de Braze en tu aplicación. El plugin de destino configura Braze y abre sesiones; una segunda inicialización nativa puede registrar sesiones duplicadas. Utiliza identify de Segment para establecer el ID de usuario. El plugin mapea esa llamada a changeUser().

Importante

Para integraciones en device-mode en móvil, debes añadir el plugin 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 plugin de Braze por defecto; sin él, el SDK de Segment no puede reenviar datos ni llamadas de 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 plataforma en esta sección para obtener instrucciones de instalación.

Al utilizar una conexión en device-mode, de forma similar a la integración nativa del SDK de Braze, 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 al hacer coincidir esos identificadores en lugar de userId.

Nota

Si utilizas filtros de destino con destinos en device-mode (Kotlin o Swift), debes configurar el plugin 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 plugin compatibles.

• android
• ios
• web o javascript
• react native

Importante

El código fuente de la integración en device-mode para Android es mantenido por Braze y se actualiza regularmente para reflejar las nuevas versiones del SDK de Braze.

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

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

Para configurar Braze como destino en device-mode para tu fuente de Android, elige Actions como Destination framework y después selecciona Save.

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

El código fuente de la integración en device-mode para Android es mantenido por Braze y se actualiza regularmente para reflejar las nuevas versiones del SDK de Braze.

Importante

El código fuente de la integración en device-mode para iOS es mantenido por Braze y se actualiza regularmente para reflejar las nuevas versiones del SDK de Braze.

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

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

Para configurar Braze como destino en device-mode para tu fuente de iOS, elige Actions como Destination framework y después selecciona Save.

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

El código fuente de la integración en device-mode para iOS es mantenido por Braze y se actualiza regularmente para reflejar las nuevas versiones del SDK de Braze.

El framework Braze Web Mode (Actions) de Segment es recomendado para configurar Braze como destino en device-mode para tu fuente web.

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

El código fuente del plugin React Native de Braze es mantenido por Segment y se actualiza regularmente para reflejar las nuevas versiones del SDK de Braze.

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

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

Cuando se registra un token de push desde un dispositivo y se envía a Braze, se asocia con el identificador de la aplicación utilizado al inicializar el SDK. La inicialización condicional por tipo de dispositivo ayuda a confirmar que cualquier token de push enviado a Braze esté asociado con 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, entonces todos los usuarios de React Native serán considerados usuarios de Android o iOS en Braze, y todos los tokens de push se asociarán con ese sistema operativo.

Para configurar Braze como destino en device-mode para cada fuente, elige Actions como Destination framework y después selecciona Save.

Integración servidor a servidor

También llamada cloud-mode, esta integración reenvía datos desde Segment a las REST APIs de Braze. Utiliza el framework Braze Cloud Mode (Actions) de Segment para configurar un destino en cloud-mode para cualquiera de tus fuentes.

A diferencia de la integración en paralelo, la integración servidor a servidor no es compatible con las características de la interfaz de Braze, como mensajes dentro de la aplicación, Content Cards o el registro automático de tokens de 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 de cloud-mode.

Si deseas utilizar estos datos y estas características, considera usar la integración en paralelo (device-mode) del SDK.

El código fuente del destino Braze Cloud Mode (Actions) es mantenido por 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.

• device-mode móvil
• device-mode web
• cloud-mode

Paso 4: Mapear métodos

Braze es compatible con los métodos Page, Identify y Track de Segment. Los tipos de identificadores utilizados dentro de estos métodos dependerán de si los datos se envían a través de una integración servidor a servidor (cloud-mode) o en paralelo (device-mode). 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 son compatibles como identificador en el destino Braze Cloud Mode (Actions), se debe 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 solo con alias o añadir un alias a un perfil external_id existente. La acción Identificar usuario puede utilizarse junto con la acción Crear alias para fusionar un usuario solo con alias con un external_id una vez que esté disponible para el usuario.

También es posible diseñar una solución alternativa y utilizar braze_id para enviar datos de usuarios anónimos en cloud-mode. 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 alternativa en la documentación de Segment.

Los datos de destinos enviados a Braze se pueden agrupar en lotes dentro de Cloud Mode Actions. Los tamaños de lote están limitados a 75 eventos, y estos lotes se acumularán durante un periodo de 30 segundos antes de enviarse. El agrupamiento de solicitudes en lotes 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 enviadas desde Segment a Braze. A su vez, esto reducirá el riesgo de que el destino alcance los límites de velocidad de Braze y necesite reintentar solicitudes.

Puedes activar el agrupamiento en lotes para una acción navegando a tu destino Braze > Mappings. Desde ahí, haz clic en el icono de los 3 puntos junto al 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é configurado en Yes.

• identify
• track
• page

Identify

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

Ciertos traits especiales de Segment se mapean a campos de atributos estándar del perfil en Braze:

Traits 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 de perfil reservados de Braze como email_subscribe y push_subscribe pueden enviarse utilizando la convención de nombres de Braze para estos campos y pasándolos como traits 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 a un grupo de suscripción determinado utilizando los siguientes campos en el parámetro traits.

Utiliza el campo de perfil reservado de Braze llamado braze_subscription_groups, que puede asociarse con un array de objetos. Cada objeto en el array debe tener dos claves reservadas:

1. subscription_group_state: Indica si el usuario está "subscribed" o "unsubscribed" de 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 Subscription Group Management.

• 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 traits se registrarán como atributos personalizados.

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

En los destinos Web Mode Actions y Cloud Mode Actions, estos mapeados pueden configurarse utilizando la acción Actualizar perfil de usuario.

Importante

Al pasar datos de atributos de usuario, verifica que solo pases valores para atributos que hayan cambiado desde la última actualización. Esto garantizará que no registres puntos de datos innecesariamente. Para fuentes del lado del cliente, utiliza la herramienta de código abierto Middleware de Segment para optimizar tu integración y limitar el uso de puntos de datos eliminando llamadas identify() duplicadas de Segment.

Track

Cuando rastreas 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 las propiedades del evento personalizado para el evento asociado. Todos los tipos de datos de propiedades de eventos personalizados son compatibles.

En los destinos Web Mode Actions y Cloud Mode Actions, estos mapeados pueden configurarse utilizando la acción Track Event.

Método de Segment	Método de Braze	Ejemplo
Track	Registrado como un 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 un evento de compra.	Segment: analytics.track("Order Completed", {products: [product_id: "ab12", price: 19]}); Braze: Braze.logPurchase("ab12", 19);

Pedido completado

Cuando rastreas un evento con el nombre Order Completed utilizando el formato descrito en la API de eCommerce de Segment, registraremos los productos que hayas incluido 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: Probar tu integración

Al utilizar la integración en paralelo (device-mode), tus métricas del resumen (sesiones de por vida, MAU, usuario activo diario, adherencia, sesiones diarias y sesiones diarias por MAU) pueden utilizarse para asegurar que Braze está recibiendo datos de Segment.

Puedes ver tus datos en las páginas de eventos personalizados o ingresos, o creando un segmento. La página Custom Events 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 usuario activo diario cuando utilices una integración servidor a servidor (cloud-mode).

Si estás enviando datos de compras 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 tus usuarios según los datos de eventos personalizados y atributos.

Importante

Si utilizas una integración servidor a servidor (cloud-mode), los filtros relacionados con los datos de sesión capturados automáticamente (como “primera vez que usó la aplicación” y “última vez que usó la aplicación”) no funcionarán. Utiliza una integración en paralelo (device-mode) si deseas usar estos filtros 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 función de eliminación de usuarios de Segment está mapeada al endpoint /users/delete de Braze. Ten en cuenta que la verificación de estas eliminaciones podría tardar hasta 30 días.

Debes asegurarte de seleccionar un identificador de usuario común entre Braze y Segment (como external_id). Una vez que hayas 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 ofrece un servicio a los clientes para “repetir” todos los datos históricos hacia un nuevo partner 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 endpoint /users/track para importar datos de usuario en Braze en tu nombre.

Importante

Todos los identificadores compatibles con el destino en modo nube (Cloud Mode Actions) son compatibles como parte de las repeticiones de Segment.

Prácticas recomendadas

Matices del mapeado de datos.

Escenarios en los que los datos no se pasarán según lo esperado:

1. Atributos personalizados anidados
   • Aunque los atributos personalizados anidados técnicamente pueden enviarse a Braze a través de Segment, la carga útil completa se enviará cada vez. Esto generará puntos de datos por cada clave pasada en el objeto anidado cada vez que se envíe la carga útil.
     
     Para utilizar solo un subconjunto de puntos de datos cuando se envíe la carga útil, puedes usar la característica de funciones de destino personalizadas de Segment. Esta característica de la plataforma de 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 una visibilidad limitada sobre las funciones que se hayan configurado externamente.

2. Pasar datos anónimos de servidor a servidor.
   • Los clientes pueden usar 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 cómo enviar usuarios sin un external_id a Braze a través de una integración de servidor a servidor (modo nube).