Sincronizar objetos de datos con la ingesta de datos en la nube
Usa esta página para sincronizar registros de objetos de datos y sus relaciones desde tu origen a Braze con la ingesta de datos en la nube (CDI). Los objetos de datos te permiten almacenar registros de negocio, como cuentas, y conectarlos con tus usuarios. Para conocer el modelo de objetos subyacente y los endpoints de la API, consulta Objetos de datos.
Tipos de sincronización
Los objetos de datos usan tres tipos de sincronización distintos. Cada uno es una sincronización independiente en Braze, con su propia tabla o consulta de origen y su propia programación.
| Tipo de datos | Qué representa cada fila | Identificadores obligatorios |
|---|---|---|
| Objetos de datos | Un registro de objeto de datos, como una sola cuenta. | OBJECT_ID |
| Relaciones entre objetos de datos y usuarios | Un vínculo entre un registro y un usuario. | OBJECT_ID y al menos un identificador de usuario |
| Relaciones entre objetos de datos | Un vínculo entre dos registros del mismo tipo o de tipos distintos. | OBJECT_ID y RELATED_OBJECT_ID |
Sincroniza los registros antes que las relaciones que hacen referencia a ellos. Una fila de relación cuyo registro aún no existe se retiene y se reintenta en lugar de aplicarse.
Antes de crear una sincronización
CDI no crea ni modifica campos de objetos de datos durante una sincronización, así que configúralos primero:
- En Configuración de datos > Cuentas, añade cada campo y cada campo de relación que tengas previsto enviar. Marca un campo como obligatorio solo si todas las filas van a tener un valor para él.
- En tu origen, crea la tabla o vista para cada sincronización, o planifica la consulta que escribirás directamente desde CDI.
Crear la sincronización
- Ve a Configuración de datos > Ingesta de datos en la nube > Sincronizaciones y selecciona Crear sincronización de datos.
- Introduce un nombre y selecciona tu origen.
- En Tipo de datos, selecciona Objetos de datos, Relaciones entre objetos de datos y usuarios o Relaciones entre objetos de datos.
- Selecciona el Tipo de objeto de datos para una sincronización de registros, o el Nombre de la relación para cualquiera de las sincronizaciones de relaciones. Los nombres de relación muestran la relación seguida de los dos tipos que conecta, como User (Account-User) o Subaccount (Account-Account).
- En el paso Definición de datos, elige un modo de sincronización. Las sincronizaciones de objetos de datos admiten Tabla y SQL en orígenes de almacén de datos. El mapeador visual no está disponible para las sincronizaciones de objetos de datos.
- Selecciona Vista previa y validación y continúa con las notificaciones y la programación.
Columnas de origen
UPDATED_AT: la hora en que se actualizó o se añadió esta fila a la tabla. Braze sincroniza las filas en las queUPDATED_ATes posterior al último valor sincronizado. Es posible que las filas con la marca de tiempo límite exacta se vuelvan a sincronizar si hay filas nuevas que comparten esa misma marca de tiempo.OBJECT_ID: el identificador del registro del objeto de datos. Debe coincidir con el valor deobject_idque se utiliza en Braze para este tipo de objeto de datos.PAYLOAD: una cadena JSON con los campos y valores que se van a sincronizar. Cada clave debe coincidir con un campo definido en el tipo de objeto de datos en Braze.DELETED: cuando estrue, Braze elimina el registro en lugar de actualizarlo. Deja este valor nulo o enfalsepara las filas que quieras crear o actualizar.
Los nombres de campo dentro de PAYLOAD distinguen entre mayúsculas y minúsculas. Una clave llamada NAME no coincide con un campo llamado name. Si las mayúsculas y minúsculas no coinciden, la validación indica que la clave es un campo no definido y que falta el campo que debía rellenar. Asigna a tus claves exactamente los mismos nombres con los que aparecen los campos en Configuración de datos > Objetos de datos.
Braze no crea ni modifica tipos de objetos de datos durante una sincronización. Define el tipo y todos sus campos en Braze antes de crear la sincronización. Para añadir un campo más adelante, añádelo primero al tipo y, después, actualiza tu tabla de origen o tu consulta.
Para ver las definiciones de las columnas y un DDL de ejemplo en el dialecto SQL de tu origen, consulta la página de tu origen.
Identificadores de relaciones con usuarios
Una fila de relación con usuarios necesita OBJECT_ID más al menos un identificador de usuario: EXTERNAL_ID, la combinación de ALIAS_NAME y ALIAS_LABEL, EMAIL o PHONE.
Validación
Cuando seleccionas Vista previa y validación, Braze comprueba las columnas que devuelve tu tabla o consulta con los campos definidos en el tipo de objeto de datos. No puedes continuar más allá del paso Definición de datos hasta que se supere la validación.
| Error | Causa | Cómo solucionarlo |
|---|---|---|
| Faltan campos obligatorios o son nulos en tu consulta | Un campo marcado como obligatorio en el tipo no tiene una columna coincidente, o esa columna es nula en las filas de la vista previa. | Añade una columna para cada campo obligatorio y asegúrate de que cada fila tenga un valor. |
| El tipo de objeto de datos no tiene definidos los siguientes campos | Una columna no coincide con ningún campo del tipo. Los campos distinguen entre mayúsculas y minúsculas, por lo que TEAM_ID no coincide con team_id. |
Corrige el nombre de la columna para que coincida exactamente con el campo, elimina la columna o añade el campo al tipo en Braze. |
| Los campos esperan un tipo de datos distinto al de tu consulta | El tipo de datos de una columna no coincide con el tipo de datos del campo, por ejemplo, una cadena cuando el campo espera un número. | Convierte la columna al tipo esperado en tu tabla de origen o en tu consulta. |
Ten en cuenta que la validación solo comprueba las primeras 10 filas que devuelve tu origen. Las filas que fallan durante una sincronización se notifican en los registros de sincronización.
Eliminar registros y relaciones
Incluye una columna DELETED en tu origen para eliminar registros o relaciones. Cuando DELETED es true, Braze elimina ese registro o relación en lugar de actualizarlo. Eliminar un registro o una relación no elimina a los usuarios con los que estaba relacionado.
Páginas relacionadas
- Configuración de tablas para conocer las columnas obligatorias y el formato de la carga útil
- Buenas prácticas para la programación de sincronizaciones y el uso eficiente de los puntos de datos
- Registros de sincronización y observabilidad para supervisar las ejecuciones de sincronización
- Preguntas frecuentes para resolver dudas comunes sobre todas las fuentes