DinMo
A DinMo é uma plataforma de dados do cliente (CDP) composável que conecta seu data warehouse na nuvem à Braze por meio de ETL reverso (Extract, Transform, Load). As equipes de marketing podem criar segmentos de público a partir de dados do data warehouse, sincronizar atributos de usuário e eventos na Braze e manter os status de inscrição atualizados sem uploads de CSV ou suporte de engenharia.
Essa integração é gerenciada pela DinMo.
A integração entre a Braze e a DinMo envia segmentos e modelos de dados do seu data warehouse para a Braze por meio da REST API da Braze. Quando você conecta um destino Braze na DinMo, as ativações enviam dados dos seus modelos ou segmentos para a Braze.
Pré-requisitos
| Requisito | Descrição |
|---|---|
| Conta DinMo | Uma conta DinMo com permissão para criar destinos é necessária para aproveitar essa parceria. |
| Chave da API REST da Braze | Uma chave da API REST da Braze com as permissões necessárias para os serviços de destino que você planeja usar. Ela pode ser criada no dashboard da Braze em Configurações > Chaves de API. |
| Endpoint REST da Braze | Sua URL de endpoint REST. Seu endpoint depende dos endpoints de API da sua instância da Braze. |
| URL do dashboard da Braze | A URL do dashboard da Braze para a sua instância (por exemplo, https://dashboard.iad-01.braze.com). Para saber mais, consulte Endpoints de SDK disponíveis. |
| Data warehouse e modelo de dados | Antes de iniciar a integração, conecte seu data warehouse no DinMo e defina um modelo ou Segment para os dados que você deseja sincronizar com a Braze. Para saber mais, consulte o guia de integração DinMo com a Braze. |
Casos de uso
Com essa integração, você pode:
- Sincronizar atributos de usuário do seu data warehouse na Braze para personalizar Campaigns e Canvas.
- Enviar eventos personalizados e eventos de compra a partir de dados do data warehouse para a Braze, para direcionamento comportamental.
- Manter a associação ao grupo de inscrições da Braze alinhada com os Segments de público definidos no DinMo.
- Exportar Segments do DinMo como atributos de usuário da Braze e criar Segments da Braze a partir desses atributos.
Permissões da chave de API
Conceda as seguintes permissões na sua chave da API REST da Braze com base nos serviços de destino que você utiliza:
| Permissão | Necessária para |
|---|---|
users.track |
Sincronizar atributos de usuário, enviar eventos de rastreamento e validar a conexão de destino |
users.export.ids |
Exportar IDs de usuário para operações em massa |
users.alias.update |
Atualizar aliases de usuário |
subscription.status.set |
Sincronizar status de inscrição |
users.delete |
Somente modo de sincronização espelhada (opcional para outros serviços de destino) |
Integração
Etapa 1: Configurar o destino da Braze no DinMo
- No DinMo, acesse Destinations na navegação lateral.
- Selecione Add a new destination > Connect a new platform > Braze.
- No formulário de conexão, insira os seguintes dados:
- Platform Name: Por exemplo,
Braze – Your Company - REST API URL: O endpoint REST da sua instância (por exemplo,
https://rest.eu-01.braze.com) - Dashboard URL: A URL do dashboard da sua instância (por exemplo,
https://dashboard.eu-01.braze.com) - API Key: A chave que você copiou da Braze
- Platform Name: Por exemplo,
- Selecione Connect para validar suas credenciais.
Você precisa especificar tanto a URL da REST API quanto a URL do dashboard. Não inclua uma barra final na URL da REST API.
Etapa 2: Verificar a conexão
Depois de salvar o destino, o DinMo realiza uma chamada de teste (por exemplo, users.track) para confirmar que sua chave de API e o endpoint estão funcionando.
Se a validação falhar, confirme o seguinte:
- A URL da REST API está correta e não tem barra final.
- A chave de API é válida e tem as permissões necessárias.
- Se o seu espaço de trabalho da Braze usa uma lista de IPs permitidos, os endereços IP do DinMo estão incluídos.
Serviços de destino compatíveis
Cada serviço de destino na DinMo segue o mesmo fluxo de trabalho geral: criar um destino Braze, criar um modelo ou Segment na DinMo e, em seguida, criar uma ativação para enviar dados à Braze. Para orientações passo a passo sobre ativação, consulte Serviços de destino Braze da DinMo.
Os seguintes serviços de destino estão disponíveis:
| Serviço de destino | Descrição |
|---|---|
| Sincronizar atributos de usuário | Atualiza atributos de perfil de usuário na Braze e, opcionalmente, insere novos usuários. |
| Enviar eventos de rastreamento | Envia eventos personalizados e eventos de compra para a Braze. |
| Sincronizar status de inscrição | Inscreve ou cancela a inscrição de usuários em um grupo de inscrições da Braze com base na associação ao Segment da DinMo. |
| Exportar listas de usuários | Sincroniza a associação ao Segment com um atributo de usuário da Braze para uso na segmentação da Braze. |
Sincronizar atributos de usuário
Use este serviço de destino para atualizar atributos em perfis de usuário existentes na Braze e, opcionalmente, inserir novos usuários.
Ao executar uma ativação:
- Se você ativar o modo de inserção, novos usuários no modelo serão criados na Braze (comportamento UPSERT).
- Valores de atributos alterados desde a última ativação são atualizados na Braze.
Se você não ativar o modo de inserção, a DinMo atualiza apenas os usuários que já existem na Braze e possuem um ID externo correspondente.
Durante a configuração da ativação, mapeie o campo no seu modelo da DinMo que corresponde ao ID externo ou ID da Braze do usuário. Mapeie cada campo da DinMo para o nome exato do atributo na Braze. Se um atributo não existir na Braze, a DinMo o criará.
Os seguintes modos de sincronização estão disponíveis para ativações de atributos de usuário:
| Modo de sincronização | Descrição |
|---|---|
| UPDATE | Atualiza registros alterados para usuários que já existem na Braze. Não insere nem exclui registros. |
| UPSERT | Insere novos registros e atualiza registros alterados. Não exclui registros. |
| MIRROR | Insere, atualiza e exclui registros na Braze para espelhar a origem. Requer suporte do conector para operações de exclusão. |
O modo de sincronização MIRROR exclui permanentemente registros da Braze quando eles não estão mais presentes na origem da DinMo. Use o modo MIRROR apenas quando seu data warehouse for a única fonte de verdade e as exclusões forem intencionais. Valide as regras de exclusão antes de executar sincronizações MIRROR em produção.
Enviar eventos de rastreamento
Use este serviço de destino para enviar eventos personalizados ou eventos de compra de um modelo de eventos ou Segment da DinMo para a Braze. A DinMo trata eventos personalizados e compras como serviços de destino separados porque a Braze usa APIs diferentes para cada tipo.
Cada registro no modelo representa um único tipo de evento (por exemplo, Purchase). A DinMo envia apenas novos eventos em cada execução de ativação e não atualiza eventos enviados anteriormente.
Durante a configuração da ativação:
- Especifique o nome do evento exatamente como ele deve aparecer na Braze. Se o evento não existir, a DinMo o criará.
- Mapeie os campos obrigatórios:
- Horário do evento: Timestamp de quando o evento ocorreu
- ID externo: ID externo do usuário associado ao evento
- Mapeie propriedades opcionais do evento para nomes de atributos da Braze.
- Defina o cronograma de frequência com que novos eventos são enviados para a Braze.
Sincronizar status de inscrição
Use este serviço de destino para manter um grupo de inscrições da Braze alinhado com um Segment ou modelo da DinMo.
Antes de ativar este serviço:
- Crie o grupo de inscrições de destino (SMS ou e-mail) na Braze.
- Crie um modelo ou Segment na DinMo contendo os usuários que devem pertencer a esse grupo de inscrições.
Durante a configuração da ativação, insira o ID exato do grupo de inscrições da Braze. Para sincronizar vários grupos de inscrições, crie uma ativação por grupo.
Quando a ativação é executada:
- Se os usuários já existirem na Braze, os usuários que entrarem no Segment da DinMo serão marcados como inscritos no grupo de inscrições de destino.
- Os usuários que saírem do Segment da DinMo serão marcados como não inscritos no grupo de inscrições.
A DinMo não modifica usuários que nunca fizeram parte do Segment e não cria novos usuários na Braze neste serviço de destino.
Exportar listas de usuários
Use este serviço de destino para representar um Segment da DinMo como um atributo de usuário da Braze. Devido a uma limitação da Braze, a DinMo não cria uma lista da Braze diretamente. Em vez disso, ela define um atributo de usuário como true para os usuários no Segment e false para os usuários que saem do Segment.
Durante a configuração da ativação, especifique o nome do público. A DinMo usa esse nome como o atributo da Braze (espaços são substituídos por underscores). Confirme que um atributo com o mesmo nome ainda não existe na Braze. Mapeie o campo da DinMo que corresponde ao ID externo do usuário.
Após a execução da ativação, crie um Segment na Braze que filtre os usuários em que o atributo sincronizado seja igual a true.
Apenas usuários com um ID externo que corresponda a um usuário existente na Braze são atualizados. Este serviço de destino não cria novos usuários.