Comparar opções de ingestão de dados persistente e zero-copy
Antes de projetar seus pipelines de ingestão, escolha como os dados do seu warehouse ou aplicativos chegam à Braze. Eles podem ser copiados para perfis de usuário, consultados diretamente para segmentação ou passados de forma transitória para um Canvas.
Sobre este exemplo
A MovieCanon é um serviço fictício de streaming de filmes. Ela centraliza dados de clientes, ingressos e visualizações em um data warehouse. A equipe de dados precisa decidir como enviar dados para a Braze em três necessidades comuns:
- Dados de perfil: Atributos de nível de fidelidade, LTV e preferência de gênero ou formato que permanecem salvos nos perfis de usuário da Braze.
- Criação de público: Segmentos baseados em SQL criados a partir de tabelas do data warehouse, sem copiar todas as colunas para a Braze.
- Envio de mensagens disparadas: Linhas do data warehouse que devem entrar em um Canvas com personalização específica de cada linha, que não precisa ficar salva no perfil.
A Braze oferece quatro jornadas principais de ingestão. As sincronizações padrão de Cloud Data Ingestion (CDI) e a API /users/track salvam os dados nos perfis. Os segmentos de CDI (Connected Sources) e os gatilhos de Canvas de CDI são opções de cópia zero: os dados permanecem no seu data warehouse e não são gravados nos perfis de usuário da Braze.
Use esta comparação ao planejar a arquitetura, dimensionar a taxa de transferência ou explicar as vantagens e desvantagens de cada opção para as equipes de engenharia e marketing. Ela não substitui os guias de configuração da integração de cada opção.
Considerações
- O Cloud Data Ingestion é um recurso abrangente. As sincronizações padrão do CDI copiam dados para os perfis da Braze, de forma semelhante ao
/users/track. Já os CDI Segments e os gatilhos do Canvas do CDI mantêm os dados no data warehouse, sem gravá-los nos perfis de usuário da Braze. - As sincronizações recorrentes do CDI podem ser executadas a cada 5 minutos ou apenas uma vez por mês. Por padrão, o menor intervalo que você pode definir no dashboard é de 15 minutos. Isso ajuda a controlar os custos de computação do data warehouse e o volume de solicitações. Para sincronizar a cada 5 minutos, entre em contato com o suporte da Braze ou com seu gerente de sucesso do cliente. Para sincronizar assim que seus dados mudarem, chame o endpoint Disparar uma sincronização quando o carregamento do data warehouse terminar. Consulte Braze Cloud Data Ingestion.
- Os gatilhos do Canvas do CDI compartilham o limite de frequência da REST API do
/canvas/trigger/sendcom o restante do tráfego para esse endpoint. O/users/tracktem seus próprios limites e regras de envio em lote. Os limites padrão podem ser aumentados. Acesse Configurações > APIs e identificadores > Limites de API e consulte Limites de frequência da API. - As fontes conectadas e as extensões de segmento CDI executam consultas no seu data warehouse. Você arca com o custo de computação do data warehouse, e a Braze não registra pontos de dados para essas consultas. Consulte Fontes conectadas.
Configuração
Etapa 1: Associe seu caso de uso a um caminho de ingestão
Associe seu objetivo ao caminho de ingestão recomendado e veja se esse caminho grava dados nos perfis da Braze.
| Seu objetivo | Caminho recomendado | Grava no perfil? |
|---|---|---|
| Persistir atributos, eventos, compras ou itens de catálogo do data warehouse | Sincronização padrão de CDI | Sim (os dados são copiados para os perfis ou catálogos da Braze) |
| Criar públicos a partir de SQL do data warehouse sem copiar as tabelas de origem para a Braze | CDI Segments (fontes conectadas) | Não (somente associação) |
| Inserir usuários em um Canvas com contexto de linha do data warehouse que não deve persistir no perfil | Gatilhos de Canvas do CDI | Não (propriedades de contexto do Canvas transitórias) |
| Enviar dados de apps, servidores ou pipelines de streaming quase em tempo real | /users/track (ou SDKs) |
Sim (os dados persistem nos perfis) |
Etapa 2: Compare persistência, latência e throughput
Compare como cada caminho lida com residência de dados, latência, throughput e criação de usuários.
| Dimensão | Sincronização padrão de CDI | CDI Segments | Gatilhos de Canvas do CDI | /users/track |
|---|---|---|---|---|
| O que faz | Leitura agendada de uma tabela do data warehouse; grava atributos, eventos, compras, exclusões de usuários ou catálogos | A Braze consulta seu data warehouse para extensões de segmento SQL | Linhas do data warehouse disparam a entrada no Canvas com o contexto da linha como propriedades de contexto do Canvas | Apps, servidores ou pipelines de streaming gravam atributos, eventos e compras nos perfis |
| Residência de dados | Copiados e persistidos nos perfis da Braze | Permanecem no seu data warehouse; nada é gravado nos perfis | As propriedades de contexto do Canvas são transitórias; não persistem nos perfis | Copiados e persistidos nos perfis da Braze |
| Latência típica | É executada em um cronograma (a cada 5 minutos, no mínimo; 15 minutos por padrão) ou sob demanda pelo endpoint Disparar uma sincronização. A atualização dos dados no data warehouse também influencia. | É atualizada de acordo com o cronograma da sua extensão de segmento. A associação reflete os dados do data warehouse da última atualização. | É executada no cronograma de sincronização (a cada 5 minutos, no mínimo; 15 minutos por padrão). | Quase em tempo real (processamento assíncrono) |
| Observações sobre throughput | Resultado completo da consulta por sincronização; a Braze agrupa internamente em lotes para /users/track, /users/delete ou endpoints de catálogo |
Limite de tempo de execução da consulta de 60 minutos por fonte conectada; sem limite de objetos por solicitação | Compartilha o limite de frequência de /canvas/trigger/send; aproximadamente 3,75 milhões de entradas no Canvas por hora por execução de sincronização |
Até 75 objetos combinados por solicitação; consulte limites de frequência da API |
| Tamanho do lote | Sem limite de objetos no lado do CDI para leituras do data warehouse | N/A (o resultado da consulta define a associação) | Uma entrada no Canvas por linha do data warehouse por execução de sincronização | 75 atributos, eventos e compras combinados por solicitação (padrão) |
| Criação de usuários | Sim, a menos que a opção de atualizar somente existentes esteja definida | Não (usuários desconhecidos nos resultados da consulta são ignorados) | Não (somente usuários existentes da Braze) | Sim, a menos que _update_existing_only seja true |
Etapa 3: Compare os requisitos de esquema e identificadores
Compare as colunas obrigatórias e os identificadores compatíveis de cada caminho. Configure um tipo de dado por sincronização padrão de CDI (por exemplo, atributos em uma integração e eventos em outra).
| Dimensão | Sincronização padrão de CDI | CDI Segments | Gatilhos de Canvas do CDI | /users/track |
|---|---|---|---|---|
| Colunas obrigatórias / formato | Identificador do usuário + UPDATED_AT + PAYLOAD (JSON) por linha |
O SQL deve retornar somente external_user_id |
Identificador + UPDATED_AT + PROPERTIES (JSON; use {} quando vazio) |
Corpo de solicitação padrão de /users/track |
| Identificadores compatíveis | external_id, alias de usuário, braze_id, e-mail ou telefone |
Somente external_user_id (string) |
Somente external_id ou alias de usuário |
external_id, alias de usuário, braze_id, e-mail ou telefone |
Etapa 4: Implemente o caminho escolhido
- Sincronização padrão de CDI: Crie uma tabela ou visualização no data warehouse e siga as etapas de configuração da sua fonte de ingestão de dados na nuvem e da configuração da tabela.
- CDI Segments: Adicione uma fonte conectada e crie uma extensão de segmento CDI.
- Gatilhos de Canvas do CDI: Configure uma tabela de origem com
PROPERTIES, crie e lance um Canvas de destino e, em seguida, crie uma sincronização conforme Personalização com cópia zero usando CDI. /users/track: Envie solicitações a partir do seu aplicativo ou middleware. Formate as cargas úteis conforme POST: Criar e atualizar usuários.
Para a MovieCanon, um padrão comum é: sincronizações padrão de CDI para o enriquecimento noturno de perfis, CDI Segments para regras de público que ficam só no data warehouse, gatilhos de Canvas para jornadas de status de ingressos ou de visualização com contexto por linha e /users/track para eventos do app em tempo real.