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 un origen 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 utilizan una columna PAYLOAD, configura ambos:

Braze lee primero las filas de tu tabla de origen y luego valida el campo PAYLOAD en función del 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 múltiples 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 que coincidan exactamente con la marca de tiempo 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 son compatibles con 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 los atributos anidados, incluye las fechas utilizando el formato en 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 de configuración de CDI relacionada

• Para ver ejemplos de DDL específicos de cada fuente, consulta Integraciones de almacén de datos.
• Para la configuración basada en archivos, consulta Integraciones de almacenamiento de archivos.
• Para obtener orientación sobre el comportamiento de sincronización y la optimización, consulta Mejores prácticas de ingesta de datos en la nube.