Comparar opções de ingestão de dados persistente e zero-copy
Escolha como os dados do seu warehouse ou aplicativos chegam à Braze — se são copiados para perfis de usuário, consultados diretamente para segmentação ou passados de forma transitória para um Canvas — antes de projetar seus pipelines de ingestão.
Sobre este exemplo
MovieCanon é um serviço fictício de streaming de filmes. Ele centraliza dados de clientes, ingressos e visualizações em um warehouse. A equipe de dados precisa decidir como alimentar a Braze para três necessidades comuns:
- Dados de perfil: Atributos de nível de fidelidade, valor do tempo de vida e preferências de gênero ou formato que persistem nos perfis de usuário da Braze.
- Criação de públicos: Segments baseados em SQL a partir de tabelas do warehouse, sem copiar cada coluna para a Braze.
- Envio de mensagens acionado: Linhas do warehouse que devem entrar em um Canvas com personalização específica por linha, sem necessidade de armazenar esses dados no perfil.
A Braze oferece quatro caminhos principais de ingestão. As sincronizações padrão de ingestão de dados na nuvem (CDI) e a API /users/track persistem dados nos perfis. Os CDI Segments (Connected Sources) e os acionadores de CDI para Canvas são opções zero-copy: os dados do warehouse permanecem no seu warehouse e não são gravados nos perfis de usuário da Braze.
Use essa comparação ao planejar arquitetura, dimensionar throughput ou explicar as compensações para as partes interessadas de engenharia e marketing. Ela não substitui os guias de configuração de integração de cada opção.
Considerações
- A Ingestão de Dados na Nuvem é um recurso abrangente. As sincronizações padrão de CDI copiam dados para os perfis da Braze (semelhante ao
/users/track). Os CDI Segments e os gatilhos de CDI para Canvas mantêm os dados no warehouse sem gravá-los nos perfis de usuário da Braze. - As sincronizações recorrentes de CDI podem ser executadas com frequência de até 5 minutos ou tão raramente quanto uma vez por mês. Por padrão, o intervalo mais curto que você pode definir no dashboard é de 15 minutos, o que ajuda a gerenciar os custos de computação do warehouse e o volume de solicitações. Para sincronizar com frequência de até 5 minutos, entre em contato com o suporte da Braze ou com o seu gerente de sucesso do cliente. Para sincronizar assim que seus dados mudarem, chame o endpoint Disparar uma sincronização quando o carregamento do warehouse terminar. Consulte Ingestão de Dados na Nuvem da Braze.
- Os gatilhos de CDI para Canvas compartilham o limite de frequência da REST API
/canvas/trigger/sendcom outros tráfegos para esse endpoint. O/users/tracktem seus próprios limites e regras de lote. Os limites padrão podem ser aumentados. Acesse Configurações > APIs e Identificadores > Limites da API e consulte Limites de frequência da API. - As Fontes Conectadas e as extensões de segmento de CDI executam consultas no seu warehouse. Você incorre em custos de computação do warehouse; a Braze não registra pontos de dados para essas consultas. Consulte Fontes conectadas.
Configuração
Etapa 1: Mapeie seu caso de uso para um caminho de ingestão
Associe seu objetivo ao caminho de ingestão recomendado e se esse caminho grava 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 CDI padrão | Sim (os dados são copiados para os perfis ou catálogos da Braze) |
| Criar públicos a partir de SQL do warehouse sem copiar tabelas de origem para a Braze | CDI Segments (Connected Sources) | Não (somente associação) |
| Inserir usuários em um Canvas com contexto de linha do warehouse que não deve persistir no perfil | Disparadores de Canvas por CDI | Não (propriedades de contexto de Canvas transitórias) |
| Enviar dados de apps, servidores ou pipelines de streaming em tempo quase 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 CDI padrão | CDI Segments | Disparadores de Canvas por CDI | /users/track |
|---|---|---|---|---|
| O que faz | Leitura agendada de uma tabela do warehouse; grava atributos, eventos, compras, exclusões de usuários ou catálogos | A Braze consulta seu warehouse para extensões de segmento SQL | Linhas do 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 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 | Executa de acordo com um cronograma (a cada 5 minutos no mínimo; 15 minutos por padrão) ou sob demanda pelo endpoint Trigger a sync. A atualização do warehouse também se aplica. | Atualiza de acordo com o cronograma da sua extensão de segmento. A associação reflete os dados do warehouse na última atualização. | Executa no cronograma de sincronização (a cada 5 minutos no mínimo; 15 minutos por padrão). | Tempo quase real (processamento assíncrono) |
| Notas sobre throughput | Resultado completo da consulta por sincronização; a Braze faz o batching interno para os endpoints /users/track, /users/delete ou Catalog |
Limite de tempo de execução de consulta de 60 minutos por connected source; 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 warehouse | N/A (a saída da consulta define a associação) | Uma entrada no Canvas por linha do warehouse por execução de sincronização | 75 atributos, eventos e compras combinados por solicitação (padrão) |
| Criação de usuário | Sim, a menos que a opção update-existing-only esteja definida | Não (usuários desconhecidos nos resultados da consulta são ignorados) | Não (somente usuários existentes na 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 com cada caminho. Configure um tipo de dados por sincronização CDI padrão (por exemplo, atributos em uma integração e eventos em outra).
| Dimensão | Sincronização CDI padrão | CDI Segments | Disparadores de Canvas por CDI | /users/track |
|---|---|---|---|---|
| Colunas obrigatórias / formato | Identificador de usuário + UPDATED_AT + PAYLOAD (JSON) por linha |
O SQL deve retornar apenas external_user_id |
Identificador + UPDATED_AT + PROPERTIES (JSON; use {} quando vazio) |
Corpo de solicitação padrão do /users/track |
| Identificadores compatíveis | external_id, alias de usuário, braze_id, e-mail ou telefone |
Apenas external_user_id (string) |
Apenas external_id ou alias de usuário |
external_id, alias de usuário, braze_id, e-mail ou telefone |
Etapa 4: Implemente o caminho selecionado
- Sincronização CDI padrão: Crie uma tabela ou view no warehouse e siga Integrações de Cloud Data Ingestion e Configuração de tabela.
- CDI Segments: Adicione uma Connected source e crie uma extensão de segmento CDI.
- Disparadores de Canvas por 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 zero-copy 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 o MovieCanon, um padrão comum é: sincronizações CDI padrão para enriquecimento noturno de perfis, CDI Segments para regras de público somente no warehouse, disparadores de Canvas para jornadas de status de ingresso ou visualização com contexto em nível de linha e /users/track para eventos de app em tempo real.