Sincronizar datos de BrazeAI Decisioning Studio

Esta página explica cómo sincronizar datos de tu almacén de datos directamente con BrazeAI Decisioning Studio™ mediante la ingesta de datos en la nube (CDI).

Con el destino de Decisioning Studio de CDI, CDI también puede sincronizar datos del almacén directamente con BrazeAI Decisioning Studio. Los datos de estas sincronizaciones se ponen a disposición de Decisioning Studio para su activación, pero tus perfiles de usuario y espacios de trabajo de Braze permanecen sin cambios.

Importante

Esta característica se encuentra en acceso anticipado. Ponte en contacto con tu CSM o director de cuentas para obtener acceso.

Cómo funciona

Cuando creas una sincronización, elige Decisioning Studio como destino y escribe una consulta SQL que devuelva los datos que deseas sincronizar. CDI ejecuta esa consulta según la programación que configures y entrega los resultados como un activo de Decisioning Studio. Cada sincronización se asigna a un único activo, por lo que no puedes apuntar más de una sincronización al mismo activo.

A diferencia de las sincronizaciones con la plataforma de datos de Braze, las sincronizaciones de Decisioning Studio no asignan tus datos a perfiles de usuario, eventos ni catálogos.

Para conocer otras formas de poner datos a disposición de Decisioning Studio, consulta Conectar tus datos.

Requisitos previos

• Acceso a Braze y BrazeAI Decisioning Studio.
• Un origen de datos de almacén de datos de ingesta de datos en la nube activo. Si aún no has configurado uno, consulta Integraciones de almacén de datos.
• La tabla o vista que deseas sincronizar.
• Una columna (o columnas) en esa tabla para usar como clave primaria, y una columna de marca de tiempo que CDI pueda usar para la sincronización incremental.

Crear una sincronización de Decisioning Studio

Paso 1: Crear la sincronización y seleccionar el destino

1. Ve a Data Settings > Cloud Data Ingestion > Syncs.
2. Selecciona Create data sync.
3. Introduce un Integration Name y luego selecciona tu origen en Data sources.
4. En Destination, establece Data destination en BrazeAI Decisioning Studio™.
5. En Data category, selecciona el tipo de Decisioning Studio data que mejor se ajuste a tu tabla. Elige entre perfil de usuario, Message engagement events, Conversion events u Other. Esto etiqueta los datos para Decisioning Studio y no cambia la forma en que CDI procesa tus filas.

Paso 2: Escribir tu consulta SQL

En el paso Data definition, escribe una consulta SQL que devuelva los datos de la tabla o vista que deseas sincronizar. El resultado de la consulta se convierte en el esquema de tu sincronización.

Puedes usar el explorador de orígenes para examinar las tablas y vistas disponibles, o el generador de SQL con IA para obtener ayuda al escribir tu consulta.

Tu consulta debe devolver una columna UPDATED_AT, ya que CDI utiliza UPDATED_AT para la sincronización incremental y el seguimiento de cambios. En cada ejecución de sincronización, CDI sincroniza solo las filas en las que UPDATED_AT es posterior al último valor sincronizado. Si la columna de marca de tiempo que identificaste no se llama UPDATED_AT, puedes asignarle un alias en tu consulta:

1
SELECT *, LAST_MODIFIED AS UPDATED_AT FROM my_table

Para más información sobre cómo UPDATED_AT controla la sincronización incremental, incluido lo que sucede cuando lo retrocedes, consulta Comprender la columna UPDATED_AT.

Nota

Solo se admiten consultas de lectura de una sola sentencia, incluidas las cláusulas JOIN. CDI ejecuta consultas de solo lectura y no modifica tus tablas subyacentes.

Paso 3: Previsualizar y validar tu consulta

Selecciona vista previa and validate para ejecutar tu consulta. La sección Query vista previa (first 10 rows) muestra las primeras 10 filas devueltas desde tu origen, junto con el tipo de datos detectado de cada columna, para que puedas confirmar que los datos son correctos antes de continuar.

Paso 4: Seleccionar una clave primaria

Cada sincronización de Decisioning Studio necesita una clave primaria o compuesta: una o más columnas que identifiquen de forma única cada fila. Después de que la validación sea exitosa, abre el desplegable Primary key y selecciona una columna que sirva como clave primaria. Seleccionar varias columnas forma una clave compuesta.

Consejo

Una buena clave primaria es única para cada fila, nunca está vacía y es estable entre ejecuciones de sincronización. Evita valores generados en el momento de la consulta, como UUID() o CURRENT_TIMESTAMP, ya que pueden causar filas duplicadas o eliminadas.

Paso 5: Configurar notificaciones, programación y crear la sincronización

1. En el paso Notifications, introduce uno o más Contact Email(s) para recibir notificaciones de errores de sincronización. También puedes activar las notificaciones de Row Error y Sync success.
2. En el paso Schedule, activa Recurring sync para ejecutar la sincronización automáticamente según una programación. Con Recurring sync desactivado, la sincronización se ejecuta solo cuando la activas, ya sea manualmente desde el panel o a través del endpoint Trigger a sync.
3. Revisa el Summary y luego crea la sincronización.

Editar una sincronización

Cuando editas una sincronización existente, cualquier cambio en tu consulta SQL requiere revalidación antes de que puedas guardar. Las claves primarias y compuestas no se pueden cambiar y deben seguir devolviéndose.

Los cambios válidos surten efecto en la siguiente ejecución de sincronización.

Gestión de cambios de esquema

CDI gestiona los cambios de esquema del origen de forma aditiva. En cada ejecución de sincronización, CDI compara el esquema de tu origen con el activo existente de Decisioning Studio y añade cualquier columna nueva mientras conserva las que ya existen.

Cuando CDI detecta un cambio de esquema, se muestra en los detalles de ejecución de la sincronización y en la página de edición de la sincronización, y tus contactos de notificación reciben una alerta por correo electrónico. Para cambiar qué columnas se entregan, actualiza tu consulta SQL y vuelve a validar.