Ir para o conteúdo

Sincronizar objetos de dados com a ingestão de dados na nuvem

Use esta página para sincronizar registros de objetos de dados e seus relacionamentos da sua fonte para a Braze com a ingestão de dados na nuvem (CDI). Com os objetos de dados, você pode armazenar registros de negócios, como contas, e conectá-los aos seus usuários. Para conhecer o modelo de objeto subjacente e os endpoints da API, consulte Objetos de dados.

Tipos de sincronização

Os objetos de dados usam três tipos de sincronização diferentes. Cada um é uma sincronização independente na Braze, com sua própria tabela ou consulta de origem e seu próprio cronograma.

Tipo de dados O que cada linha representa Identificadores obrigatórios
Objetos de dados Um registro de objeto de dados, como uma única conta. OBJECT_ID
Relacionamentos de usuários com objetos de dados Um vínculo entre um registro e um usuário. OBJECT_ID e pelo menos um identificador de usuário
Relacionamentos entre objetos de dados Um vínculo entre dois registros do mesmo tipo ou de tipos diferentes. OBJECT_ID e RELATED_OBJECT_ID

Sincronize os registros antes dos relacionamentos que fazem referência a eles. Se o registro de uma linha de relacionamento ainda não existir, essa linha fica retida e é processada novamente mais tarde, em vez de ser aplicada.

Antes de criar uma sincronização

A CDI não cria nem altera campos de objetos de dados durante uma sincronização. Por isso, configure-os primeiro:

  1. Em Configurações de dados > Contas, adicione cada campo e campo de relacionamento que você pretende enviar. Marque um campo como obrigatório somente se todas as linhas tiverem um valor para ele.
  2. Na sua fonte, crie a tabela ou visualização para cada sincronização, ou planeje a consulta que você vai escrever diretamente na CDI.

Criar a sincronização

  1. Acesse Configurações de dados > Ingestão de dados na nuvem > Sincronizações e selecione Criar sincronização de dados.
  2. Insira um nome e selecione sua fonte.
  3. Em Tipo de dados, selecione Objetos de dados, Relacionamentos de usuários com objetos de dados ou Relacionamentos entre objetos de dados.
  4. Selecione o Tipo de objeto de dados para uma sincronização de registros ou o Nome do relacionamento para qualquer uma das sincronizações de relacionamento. Os nomes de relacionamento mostram o relacionamento seguido dos dois tipos que ele conecta, como User (Account-User) ou Subaccount (Account-Account).
  5. Na etapa Definição de dados, escolha um modo de sincronização. As sincronizações de objetos de dados aceitam Tabela e SQL em fontes de data warehouse. O mapeador visual não está disponível para sincronizações de objetos de dados.
  6. Selecione Prévia e validação e continue pelas etapas de notificações e agendamento.

Colunas de origem

  • UPDATED_AT - O horário em que essa linha foi atualizada ou adicionada à tabela. A Braze sincroniza as linhas em que UPDATED_AT é posterior ao último valor sincronizado. Linhas com o carimbo de data/hora exatamente no limite podem ser sincronizadas novamente se novas linhas tiverem esse mesmo carimbo de data/hora.
  • OBJECT_ID - O identificador do registro do objeto de dados. Ele deve corresponder ao valor de object_id usado na Braze para esse tipo de objeto de dados.
  • PAYLOAD - Uma string JSON com os campos e valores a serem sincronizados. Cada chave deve corresponder a um campo definido no tipo de objeto de dados na Braze.
  • DELETED - Quando for true, a Braze exclui o registro em vez de atualizá-lo. Deixe esse valor nulo ou como false nas linhas que você quer criar ou atualizar.

Os nomes dos campos dentro de PAYLOAD diferenciam maiúsculas de minúsculas. Uma chave chamada NAME não corresponde a um campo chamado name. Se as maiúsculas e minúsculas não corresponderem, a validação informa a chave como um campo indefinido e informa como ausente o campo que ela deveria preencher. Nomeie suas chaves exatamente como os campos aparecem em Configurações de dados > Objetos de dados.

A Braze não cria nem altera tipos de objetos de dados durante uma sincronização. Defina o tipo e todos os seus campos na Braze antes de criar a sincronização. Para adicionar um campo depois, adicione-o primeiro ao tipo e, em seguida, atualize sua tabela de origem ou sua consulta.

Para ver as definições das colunas e um exemplo de DDL no dialeto SQL da sua fonte, consulte a página da sua fonte.

Identificadores de relacionamento com usuários

Uma linha de relacionamento com usuário precisa de OBJECT_ID e de pelo menos um identificador de usuário: EXTERNAL_ID, a combinação de ALIAS_NAME e ALIAS_LABEL, EMAIL ou PHONE.

Validação

Ao selecionar Prévia e validação, a Braze verifica as colunas retornadas pela sua tabela ou consulta em relação aos campos definidos no tipo de objeto de dados. Você só pode passar da etapa Definição de dados depois que a validação for aprovada.

Erro Causa Como corrigir
Campos obrigatórios estão ausentes ou nulos na sua consulta Um campo marcado como obrigatório no tipo não tem coluna correspondente, ou essa coluna está nula nas linhas da prévia. Adicione uma coluna para cada campo obrigatório e garanta que todas as linhas tenham um valor.
O tipo de objeto de dados não tem os seguintes campos definidos Uma coluna não corresponde a nenhum campo do tipo. Os campos diferenciam maiúsculas de minúsculas, então TEAM_ID não corresponde a team_id. Corrija o nome da coluna para que corresponda exatamente ao campo, remova a coluna ou adicione o campo ao tipo na Braze.
Os campos esperam um tipo de dado diferente do que está na sua consulta O tipo de dado de uma coluna não corresponde ao tipo de dado do campo, como uma string onde o campo espera um número. Converta a coluna para o tipo esperado na sua tabela de origem ou consulta.

Observe que a validação verifica apenas as primeiras 10 linhas retornadas pela sua origem. As linhas que falham durante uma sincronização são informadas nos registros de sincronização.

Excluir registros e relacionamentos

Inclua uma coluna DELETED na sua fonte para remover registros ou relacionamentos. Quando DELETED for true, a Braze exclui esse registro ou relacionamento em vez de atualizá-lo. Excluir um registro ou relacionamento não exclui os usuários aos quais ele estava relacionado.

Documentação da plataforma de engajamento do cliente Braze.

Recursos
Jurídico
Empresa
© 2026 Braze, Inc. Todos os direitos reservados.
Verificando o status do Braze
New Stuff!