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.

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

Para sincronizações de dados de usuários via CDI que usam uma coluna PAYLOAD, configure ambos:

A Braze lê as linhas da sua tabela de origem primeiro e, 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 um tipo de identificador por vez, mesmo que sua tabela contenha várias colunas de identificador.

Requisitos de UPDATED_AT

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

Para orientações sobre timestamps duplicados e atualizações incrementais, consulte Práticas recomendadas de ingestão de dados na nuvem.

Nota

Fontes de armazenamento de arquivos usam requisitos de configuração diferentes e não oferecem suporte a UPDATED_AT. Para mais detalhes, consulte Integrações de armazenamento de arquivos.

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 Capturando datas como propriedades de objeto.

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"
        }
      ]
}

Documentação relacionada de configuração de CDI

• Para exemplos de DDL específicos por fonte, consulte Integrações de data warehouse.
• Para configuração baseada em arquivos, consulte Integrações de armazenamento de arquivos.
• Para orientações sobre comportamento de sincronização e otimização, consulte Práticas recomendadas de ingestão de dados na nuvem.