Personalização sem cópia usando CDI

Aprenda a sincronizar gatilhos do Canvas usando CDI para personalização sem cópia. Esse recurso acessa informações específicas do usuário na sua solução de armazenamento de dados e as transmite para um Canvas de destino. As etapas do Canvas podem incluir, opcionalmente, campos de personalização que não ficam salvos nos perfis de usuário da Braze.

Sincronização de gatilhos de Canvas

Etapas de início rápido

Se você já conhece o CDI da Braze, a configuração de uma sincronização de gatilhos de Canvas segue o mesmo processo das sincronizações de dados de usuários na mesma fonte, com as seguintes ressalvas:

• Só há suporte para identificadores de ID externo ou alias de usuário. E-mail e número de telefone não são identificadores compatíveis.
• Só é possível sincronizar usuários que já existem na Braze. Não é possível criar novos usuários.
• PROPERTIES substitui a coluna PAYLOAD. Ela é uma string JSON com os campos que você quer usar como propriedades de entrada do Canvas para personalização.

Para começar, selecione o tipo de dados Gatilhos de Canvas ao criar uma nova sincronização.

Etapa 1: Configure a fonte de dados para gatilhos de Canvas

Para ver a tabela de origem ou o formato de arquivo da sua fonte, abra a página da fonte e selecione a guia Gatilhos de Canvas. Conclua também a configuração de credenciais e de rede nessa página.

Se você já tiver credenciais de uma sincronização existente, pode reutilizá-las. Só não se esqueça de estender o acesso à tabela de origem dos gatilhos de Canvas.

Etapa 2: Configure seu Canvas de destino

1. Configure seu Canvas de destino para gatilhos de Canvas. Crie um novo Canvas disparado por API ou selecione um existente. Consulte Tipos de cronograma de entrada para saber como criar um Canvas com o tipo de cronograma de entrega disparado por API.
2. Depois de selecionar o tipo de cronograma de entrega disparado por API, continue a configuração e monte seu Canvas. Os Canvas podem ir de envios simples, com uma única mensagem, até fluxos complexos para clientes com várias etapas.
3. Nas etapas do Canvas, use as propriedades de entrada do Canvas para personalizar mensagens com os campos de propriedades que você pretende sincronizar a partir da tabela de origem.
   • Por exemplo, se na Etapa 1 você instrumentou um campo de propriedades para account_balance, use o seguinte template Liquid para personalizar sua mensagem: \{\{canvas_entry_properties.\$\{account_balance\}\}\}.
4. Depois de montar o Canvas, lance-o e siga para a Etapa 3.

Etapa 3: Crie sua sincronização zero-copy

Com a configuração da fonte concluída e o Canvas de destino lançado, crie uma nova sincronização de dados:

1. Na Braze, acesse Configurações de dados > Ingestão de dados na nuvem.
2. Configure a conexão informando os detalhes de conexão (ou reutilize credenciais existentes) e a tabela de origem da Etapa 1.
3. Dê um nome para a integração.
4. Selecione o tipo de dados Gatilhos de Canvas.
5. Escolha seu Canvas de destino (da Etapa 2).
6. Escolha uma frequência de sincronização.
7. Configure as preferências de notificação.
8. Selecione Testar conexão para confirmar que tudo funciona como esperado. Se estiver se conectando ao Snowflake, primeiro adicione a chave pública exibida no dashboard ao usuário criado para a Braze se conectar ao Snowflake. Para concluir esta etapa, você precisa de acesso SECURITYADMIN ou superior no Snowflake.
9. Salve a sincronização para começar a sincronizar os gatilhos de Canvas.

Quando a sincronização é executada, os usuários da sua tabela de origem começam a entrar no Canvas. Use a análise de dados do Canvas e a página de logs de sincronização da Ingestão de dados na nuvem para monitorar o desempenho.

Dica

Revise toda a sua configuração (do comportamento da sincronização à configuração do Canvas) para evitar envios inesperados. Configurações do Canvas, como limitação de taxa, limite de frequência e filtros de segmentação, podem refinar ainda mais a entrega das mensagens.

A Braze recomenda fazer um teste com um público pequeno ou de teste antes de implementar casos de uso em produção.

Considerações

Os gatilhos de Canvas do CDI usam o limite de frequência da sua REST API para /canvas/trigger/send. Se você usar esse endpoint ao mesmo tempo com os gatilhos de Canvas do CDI e com a sua integração da REST API, o uso combinado será contabilizado no seu limite de frequência.

Cada execução de sincronização insere usuários no Canvas de destino correspondente a uma taxa máxima de aproximadamente 3,75 milhões de usuários por hora. Espere tempos maiores entre a fonte e a entrada no Canvas quando:

• Sincronizar mais de 3,75 milhões de usuários por execução de sincronização.
• Usar gatilhos de Canvas do CDI quando o limite de frequência para /canvas/trigger/send da sua REST API já estiver saturado.

Considere os seguintes pontos sobre o CDI zero-copy quando o Arquivamento de mensagens estiver ativado:

• Os resultados da tabela ficam armazenados temporariamente na Braze durante o processamento. Eles também são exportados para o Snowflake por 30 dias, para que você possa ver exatamente o que foi sincronizado.
• As mensagens arquivadas não são salvas em nenhum lugar da Braze. As cópias são enviadas para armazenamento exclusivo no armazenamento que você configurou.
• Ao usar o CDI zero-copy com gatilhos de Canvas, a Braze não armazena um backup dos resultados da consulta do data warehouse, e nenhum dado é copiado para o perfil de usuário.
• As propriedades de contexto do Canvas podem ficar registradas em sistemas internos por até 30 dias.