Extensões de Segment CDI

Com a ingestão de dados na nuvem (CDI) da Braze, você pode configurar uma conexão direta do seu data warehouse ou sistema de armazenamento de arquivos com a Braze para sincronizar dados relevantes de usuários ou catálogos de forma recorrente.

Aviso

As extensões de Segment CDI consultam seu data warehouse diretamente, então você incorrerá em todos os custos associados à execução dessas consultas no seu data warehouse. As extensões de Segment CDI não consomem créditos de Segment SQL, não contam para o limite de extensões de Segment e não registram pontos de dados.

Pré-requisitos

Para usar os dados do seu data warehouse para segmentação dentro do seu espaço de trabalho da Braze, você precisará criar uma fonte conectada e, em seguida, criar um Segment CDI dentro das suas extensões de Segment. As extensões de Segment CDI permitem que você escreva SQL que consulta diretamente o seu próprio data warehouse usando dados disponibilizados por meio das suas conexões CDI, e crie um grupo de usuários que pode ser direcionado dentro da Braze.

Criando um Segment CDI

Etapa 1: Configure sua fonte

Antes de criar sua primeira extensão de Segment CDI, configure uma nova fonte conectada com seu data warehouse seguindo as etapas em Fontes conectadas.

Etapa 2: Crie um Segment

1. Acesse Público > Extensões de Segment e selecione Criar Nova Extensão.
2. No menu Selecione sua experiência de criação de extensão de Segment, selecione Atualização completa (incluindo Segments CDI).

3. No menu Selecione a fonte de dados para esta extensão de Segment, escolha Tabelas de Dados CDI. Esse menu aparece somente depois que você configura pelo menos uma fonte conectada.

4. Selecione uma conexão para usar e escreva sua consulta. Cada conexão tem um conjunto específico de tabelas de dados. Sua equipe de desenvolvimento pode configurar suas conexões e tabelas de dados durante a configuração do CDI.
5. Visualize as tabelas de dados disponíveis, incluindo seus esquemas e descrições disponíveis, selecionando Explorador de Fontes.

6. Escreva o SQL para seu Segment usando a sintaxe SQL da Braze. Lembre-se de que todas as extensões de Segment CDI devem usar external_user_id como a coluna selecionada, e seu external_user_id deve corresponder ao definido na Braze para os usuários.
   
   Se os resultados da sua consulta incluírem usuários que não existem na Braze, esses usuários serão ignorados. A Braze não cria novos usuários com base na saída da sua extensão de Segment CDI.

Importante

external_user_id deve ser um valor da string. Se o ID da sua fonte estiver armazenado como número (por exemplo, client_id como um inteiro), converta-o para string no seu SQL para que corresponda ao tipo external_id na Braze.

7. Use esta extensão de Segment dentro de um Segment da Braze para enviar uma Campaign ou Canvas para esse público.

Dica

Para saber como você pode pré-visualizar suas extensões de Segment, gerenciá-las e executar atualizações automáticas de participação, consulte Extensões de Segment SQL.

Considerações

• Uma extensão de Segment pode referenciar dados de apenas uma conexão, não de várias.
• Uma extensão de Segment pode usar uma das seguintes opções como fonte de dados: dados de CDI ou dados da Braze Snowflake (Currents). Não é possível misturar fontes de dados dentro de uma extensão de Segment, mas você pode criar várias extensões de Segment para referenciar juntas dentro de um Segment.

Solução de problemas

• Sua consulta pode expirar ao atingir o tempo máximo de execução, que é configurado para cada sincronização de conexão na página Cloud Data Ingestion. O tempo máximo de execução permitido é de 60 minutos.
• Verifique se o SQL está escrito usando a sintaxe apropriada para o seu data warehouse.