Configuração de tabela da Ingestão de dados na nuvem

Use esta página para escolher como a Ingestão de dados na nuvem (CDI) lê seus dados e para configurar uma tabela de origem com uma coluna PAYLOAD, caso você use esse método.

Escolha uma opção de definição de dados

Ao criar uma sincronização a partir de uma fonte de data warehouse, você escolhe como a Braze lê seus dados na etapa Definição de dados. As opções exibidas dependem do tipo de sincronização.

Orientação para organização de dados

Cada sincronização de CDI atualiza um tipo de dado por vez, como atributos de usuário, eventos personalizados, eventos de compra ou itens de catálogo. Ao configurar suas tabelas ou visualizações de origem, organize os dados com base em como você planeja sincronizá-los:

• Uma tabela por tipo de dado: criar tabelas ou visualizações separadas para cada tipo de dado (por exemplo, user_attributes, custom_events, purchases) oferece uma separação clara. Isso também facilita o gerenciamento de diferentes cronogramas de sincronização e definições de dados.
• Tabela de origem compartilhada: se você usa os modos de mapeamento Visual ou SQL, várias sincronizações podem extrair dados da mesma tabela de origem. Por exemplo, uma sincronização de atributos e uma sincronização de eventos podem consultar a mesma tabela, mas você ainda cria sincronizações separadas no dashboard da Braze: uma para atributos e outra para eventos. Cada sincronização mapeia ou consulta apenas as colunas de que precisa.

Escolha a abordagem que se encaixa no seu pipeline de dados e no número de casos de uso que você gerencia. Os dois padrões funcionam à medida que seus casos de uso crescem.

Entenda a configuração da tabela em comparação com a formatação da carga útil

Para sincronizações de dados de usuários do CDI que usam uma coluna PAYLOAD, configure os dois itens:

A Braze lê primeiro as linhas da sua tabela de origem. Em seguida, valida o campo PAYLOAD com base no tipo de dado selecionado.

Configure sua tabela de origem

Para sincronizações de dados de usuários do data warehouse que usam uma coluna PAYLOAD, sua tabela ou visualização de origem deve incluir:

• UPDATED_AT
• PAYLOAD
• Uma ou mais colunas de identificador de usuário compatíveis:
  • EXTERNAL_ID
  • ALIAS_NAME e ALIAS_LABEL
  • BRAZE_ID
  • EMAIL
  • PHONE

Cada linha deve incluir apenas um tipo de identificador por vez, mesmo que sua tabela tenha várias colunas de identificador.

Requisitos de UPDATED_AT

• Armazene os valores de UPDATED_AT em UTC para evitar problemas com o horário de verão.
• A Braze sincroniza as linhas em que UPDATED_AT é posterior ao último valor sincronizado.
• Linhas com o carimbo de data/hora exato do limite podem ser sincronizadas novamente se novas linhas compartilharem esse mesmo carimbo de data/hora.

Para orientações sobre carimbos de data/hora duplicados e atualizações incrementais, consulte as melhores práticas da ingestão de dados na nuvem.

Nota

As fontes de armazenamento de arquivos têm requisitos de configuração diferentes e não suportam UPDATED_AT. Para mais detalhes, consulte a seção Formatos de arquivo necessários na página da sua fonte: Amazon S3, Google Cloud Storage ou Azure Blob Storage.

Configurar a coluna PAYLOAD

O valor de PAYLOAD segue os mesmos formatos de objeto usados pelo endpoint /users/track da Braze para o tipo de dados selecionado.

Para atributos aninhados, inclua datas usando o formato descrito em Capturar datas como propriedades de objetos.

Exemplos de carga útil

• atributos personalizados aninhados
• evento
• compra
• grupos de inscrições

1
2
3
4
5
6
7
8
9
10
11
12

{
      "most_played_song": {
        "song_name": "Solea",
        "artist_name": "Miles Davis",
        "album_name": "Sketches of Spain",
        "genre": "Jazz",
        "play_analytics": {
            "count": 1000,
            "top_10_listeners": true
        }
      }
}

1
2
3
4
5
6
7
8
9

{
    "app_id" : "your-app-id",
    "name" : "rented_movie",
    "time" : "2013-07-16T19:20:45+01:00",
    "properties": {
        "movie": "The Sad Egg",
        "director": "Alex Smith"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12

{
    "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
    "product_id" : "Completed Order",
    "currency" : "USD",
    "price" : 219.98,
    "time" : "2013-07-16T19:20:30+01:00",
    "properties" : {
        "products" : [ { "name": "Monitor", "category": "Gaming", "product_amount": 19.99 },
        { "name": "Gaming Keyboard", "category": "Gaming ", "product_amount": 199.99 }
        ]
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

{
    "subscription_groups" : [
        {
            "subscription_group_id": "subscription_group_identifier_1",
            "subscription_state": "unsubscribed"
        },
        {
            "subscription_group_id": "subscription_group_identifier_2",
            "subscription_state": "subscribed"
        },
        {
            "subscription_group_id": "subscription_group_identifier_3",
            "subscription_state": "subscribed"
        }
      ]
}

Documentos relacionados à configuração da CDI

• Fontes de ingestão de dados na nuvemExemplos de DDL específicos para cada fonte e configuração baseada em arquivos.
• Melhores práticas de ingestão de dados na nuvemComportamento de sincronização e orientações de otimização.