RudderStack

RudderStack es una infraestructura de datos de clientes de código abierto para recopilar y enrutar datos de eventos de clientes a tu almacén de datos preferido y a docenas de otros proveedores de análisis, como Braze. Está preparado para la empresa y ofrece un sólido marco de transformación para procesar tus datos de eventos sobre la marcha.

La integración de Braze y RudderStack ofrece una integración de SDK nativa para tus aplicaciones Android, iOS y web, y una integración de servidor a servidor desde tus servicios backend.

Requisitos previos

Integración

Paso 1: Añadir un origen de datos

Para empezar a enviar datos a Braze, primero debes asegurarte de que un origen de datos esté configurado en tu aplicación RudderStack. Visita RudderStack para aprender a configurar tu origen de datos.

Paso 2: Configurar destino

Ahora que tu origen de datos está configurado, en el panel de RudderStack, selecciona ADD DESTINATION en Destinations. De la lista de destinos disponibles, selecciona Braze y haz clic en Next.

En el destino de Braze, proporciona la clave de la aplicación, la clave de API REST de Braze, el clúster de datos y la opción de SDK nativo (solo modo dispositivo). La opción de SDK nativo utilizará el SDK nativo de Braze para enviar eventos si se activa.

Paso 3: Elegir el tipo de integración

Puedes elegir integrar las bibliotecas web y nativas del lado del cliente de RudderStack con Braze utilizando uno de los siguientes enfoques:

• Integración en paralelo / modo dispositivo: RudderStack enviará los datos de eventos a Braze directamente desde tu cliente (navegador o aplicación móvil).
• Servidor a servidor / modo nube: El SDK de Braze envía los datos de eventos directamente a RudderStack, que luego se transforman y enrutan a Braze.
• Modo híbrido: Usa el modo híbrido para enviar eventos autogenerados y generados por el usuario de iOS y Android a Braze mediante una única conexión.

Nota

Aprende más sobre los modos de conexión de RudderStack y los beneficios de cada uno.

Integración en paralelo (modo dispositivo)

Con este modo, puedes enviar tus eventos a Braze utilizando el SDK de Braze configurado en tu sitio web o aplicación móvil.

Configura los mapeados con el SDK de RudderStack para tu plataforma en el repositorio de GitHub de Braze, como se describe en métodos compatibles:

• Android
• iOS
• Swift
• Web
• React Native
• Flutter

Para completar la integración en modo dispositivo, consulta las instrucciones detalladas de RudderStack para añadir Braze a tu proyecto.

Integración servidor a servidor (modo nube)

En este modo, el SDK envía los datos de eventos directamente al servidor de RudderStack. RudderStack luego transforma estos datos y los enruta al destino deseado. Esta transformación se realiza en el backend de RudderStack utilizando el módulo transformer de RudderStack.

Para habilitar la integración, necesitarás mapear los métodos de RudderStack a Braze, como se describe en métodos compatibles.

Nota

Los SDK del lado del servidor de RudderStack (Java, Python, Node.js, Go, Ruby) solo admiten el modo nube. Esto se debe a que sus SDK del lado del servidor operan en el backend de RudderStack y no pueden cargar ningún SDK específico de Braze.

Importante

La integración servidor a servidor no es compatible con las características de la interfaz de Braze, como las notificaciones push o los mensajes dentro de la aplicación. Sin embargo, estas características sí son compatibles con la integración en modo dispositivo.

Modo híbrido

Usa el modo híbrido para enviar todos los eventos a Braze desde tus orígenes de iOS y Android.

Cuando eliges el modo híbrido para enviar eventos a Braze, RudderStack:

1. Inicializa el SDK de Braze.
2. Envía todos los eventos generados por el usuario (identify, track, page, screen y group) a Braze solo a través del modo nube y los bloquea para que no se envíen a través del modo dispositivo.
3. Envía los eventos autogenerados (mensajes dentro de la aplicación, notificaciones push que requieren el SDK de Braze) a través del modo dispositivo.

Para enviar eventos a través del modo híbrido, usa la opción de modo híbrido al conectar tu origen al destino de Braze. Luego, añade la integración de Braze a tu proyecto.

Paso 4: Configurar ajustes adicionales

Después de completar la configuración inicial, configura los siguientes ajustes para recibir correctamente tus datos en Braze:

• Enable subscription groups in group call: Habilita este ajuste para enviar el estado del grupo de suscripción en tus eventos de grupo. Para obtener más información, consulta Group.
• Use Custom Attributes Operation: Habilita este ajuste si deseas utilizar la funcionalidad de atributos personalizados anidados en Braze para crear Segments y personalizar tus mensajes mediante un objeto de atributo personalizado. Para obtener más información, consulta Send user traits as nested custom attributes.
• Track events for anonymous users: Habilita este ajuste para rastrear la actividad de usuarios anónimos y enviar esta información a Braze.

Ajustes del modo de dispositivo

Los siguientes ajustes son aplicables solo si envías eventos a Braze a través del modo de dispositivo:

• Client-side Events Filtering: Este ajuste te permite especificar qué eventos deben bloquearse o permitirse para fluir hacia Braze. Para obtener más información sobre este ajuste, consulta Client-side Events Filtering.
• Deduplicate Traits: Habilita este ajuste para deduplicar los rasgos de usuario en la llamada identify.
• Show Braze logs: Este ajuste es aplicable solo cuando utilizas el SDK de JavaScript como origen. Habilítalo para mostrar los registros de Braze a tus usuarios.
• OneTrust Cookie Categories: Este ajuste te permite asociar los grupos de consentimiento de cookies de OneTrust a Braze.

Métodos compatibles

Braze admite los métodos de RudderStack identify, track, screen, page, group y alias.

• identify
• track
• screen
• page
• group
• alias

Enviar rasgos de usuario como atributos personalizados anidados

Puedes enviar los rasgos de usuario a Braze como atributos personalizados anidados y realizar operaciones de agregar, actualizar y eliminar sobre ellos. Para hacerlo, habilita la configuración “Use Custom Attributes Operation dashboard” en RudderStack al configurar el destino de Braze. Esta característica solo está disponible en modo nube.

Puedes enviar los rasgos de usuario como atributos personalizados anidados en tus eventos identify en el siguiente formato:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
rudderanalytics.identify("1hKOmRA4GRlm", {
  "cars": {
    "add": [{
      "age": 27,
      "id": 1,
      "name": "Alex Keener"
    }],
    "update": [{
        "age": 30,
        "id": 2,
        "identifier": "id",
        "name": "Rowan"
      },
      {
        "age": 27,
        "id": 1,
        "identifier": "id",
        "name": "Alex"
      }
    ]
  },
  "country": "USA",
  "email": "[email protected]",
  "firstName": "Alex",
  "gender": "M",
  "pets": [{
      "breed": "beagle",
      "id": 1,
      "name": "Scooby",
      "type": "dog"
    },
    {
      "breed": "calico",
      "id": 2,
      "name": "Garfield",
      "type": "cat"
    }
  ]
})

Para enviar los rasgos de usuario como atributos de usuario personalizados a través de las llamadas track, page o screen, pasa traits como un campo contextual en el evento:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
rudderanalytics.track("Product Viewed", {
    revenue: 8.99,
    currency: "USD",
 },{
  "traits": {
    "cars": {
      "add": [{
        "age": 27,
        "id": 1,
        "name": "Alex Keener"
      }],
      "update": [{
          "age": 30,
          "id": 2,
          "identifier": "id",
          "name": "Alex"
        },
        {
          "age": 27,
          "id": 1,
          "identifier": "id",
          "name": "Rowan"
        }
      ]
    },
    "city": "Disney",
    "country": "USA",
    "email": "[email protected]",
    "firstName": "Alexa",
    "gender": "woman",
    "pets": [{
        "breed": "beagle",
        "id": 1,
        "name": "Scooby",
        "type": "dog"
      },
      {
        "breed": "calico",
        "id": 2,
        "name": "Garfield",
        "type": "cat"
      }
    ]
  }
});

Nota

Para las operaciones de actualización y eliminación, identifier es una clave obligatoria. Si las operaciones de agregar, actualizar o eliminar no están presentes en el array anidado, RudderStack utiliza la operación de creación para crear las propiedades de forma predeterminada. Consulta Array de objetos para obtener más información sobre el envío de atributos personalizados anidados.

Solución de problemas

Veo “[Braze Deduplication]: Duplicate user detected, the user is dropped” en los registros de RudderStack

Este mensaje proviene de RudderStack cuando Deduplicate Traits está habilitado y RudderStack descarta los traits de usuario sin cambios antes de reenviarlos a Braze. No es un error de Braze.

RudderStack compara los traits de identify y track entrantes con el perfil de usuario y omite los atributos sin cambios para reducir el uso de punto de datos de Braze. Para más detalles, consulta la guía de RudderStack sobre User Trait Deduplication in Braze.

Si necesitas que todos los traits se envíen en cada llamada, desactiva Deduplicate Traits en la configuración de tu destino Braze en RudderStack. Ten en cuenta que esto puede aumentar el consumo de puntos de datos de Braze.