Skip to content

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

Requisito Descripción
Cuenta de RudderStack Se requiere una cuenta de RudderStack para beneficiarse de esta asociación.
Fuente configurada Una fuente es esencialmente el origen de cualquier dato enviado a RudderStack, como sitios web, aplicaciones móviles o servidores backend. Es necesario configurar la fuente antes de configurar Braze como destino en RudderStack.
Clave de API REST de Braze Una clave de API REST de Braze con permisos users.track, users.identify, users.delete y users.alias.new.

Se puede crear en el panel de Braze desde Configuración > Claves de API.
Clave de la aplicación Braze Para obtener la clave de tu aplicación en el panel de Braze, ve a Configuración > Configuración de la aplicación > Identificación y busca el nombre de tu aplicación. Guarda la cadena de identificador asociada.
Centro de datos Tu centro de datos se alinea con tu instancia del panel de Braze.

Integración

Paso 1: Añadir una fuente

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

Paso 2: Configurar destino

Ahora que tu fuente de datos está configurada, en el dashboard de RudderStack, selecciona ADD DESTINATION en Destinations. En la lista de destinos disponibles, selecciona Braze y haz clic en Next.

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

Paso 3: Elige 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 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 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 al SDK de RudderStack para tu plataforma en el repositorio de Braze en GitHub, como se describe en métodos compatibles:

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

Integración de servidor a servidor (modo nube)

En este modo, el SDK envía los datos del evento directamente al servidor de RudderStack. A continuación, RudderStack transforma estos datos y los enruta 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ás que asignar los métodos de 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 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 bloquea su envío 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, utiliza la opción de modo híbrido mientras conectas tu fuente al destino Braze. A continuación, añade la integración de Braze a tu proyecto.

Paso 4: Configurar ajustes adicionales

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

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

Configuración del modo dispositivo

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

  • Client-side Events Filtering: Esta configuración te permite especificar qué eventos deben bloquearse o permitirse en Braze. Para obtener más información sobre esta configuración, consulta Client-side Events Filtering.
  • Deduplicate Traits: Habilita esta configuración para deduplicar los rasgos del usuario en la llamada identify.
  • Show Braze logs: Esta configuración solo es aplicable cuando se utiliza el SDK de JavaScript como fuente. Actívala para mostrar los registros de Braze a tus usuarios.
  • OneTrust Cookie Categories: Esta configuración 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.

El método identify de RudderStack asocia a los usuarios con sus acciones. RudderStack captura un ID de usuario único y rasgos opcionales asociados a ese usuario, como nombre, correo electrónico, dirección IP, etc.

Gestión de deltas para llamadas identify
Si envías eventos a Braze a través del modo dispositivo, puedes ahorrar costes deduplicando tus llamadas identify. Para ello, habilita la configuración Deduplicate Traits en el dashboard. RudderStack envía entonces solo los atributos (traits) cambiados o modificados a Braze.

Eliminar un usuario
Puedes eliminar un usuario en Braze utilizando la regulación de supresión con eliminación de la API de regulación de datos de RudderStack.

El método track de RudderStack captura todas las actividades del usuario y las propiedades asociadas a dichas actividades.

Pedido completado
Al utilizar la API de comercio electrónico de RudderStack para llamar al método track de un evento con el nombre Order Completed, RudderStack envía los productos incluidos en ese evento a Braze como purchases.

El método screen de RudderStack te permite registrar las vistas de pantalla móvil de tus usuarios con cualquier información adicional sobre la pantalla vista.

El método page de RudderStack te permite registrar las páginas vistas de tu sitio web. También captura cualquier otra información relevante sobre esa página.

El método group de RudderStack te permite asociar un usuario a un grupo.

Estado del grupo de suscripción
Para actualizar el estado del grupo de suscripción, habilita el ajuste Enable subscription groups in group call en el dashboard de RudderStack y envía el estado del grupo de suscripción en la llamada de grupo.

El método alias de RudderStack te permite fusionar diferentes identidades de un usuario conocido. Ten en cuenta que RudderStack solo admite la llamada alias para Braze en modo nube.

Enviar rasgos de usuario como atributos personalizados anidados

Puedes 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 Use Custom Attributes Operation en el dashboard de RudderStack mientras configuras el destino Braze. Esta función solo está disponible en modo nube.

Puedes enviar los rasgos de usuario como atributos personalizados anidados en tus 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, pasa 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"
      }
    ]
  }
});
New Stuff!