Extensões de segmento 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.
As extensões de segmento 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 segmento CDI não consomem créditos de segmento SQL, não contam para o limite de extensões de segmento 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 segmento CDI dentro das suas extensões de segmento. As extensões de segmento 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 segmento CDI
Etapa 1: Configure sua fonte
Antes de criar sua primeira extensão de segmento CDI, configure uma nova fonte conectada com seu data warehouse seguindo as etapas em Fontes conectadas.
Etapa 2: Crie um segmento
Primeiro, crie uma nova extensão de segmento e selecione Full refresh.
Para a fonte de dados, escolha CDI Data Tables.
Como parte da configuração do CDI, você pode selecionar diferentes conexões para usar nas extensões de segmento CDI. Cada conexão possui 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.
Para visualizar as tabelas de dados disponíveis, incluindo seus esquemas e quaisquer descrições disponíveis, selecione Reference. Quando estiver pronto, selecione uma conexão.
Em seguida, escreva o SQL para o seu segmento usando a sintaxe SQL da Braze.
Lembre-se de que todas as extensões de segmento 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.
external_user_id deve ser um valor do tipo string. Se o ID de origem estiver armazenado como número (por exemplo, client_id como inteiro), converta-o para string no seu SQL para que corresponda ao tipo external_id na Braze.
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 segmento CDI.
Para saber como pré-visualizar suas extensões de segmento, gerenciá-las e executar atualizações automáticas de membros, consulte Extensões de segmento SQL.
Por fim, você pode usar essa extensão de segmento dentro de um Segment da Braze para enviar uma Campaign ou Canvas para esse público.
Considerações
- Uma extensão de segmento pode referenciar dados de apenas uma conexão, não de várias.
- Uma extensão de segmento pode usar uma das seguintes opções como fonte de dados: dados CDI ou dados Braze Snowflake (Currents). Não é possível misturar fontes de dados dentro de uma extensão de segmento, mas você pode criar várias extensões de segmento para referenciar juntas dentro de um segmento.
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.
- Certifique-se de que seu SQL esteja escrito usando a sintaxe apropriada para o seu data warehouse.