RudderStack

O RudderStack é uma infraestrutura de dados de clientes de código aberto para coletar e rotear dados de eventos de clientes para seu data warehouse preferido e dezenas de outros provedores de análise de dados, como o Braze. Ele está pronto para empresas e oferece uma estrutura de transformação robusta para processar seus dados de eventos em tempo real.

A integração entre a Braze e o RudderStack oferece uma integração de SDK nativo para seus aplicativos Android, iOS e Web e uma integração de servidor para servidor de seus serviços de back-end.

Pré-requisitos

Integração

Etapa 1: Adicionar uma fonte

Para começar a enviar dados para a Braze, primeiro você precisa confirmar se há uma fonte configurada no seu app da RudderStack. Visite o RudderStack para saber como configurar sua fonte de dados.

Etapa 2: configure os destinos

Agora que sua fonte de dados está configurada, no dashboard do RudderStack, selecione ADD DESTINATION (Adicionar destino ) em Destinations (Destinos). Na lista de destinos disponíveis, selecione Braze e clique em Next.

No destino da Braze, forneça a chave do app, a chave da API REST da Braze, o cluster de dados e a opção de SDK nativo (somente no modo dispositivo). Se ativada, a opção de SDK nativo usará o SDK nativo da Braze para enviar eventos.

Etapa 3: Escolha o tipo de integração

Você pode optar por integrar as bibliotecas web e nativas do lado do cliente do RudderStack com o Braze usando uma das seguintes abordagens:

• Modo lado a lado / dispositivo: O RudderStack enviará os dados do evento para a Braze diretamente do seu cliente (navegador ou aplicativo móvel).
• Modo de servidor para servidor / nuvem: O SDK da Braze envia os dados do evento diretamente para o RudderStack, onde são transformados e reencaminhados para a Braze.
• Modo híbrido: Use o modo híbrido para enviar eventos gerados automaticamente pelo usuário e pelo iOS e Android para o Braze usando uma única conexão.

Integração lado a lado (modo dispositivo)

Com esse modo, você pode enviar seus eventos para a Braze usando o SDK da Braze configurado em seu site ou app móvel.

Configure os mapeamentos para o RudderStack SDK para sua plataforma no repositório do Braze GitHub, conforme descrito em métodos suportados:

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

Para concluir a integração do modo de dispositivo, consulte as instruções detalhadas do RudderStack para adicionar o Braze ao seu projeto.

Integração de servidor para servidor (modo de nuvem)

Nesse modo, o SDK envia os dados de evento diretamente para o servidor do RudderStack. Em seguida, o RudderStack transforma esses dados e os encaminha para os destinos desejados. Essa transformação é feita no backend do RudderStack usando o módulo de transformação do RudderStack.

Para ativar a integração, você precisará mapear os métodos do RudderStack para o Braze, conforme descrito em métodos suportados.

Modo híbrido

Use o modo híbrido para enviar todos os eventos para o Braze a partir de suas fontes iOS e Android.

Quando você escolhe o modo híbrido para enviar eventos para a Braze, o RudderStack:

1. Inicializa o SDK do Braze.
2. Envia todos os eventos gerados pelo usuário (identificar, rastrear, página, tela e grupo) para o Braze somente pelo modo de nuvem e impede que sejam enviados pelo modo de dispositivo.
3. Envia os eventos gerados automaticamente (mensagens no app, notificações por push que requerem o SDK do Braze) por meio do modo dispositivo.

Para enviar eventos por meio do modo híbrido, use a opção de modo híbrido ao conectar sua origem ao destino do Braze. Em seguida, adicione a integração da Braze ao seu projeto.

Etapa 4: Configurar definições adicionais

Após concluir a configuração inicial, defina as seguintes configurações para receber corretamente seus dados no Braze:

• Ativar grupos de inscrições em chamadas em grupo: Ative essa configuração para enviar o status do grupo de inscrições em seus eventos de grupo. Para saber mais, consulte Grupo.
• Use a operação de atributos personalizados: Ative essa capacitação se quiser usar a funcionalidade de atributos personalizados aninhados no Braze para criar segmentos e personalizar suas mensagens usando um objeto de atributo personalizado. Para saber mais, consulte Enviar características de usuário como atributos personalizados aninhados.
• Rastreamento de eventos para usuários anônimos: Ative essa configuração para rastrear a atividade anônima do usuário e enviar essas informações ao Braze.

Configurações do modo do dispositivo

As configurações a seguir são aplicáveis somente se você estiver enviando eventos para o Braze por meio do modo dispositivo:

• Filtragem de eventos no lado do cliente: Essa configuração permite que você especifique quais eventos devem ser bloqueados ou autorizados a fluir para o Braze. Para saber mais sobre essa configuração, consulte Filtragem de eventos no lado do cliente.
• Desduplicar características: Ative essa configuração para desduplicar as características do usuário na identify chamada.
• Mostrar os registros do Braze: Essa configuração é aplicável somente ao usar o SDK para JavaScript como fonte. Ative-a para mostrar os registros do Braze aos seus usuários.
• Categorias de cookies da OneTrust: Essa configuração permite que você associe os grupos de consentimento de cookies da OneTrust ao Braze.

Métodos suportados

A Braze oferece suporte a estes métodos do RudderStack: identificar, rastrear, tela, página, grupo e alias.

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

Enviar características do usuário como atributos personalizados aninhados

É possível enviar as características do usuário para o Braze como atributos personalizados aninhados e realizar operações de adição, atualização e remoção sobre eles. Para fazer isso, ative a configuração “Use Custom Attributes Operation dashboard” (Usar dashboard de operação de atributos personalizados) no RudderStack ao configurar o destino da Braze. Esse recurso só está disponível no modo de nuvem.

É possível enviar as características do usuário como atributos personalizados aninhados em seus eventos identify no seguinte 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 as características de usuário como atributos personalizados de usuário por meio das chamadas track, page ou screen, passe traits como um campo contextual no 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"
      }
    ]
  }
});