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 una fuente

Para empezar a enviar datos a Braze, primero debe asegurarse de que se ha configurado una fuente en su aplicación RudderStack. Visita Rudderstack para saber cómo configurar tu origen de datos.

Paso 2: Configurar destino

Ahora que su fuente de datos está configurada, en el panel de RudderStack, seleccione AÑADIR DESTINO en Destinos. En la lista de destinos disponibles, seleccione Braze y haga clic en Siguiente.

En el destino 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 (sólo en modo dispositivo). La opción SDK nativo utilizará el SDK nativo de Braze para enviar eventos si está alternada.

Paso 3: Elija el tipo de integración

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

• Lado a lado / modo dispositivo: RudderStack enviará los datos de eventos a Braze directamente desde su cliente (navegador o aplicación móvil).
• Servidor a servidor / modo nube: El SDK de Braze envía los datos de los eventos directamente a Rudderstack, que los transforma y enruta a Braze.
• Modo híbrido: Utiliza el modo híbrido para enviar eventos autogenerados y generados por el usuario de iOS y Android a Braze utilizando una única conexión.

Integración lado a lado (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 al SDK de Rudderstack para tu plataforma en el repositorio Braze de GitHub, como se describe en métodos compatibles:

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

Para completar la integración del modo dispositivo, consulte las instrucciones detalladas de RudderStack para añadir Braze a su proyecto.

Integración de servidor a servidor (modo nube)

En este modo, el SDK envía los datos del evento directamente al servidor Rudderstack. A continuación, RudderStack transforma estos datos y los encamina al destino deseado. Esta transformación se realiza en el backend de RudderStack mediante el módulo transformador de RudderStack.

Para habilitar la integración, tendrá que asignar los métodos RudderStack a Braze, como se describe en métodos compatibles.

Modo híbrido

Utiliza el modo híbrido para enviar todos los eventos a Braze desde tus fuentes iOS y Android.

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

1. Inicializa el SDK Braze.
2. Envía todos los eventos generados por el usuario (identificar, rastrear, página, pantalla y grupo) a Braze sólo a través del modo nube y bloquea su envío a través del modo dispositivo.
3. Envía los eventos autogenerados (mensajes in-app, notificaciones push que requieren el SDK Braze) a través del modo dispositivo.

Para enviar eventos a través del modo híbrido, utilice la opción de modo híbrido mientras conecta su fuente al destino Braze. A continuación, añade la integración Braze a tu proyecto.

Paso 4: Configurar ajustes adicionales

Tras completar la configuración inicial, configure los siguientes ajustes para recibir correctamente sus datos en Braze:

• Habilitar grupos de suscripción en llamada de grupo: Habilite esta configuración para enviar el estado del grupo de suscripción en sus eventos de grupo. Para más información, consulta Grupo.
• Operación Utilizar atributos personalizados: Active esta opción si desea utilizar la funcionalidad de atributos personalizados anidados en Braze para crear segmentos y personalizar sus mensajes utilizando un objeto de atributo personalizado. Para más información, consulta Enviar rasgos de usuario como atributos personalizados anidados.
• Seguimiento de eventos para usuarios anónimos: Active esta opción para realizar un seguimiento de la actividad anónima del usuario y enviar esta información a Braze.

Configuración del modo de dispositivo

La siguiente configuración sólo es aplicable si envías eventos a Braze a través del modo dispositivo:

• Filtrado de eventos del lado del cliente: Esta configuración te permite especificar qué eventos deben bloquearse o permitirse en Braze. Para obtener más información sobre esta configuración, consulte Filtrado de eventos en el lado del cliente.
• Deduplicar rasgos: Habilita esta configuración para deduplicar los rasgos del usuario en la llamada a identify.
• Mostrar registros de Braze: Esta configuración sólo es aplicable cuando se utiliza el SDK de JavaScript como fuente. Actívala para mostrar los registros de Braze a tus usuarios.
• Categorías de cookies de OneTrust: Esta configuración le permite asociar los grupos de consentimiento de cookies de OneTrust a Braze.

Métodos admitidos

Braze admite los métodos Rudderstack identificar, seguimiento, pantalla, página, grupo y alias.

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

Enviar rasgos de usuario como atributos personalizados anidados

Puede enviar los rasgos de usuario a Braze como atributos personalizados anidados y realizar operaciones de adición, actualización y eliminación en ellos. Para ello, habilita el ajuste “Utilizar atributos personalizados Panel de operaciones” en Rudderstack mientras configuras el destino Braze. Esta función sólo está disponible en modo nube.

Puede enviar los rasgos de usuario como atributos personalizados anidados en sus eventos identify con 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": "Mike"
      }
    ]
  },
  "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, pase traits como 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": "Mike"
        },
        {
          "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"
      }
    ]
  }
});