Extensões de segmento CDI
Com o Braze Cloud Data Ingestion (CDI), é possível configurar uma conexão direta do seu data warehouse ou sistema de armazenamento de arquivos com o Braze para sincronizar dados de usuários ou catálogos relevantes de forma recorrente.
As extensões de segmento CDI consultam diretamente o seu data warehouse, portanto, você arcará com 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ão de segmento e não realizam registros de pontos de dados.
Pré-requisitos
Para usar os dados do data warehouse para segmentação no espaço de trabalho do Braze, você precisará criar uma fonte conectada e, em seguida, criar um segmento CDI nas extensões de segmento. As extensões de segmento CDI permitem que você escreva SQL que realiza consultas diretas a seu próprio data warehouse usando dados disponibilizados por meio de suas conexões CDI e crie um grupo de usuários que podem ser direcionados no Braze.
Criação de 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: Criar um segmento
Primeiro, crie uma nova extensão de segmento e, em seguida, selecione Full refresh (Atualização completa).
Para sua fonte de dados, selecione Tabelas de dados CDI.
Como parte da configuração do CDI, você pode selecionar entre diferentes conexões para usar nas extensões de segmento do CDI. 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.
Para visualizar as tabelas de dados disponíveis, incluindo seu esquema e quaisquer descrições disponíveis, selecione Referência. Quando estiver pronto, selecione uma conexão.
Em seguida, escreva o SQL para seu segmento usando a sintaxe do Braze SQL.
Lembre-se de que todas as extensões de segmento CDI devem usarexternal_user_id como coluna selecionada, e seuexternal_user_id deve corresponder ao definido no Braze para usuários.
external_user_id deve ser um valor da string. Se o seu ID de origem estiver armazenado como um número (por exemplo,client_idcomo um inteiro), converta-o em uma string no seu SQL para que corresponda aoexternal_idtipo no Braze.
Se os resultados da sua consulta incluírem usuários que não existem no Braze, esses usuários serão ignorados. O Braze não cria novos usuários com base na saída da sua extensão de segmento CDI.
Para saber como obter uma prévia de suas extensões de segmento, gerenciá-las e executar atualizações automáticas de associação, consulte Extensões de segmento SQL.
Por fim, você pode usar essa extensão de segmento em um segmento do Braze para enviar uma campanha ou uma tela para esse público.
Considerações
- Uma extensão de segmento pode fazer referência a 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 do CDI ou dados do Braze Snowflake (Currents). Não é possível misturar fontes de dados em uma extensão de segmento, mas é possível criar várias extensões de segmento para referenciar juntas em um segmento.
Solução de problemas
- Sua consulta poderá atingir o tempo máximo de execução, que é configurado para cada sincronização de conexão na página Ingestão de dados na nuvem. O tempo máximo de execução permitido é de 60 minutos.
- Certifique-se de que seu SQL seja escrito usando a sintaxe apropriada para seu data warehouse.
Editar esta página no GitHub