Segmento

A Segment é uma plataforma de dados do cliente que ajuda você a coletar, limpar e ativar os dados de seus clientes.

A integração do Braze e do Segment permite rastrear seus usuários e encaminhar dados para vários provedores de análise de dados de usuários. O Segment permite que você:

• Sincronize o Segment Engage com o Braze para uso na campanha do Braze e na segmentação do Canva.
• Importar dados entre as duas plataformas. Oferecemos uma integração lado a lado de SDK para seus aplicativos Android, iOS e da Web e uma integração de servidor para servidor para sincronizar seus dados com as APIs REST do Braze.
• Conecte os dados à Segment pelo Currents.

Pré-requisitos

Integração

Para integrar o Braze e o Segment, você deve definir o Braze como um destino de acordo com o tipo de integração escolhido (modo de conexão). Se você for um cliente novo no Braze, poderá retransmitir dados históricos para o Braze usando replays de segmentos. Em seguida, você deve configurar mapeamentos e testar sua integração para garantir um fluxo de dados suave entre o Braze e o Segment.

Etapa 1: crie um destino da Braze

Depois de configurar suas fontes com êxito, você precisará configurar a Braze como um destino para cada fonte (iOS, Android, Web etc.). Você terá muitas opções para personalizar o fluxo de dados entre o Braze e o Segment usando as configurações de conexão.

Etapa 2: escolha a estrutura do destino e o tipo de conexão

No Segment, navegue até Destinos > Braze > Configurar o Braze > Selecione sua fonte > Configuração.

Você pode integrar o código-fonte da Web da Segment (Analytics.js) e as bibliotecas nativas do lado do cliente com a Braze usando uma integração lado a lado (modo dispositivo) ou uma integração servidor a servidor (modo nuvem).

Sua escolha do modo de conexão será determinada pelo tipo de fonte para o qual o destino está configurado.

Integração lado a lado de SDK

Também chamada de modo dispositivo, essa integração mapeia o SDK e os métodos da Segment para o SDK da Braze, permitindo o acesso a todos os recursos do nosso SDK, como push, envio de mensagens no app e outros métodos nativos da Braze.

Ao usar uma conexão no modo dispositivo, semelhante à integração nativa do Braze SDK, o Braze SDK atribuirá um device_id e um identificador de backend, braze_id, a cada usuário. Isso permite que o Braze capture a atividade anônima do dispositivo fazendo a correspondência com esses identificadores em vez de userId.

• android
• ios
• web or javascript
• react native

Integração de servidor para servidor

Também chamada de modo de nuvem, essa integração encaminha dados do Segment para as APIs REST do Braze. Use a estrutura do Braze Cloud Mode (Actions) do Segment para configurar um destino em modo de nuvem para qualquer uma de suas origens.

Diferentemente da integração lado a lado, a integração servidor a servidor não oferece suporte aos recursos da interface do usuário do Braze, como envio de mensagens no app, cartões de conteúdo ou registro automático de token por push. Também existem dados capturados automaticamente (como usuários anônimos e campos no nível do dispositivo) que não estão disponíveis no modo de nuvem.

Se quiser usar esses dados e recursos, considere adotar a integração lado a lado (modo de dispositivo) do SDK.

O código-fonte do destino Braze Cloud Mode (Actions) é mantido pela Segment.

Etapa 3: Configurações

Defina as configurações para seu destino. Nem todas as configurações se aplicarão a todos os tipos de destinos.

• mobile device-mode
• web device-mode
• cloud-mode

Etapa 4: métodos de mapas

O Braze oferece suporte aos métodos Page, Identify e Track Segment. Os tipos de identificadores usados nesses métodos dependerão do fato de os dados estarem sendo enviados por meio de uma integração servidor a servidor (modo nuvem) ou lado a lado (modo dispositivo). Nos destinos Braze Web Mode Actions e Cloud Mode Actions, você também pode optar por configurar um mapeamento para uma chamada de alias da Segment.

O destino Modo de nuvem (Ações) oferece uma ação Criar alias que pode ser usada para criar um usuário somente de alias ou adicionar um alias a um perfil external_id existente. A ação Identificar usuário pode ser usada juntamente com a ação Criar alias para mesclar um usuário somente de alias com um external_id depois que um estiver disponível para o usuário.

Também é possível criar uma solução alternativa e usar o braze_id para enviar dados de usuários anônimos no modo de nuvem. Para isso, é necessário incluir manualmente o endereço braze_id do usuário em todas as suas chamadas à API do Segment. Você pode saber mais sobre como configurar essa solução alternativa na documentação do Segment.

Os dados de destinos enviados à Braze podem ser agrupados em ações do modo de nuvem. Os tamanhos dos lotes são limitados a 75 eventos, e esses lotes se acumulam em um período de 30 segundos antes de serem descarregados. O agrupamento de solicitações é feito por ação. Por exemplo, as chamadas de identificação (atribuições) serão agrupadas em uma solicitação e as chamadas de rastreamento (eventos personalizados) serão agrupadas em uma segunda solicitação. A Braze recomenda ativar esse recurso, pois ele reduz o número de solicitações enviadas da Segment para a Braze. Por sua vez, isso reduzirá o risco de o destino atingir os limites de frequência do Braze e tentar novamente as solicitações.

Você pode ativar a criação de lotes para uma ação em Braze Destination > Mappings (Destino da Braze > Mapeamentos). A partir daí, clique no ícone de três pontos à direita do mapeamento e selecione Editar mapeamento. Role até a parte inferior da seção Select mappings (Selecionar mapeamentos ) e verifique se a opção Batch Data to Braze está definida como Yes (Sim).

• identify
• track
• page

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
analytics.identify(
  userId: "{your-user}",
  traits: [
    "braze_subscription_groups": [
      [
        "subscription_group_id": "{your-group-id}",
        "subscription_group_state": "subscribed"
      ],
      [
        "subscription_group_id", "{your-group-id}",
        "subscription_group_state": "unsubscribed"
      ]
    ]
  ]
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
analytics.identify(
  "{your-user}",
  buildJsonObject {
    put("braze_subscription_groups", buildJsonArray {
        add(
          buildJsonObject {
            put("subscription_group_id", "{your-group-id}")
            put("subscription_group_state", "subscribed")
          }
        )
        add(
          buildJsonObject {
            put("subscription_group_id", "{your-group-id}")
            put("subscription_group_state", "unsubscribed")
          }
        )
      }
    )
  }
)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
analytics.identify(
  "{your-user}",
  {
    braze_subscription_groups: [
      {
        subscription_group_id: "{your-group-id}",
        subscription_group_state: "subscribed"
      },
      {
        subscription_group_id: "{your-group-id}",
        subscription_group_state: "unsubscribed"
      }
    ]
  }
)

Etapa 5: Teste sua integração

Ao usar a integração lado a lado (modo de dispositivo), suas métricas de visão geral (sessões vitalícias, MAU, usuário ativo diário, aderência, sessões diárias e sessões diárias por MAU) podem ser usadas para assegurar que a Braze receba dados da Segment.

Você pode visualizar seus dados nas páginas de eventos personalizados ou de receita, ou criando um segmento. A página Eventos personalizados do dashboard permite que você visualize as contagens de eventos personalizados ao longo do tempo. Observe que você não poderá usar fórmulas que incluam estatísticas de MAU e DAU ao usar uma integração de servidor para servidor (modo de nuvem).

Se estiver enviando dados de compra para o Braze (veja o pedido concluído na guia Rastreamento da etapa 3), a página de receita permite visualizar dados sobre receita ou compras em períodos específicos ou a receita total do seu app.

A criação de um segmento permite filtrar os usuários com base nos dados de eventos e atributos personalizados.

Exclusão e supressão de usuários

Se precisar excluir ou suprimir usuários, note que o recurso de exclusão de usuários do Segment é mapeado para o endpoint /users/delete da Braze. Observe que a verificação dessas exclusões pode levar até 30 dias.

É necessário selecionar um identificador de usuário comum entre a Braze e a Segment (como em external_id). Depois de iniciar uma solicitação de exclusão com o Segment, você pode visualizar o status na guia solicitações de exclusão no dashboard do Segment.

Repetições de segmentos

A Segment presta um serviço aos clientes para “reproduzir” todos os dados históricos em um novo parceiro de tecnologia. Os novos clientes da Braze que desejarem importar todos os dados históricos relevantes poderão fazê-lo por meio da Segment. Fale com seu representante da Segment se isso for algo de seu interesse.

O Segment se conectará ao nosso endpoint/users/track para importar dados de usuários para o Braze em seu nome.

Melhores práticas