Skip to content

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

Use esta página para separar dois requisitos relacionados, mas diferentes, da Ingestão de dados na nuvem (CDI): configuração da tabela de origem e formatação de carga útil.

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

Para sincronizações de dados de usuários via CDI, 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 dados selecionado.

Configure sua tabela de origem

Para sincronizações de dados de usuários via data warehouse, 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 múltiplas 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 da Ingestão de dados na nuvem.

Configure 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

Você pode incluir atributos personalizados aninhados na coluna de carga útil para uma sincronização de atributos personalizados.

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

Para sincronizar eventos, um nome de evento é obrigatório. Formate o campo time como uma string ISO 8601 ou no formato yyyy-MM-dd'T'HH:mm:ss:SSSZ. Se o campo time não estiver presente, a Braze usará o valor da coluna UPDATED_AT como o horário do evento. Outros campos, incluindo app_id e properties, são opcionais.

Você pode sincronizar um evento por linha.

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": "Dan Alexander"
    }
}

Para sincronizar eventos de compra, product_id, currency e price são obrigatórios. Formate o campo opcional time como uma string ISO 8601 ou no formato yyyy-MM-dd'T'HH:mm:ss:SSSZ. Se o campo time não estiver presente, a Braze usará o valor da coluna UPDATED_AT como o horário do evento. Outros campos, incluindo app_id, quantity e properties, são opcionais.

Você pode sincronizar um evento de compra por linha.

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

Para sincronizar status de grupos de inscrições, inclua um ou mais pares de subscription_group_id e subscription_state em cada linha.

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"
        }
      ]
}
New Stuff!