Skip to content

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: Nível de fidelidade, valor do tempo de vida e atributos de preferência 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 por gatilho: Linhas do warehouse que devem entrar em um Canvas com personalização específica por linha que não precisa ficar armazenada no perfil.

A Braze oferece quatro caminhos principais de ingestão. As sincronizações padrão do Cloud Data Ingestion (CDI) e a API /users/track persistem dados nos perfis. CDI Segments (Connected Sources) e gatilhos 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 esta comparação quando estiver planejando a arquitetura, dimensionando a capacidade ou explicando trade-offs para stakeholders de engenharia e marketing. Ela não substitui os guias de configuração de 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 (semelhante a /users/track). CDI Segments e gatilhos CDI para Canvas mantêm os dados do warehouse sem gravá-los nos perfis de usuário da Braze.
  • As sincronizações recorrentes do CDI podem ser executadas a cada 15 minutos até uma vez por mês. Se você precisar de uma cadência maior do que 15 minutos, entre em contato com seu gerente de sucesso do cliente ou use a ingestão via REST API. Consulte Braze Cloud Data Ingestion.
  • Os gatilhos CDI para Canvas compartilham o limite de frequência da REST API /canvas/trigger/send com outro tráfego para esse endpoint. /users/track tem seus próprios limites e regras de lote. Os limites padrão podem ser elevados. Acesse Configurações > APIs e identificadores > Limites de API e consulte Limites de frequência da API.
  • Connected Sources e extensões de segmento 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 Connected sources.

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 verifique se esse caminho grava nos perfis da Braze.

Seu objetivo Caminho recomendado Grava nos perfis?
Persistir atributos, eventos, compras ou itens de catálogo do warehouse Sincronização padrão do CDI Sim (os dados são copiados para 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 (apenas associação de membros)
Inserir usuários em um Canvas com contexto de linha do warehouse que não deve persistir no perfil Gatilhos CDI para Canvas Não (propriedades de contexto transitórias do Canvas)
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 capacidade

Compare como cada caminho lida com residência de dados, latência, capacidade e criação de usuários.

Dimensão Sincronização padrão do CDI CDI Segments Gatilhos CDI para Canvas /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 entrada no Canvas com contexto de linha como propriedades de contexto do Canvas Apps, servidores ou pipelines de streaming gravam atributos, eventos e compras nos perfis
Residência dos 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 Não é em tempo real; cadência mínima de sincronização de 15 minutos (a atualidade do warehouse também se aplica) Não é em tempo real; atualiza conforme o cronograma da extensão de segmento (a associação de membros não é atualizada a cada mudança no warehouse) Não é em tempo real; limitada pelo cronograma de sincronização (mínimo de 15 minutos) Tempo quase real (processamento assíncrono)
Notas sobre capacidade Resultado completo da consulta por sincronização; a Braze processa internamente em lotes via /users/track, /users/delete ou endpoints de catálogo Limite de tempo de execução de consulta de 60 minutos por connected source; sem limite de objetos por requisiçã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 requisiçã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 (o resultado da consulta define a associação de membros) Uma entrada no Canvas por linha do warehouse por execução de sincronização 75 atributos, eventos e compras combinados por requisição (padrão)
Criação de usuários Sim, a menos que a opção de atualizar apenas existentes esteja definida Não (usuários desconhecidos nos resultados da consulta são ignorados) Não (apenas usuários existentes da Braze) Sim, a menos que _update_existing_only seja true

Etapa 3: Compare requisitos de esquema e identificadores

Compare as colunas obrigatórias e os identificadores compatíveis para cada caminho. Configure um tipo de dados por sincronização padrão do CDI (por exemplo, atributos em uma integração e eventos em outra).

Dimensão Sincronização padrão do CDI CDI Segments Gatilhos CDI para Canvas /users/track
Colunas obrigatórias / formato Identificador do 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 requisição padrão de /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

Para a MovieCanon, um padrão comum é: sincronizações padrão do CDI para enriquecimento noturno de perfis, CDI Segments para regras de público exclusivas do warehouse, gatilhos para Canvas em jornadas de status de ingresso ou visualização com contexto por linha, e /users/track para eventos de app em tempo real.
New Stuff!