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 campañas Braze y Canvas.
• 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 API REST de Braze.
• Conecta los datos al segmento 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 Segmento, ve a Destinos > Braze > Configurar Braze > Selecciona tu Fuente > Configurar.

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.

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.

Cuando se utiliza una conexión en modo dispositivo, de forma similar a la integración del SDK Braze de forma nativa, el SDK Braze asignará un device_id y un identificador 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.

• android
• ios
• web or javascript
• react native

Integración de servidor a servidor

También llamada modo nube, esta integración reenvía datos de Segment a las API REST de Braze. Utiliza el marco del Modo Nube (Acciones) de Braze 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, las tarjetas de contenido o el registro automático de token 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 Modo Nube Braze (Acciones) 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 Página, Identificador y Seguimiento. 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 Web Mode Actions y Cloud Mode Actions de Braze, también puedes elegir configurar un mapeado para una llamada de alias de Segment.

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 solo con 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 la dirección 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 las 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 expulsados. La dosificación de solicitudes se realiza por acción. Por ejemplo, Identificar llamadas (atributos) se agrupará en una solicitud y Seguir llamadas (eventos personalizados) se agrupará 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 > Mapeados. Desde ahí, haz clic en el icono de 3 puntos situado a la derecha del mapeado y selecciona Editar mapeado. Desplázate hasta la parte inferior de la sección Seleccionar mapeados y asegúrate de que la opción Datos por lotes a Braze está establecida en Sí.

• identify
• track
• page

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

Paso 5: Prueba tu integración

Al utilizar la integración en paralelo (modo dispositivo), tus métricas generales (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 (ver pedido completado en la pestaña Seguimiento 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.

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

Buenas prácticas