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 a Braze. Ele está pronto para empresas e oferece uma estrutura de transformação robusta para processar seus dados de eventos de forma dinâmica.

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 a partir dos seus serviços de backend.

Pré-requisitos

Integração

Etapa 1: Adicionar uma fonte

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

Etapa 2: Configurar o destino

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

No destino 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 modo de dispositivo). A opção de SDK nativo usará o SDK nativo da Braze para enviar eventos, se estiver ativada.

Etapa 3: Escolher o tipo de integração

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

• Integração lado a lado / modo de dispositivo: o RudderStack enviará os dados de eventos para a Braze diretamente do seu cliente (navegador ou aplicativo móvel).
• Servidor para servidor / modo de nuvem: o SDK da Braze envia os dados de eventos diretamente para o RudderStack, que os transforma e encaminha para a Braze.
• Modo híbrido: use o modo híbrido para enviar eventos gerados automaticamente e por usuários do iOS e Android para a Braze usando uma única conexão.

Nota

Para saber mais sobre os modos de conexão do RudderStack e os benefícios de cada um.

Integração lado a lado (modo de dispositivo)

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

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

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

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

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

Nesse modo, o SDK envia os dados de eventos diretamente para o servidor do RudderStack. O RudderStack então transforma esses dados e os encaminha para o destino desejado. Essa transformação é feita no backend do RudderStack usando o módulo transformer do RudderStack.

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

Nota

Os SDKs do lado do servidor do RudderStack (Java, Python, Node.js, Go, Ruby) suportam apenas o modo de nuvem. Isso ocorre porque seus SDKs do lado do servidor operam no backend do RudderStack e não podem carregar nenhum SDK específico da Braze.

Importante

A integração servidor para servidor não suporta recursos de interface da Braze, como notificações por push ou envio de mensagens no app. Esses recursos são, no entanto, suportados pela integração no modo de dispositivo.

Modo híbrido

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

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

1. Inicializa o SDK da Braze.
2. Envia todos os eventos gerados pelo usuário (identify, track, page, screen e group) para a Braze apenas pelo modo de nuvem, bloqueando o envio pelo modo de dispositivo.
3. Envia os eventos gerados automaticamente (mensagens no app, notificações por push que exigem o SDK da Braze) pelo modo de dispositivo.

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

Etapa 4: Definir configurações adicionais

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

• Enable subscription groups in group call: Ative essa configuração para enviar o status do grupo de inscrições nos seus eventos de grupo. Para saber mais, consulte Group.
• Use Custom Attributes Operation: Ative essa configuração se quiser usar a funcionalidade de atributos personalizados aninhados na Braze para criar Segments e personalizar suas mensagens usando um objeto de atributo personalizado. Para saber mais, consulte Send user traits as nested custom attributes.
• Track events for anonymous users: Ative essa configuração para rastrear a atividade de usuários anônimos e enviar essas informações para a Braze.

Configurações de modo de dispositivo

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

• Client-side Events Filtering: Essa configuração permite especificar quais eventos devem ser bloqueados ou permitidos para fluir até a Braze. Para saber mais sobre essa configuração, consulte Client-side Events Filtering.
• Deduplicate Traits: Ative essa configuração para deduplicar os traços de usuário na chamada identify.
• Show Braze logs: Essa configuração é aplicável somente ao usar o SDK JavaScript como fonte. Ative-a para exibir os logs da Braze para os seus usuários.
• OneTrust Cookie Categories: Essa configuração permite associar os grupos de consentimento de cookies do OneTrust à Braze.

Métodos compatíveis

A Braze oferece suporte aos métodos RudderStack identify, track, screen, page, group e alias.

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

Enviar características de usuários como atributos personalizados aninhados

Você pode enviar as características de usuários para a Braze como atributos personalizados aninhados e realizar operações de adição, atualização e remoção neles. Para isso, ative a configuração “Use Custom Attributes Operation dashboard” no RudderStack ao configurar o destino Braze. Esse recurso está disponível apenas no modo cloud.

Você pode enviar as características de usuários como atributos personalizados aninhados nos 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": "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 as características de usuários como atributos personalizados 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": "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 as operações de atualização e remoção, identifier é uma chave obrigatória. Se as operações de adição, atualização ou remoção não estiverem presentes no array aninhado, o RudderStack usará a operação de criação para criar as propriedades por padrão. Consulte Array de objetos para saber mais sobre o envio de atributos personalizados aninhados.

Solução de problemas

Vejo “[Braze Deduplication]: Duplicate user detected, the user is dropped” nos logs do RudderStack

Essa mensagem vem do RudderStack quando a opção Deduplicate Traits está ativada e o RudderStack descarta traits de usuário que não foram alterados antes de encaminhá-los para a Braze. Não se trata de um erro da Braze.

O RudderStack compara os traits recebidos via identify e track com o perfil de usuário e ignora atributos sem alterações para reduzir o uso de pontos de dados da Braze. Para saber mais, consulte o guia do RudderStack sobre User Trait Deduplication in Braze.

Se você precisa que todos os traits sejam enviados em cada chamada, desative a opção Deduplicate Traits nas configurações do destino Braze no RudderStack. Tenha em mente que isso pode aumentar o consumo de pontos de dados da Braze.