Configuración de tablas de ingesta de datos en la nube

Usa esta página para elegir cómo la ingesta de datos en la nube (CDI) lee tus datos y para configurar una tabla de origen con una columna PAYLOAD si utilizas ese método.

Elige una opción de definición de datos

Cuando creas una sincronización desde una fuente de almacén de datos, eliges cómo Braze lee tus datos en el paso Definición de datos. Las opciones que se muestran dependen del tipo de sincronización.

Comprender la configuración de la tabla en comparación con el formato de la carga útil

Para las sincronizaciones de datos de usuario de CDI que usan una columna PAYLOAD, configura ambos:

Braze lee primero las filas de tu tabla de origen y luego valida el campo PAYLOAD según el tipo de datos seleccionado.

Configura tu tabla de origen

Para las sincronizaciones de datos de usuario del almacén de datos que utilizan una columna PAYLOAD, tu tabla o vista de origen debe incluir:

• UPDATED_AT
• PAYLOAD
• Una o más columnas de identificador de usuario compatibles:
  • EXTERNAL_ID
  • ALIAS_NAME y ALIAS_LABEL
  • BRAZE_ID
  • EMAIL
  • PHONE

Cada fila debe incluir un tipo de identificador a la vez, incluso si tu tabla contiene varias columnas de identificador.

Requisitos de UPDATED_AT

• Almacena los valores de UPDATED_AT en UTC para evitar problemas con el horario de verano.
• Braze sincroniza las filas en las que UPDATED_AT es posterior al último valor sincronizado.
• Las filas con la marca de tiempo exacta del límite pueden volver a sincronizarse si nuevas filas comparten esa marca de tiempo.

Para obtener orientación sobre marcas de tiempo duplicadas y actualizaciones incrementales, consulta Prácticas recomendadas de ingesta de datos en la nube.

Nota

Las fuentes de almacenamiento de archivos utilizan requisitos de configuración diferentes y no admiten UPDATED_AT. Para más detalles, consulta Integraciones de almacenamiento de archivos.

Configurar la columna PAYLOAD

El valor de PAYLOAD sigue los mismos formatos de objeto utilizados por el endpoint /users/track de Braze para el tipo de datos seleccionado.

Para atributos anidados, incluye las fechas utilizando el formato de Capturar fechas como propiedades de objeto.

Ejemplos de carga útil

• atributos personalizados anidados
• evento
• compra
• grupos de suscripción

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

Documentación relacionada de configuración de CDI

• Integraciones de almacén de datosEjemplos de DDL específicos de cada fuente.
• Integraciones de almacenamiento de archivosConfiguración de CDI basada en archivos.
• Prácticas recomendadas de Cloud Data IngestionOrientación sobre el comportamiento de sincronización y la optimización.