Comparar opciones de ingesta de datos persistentes y de copia cero
Elige cómo los datos de tu almacén o aplicaciones llegan a Braze, ya sea que se copien en los perfiles de usuario, se consulten en su lugar para la segmentación o se pasen de forma transitoria a un Canvas, antes de diseñar tus pipelines de ingesta.
Acerca de este ejemplo
MovieCanon es un servicio ficticio de streaming de películas. Centraliza los datos de clientes, tickets y visualizaciones en un almacén de datos (warehouse). El equipo de datos debe decidir cómo alimentar Braze para tres necesidades comunes:
- Datos de perfil: Atributos de nivel de fidelización, valor de duración del ciclo de vida y preferencias de género o formato que persisten en los perfiles de usuario de Braze.
- Creación de audiencias: Segments basados en SQL a partir de tablas del warehouse, sin copiar cada columna en Braze.
- Mensajería activada por eventos: Filas del warehouse que deben ingresar a un Canvas con personalización específica por fila que no necesita residir en el perfil.
Braze ofrece cuatro rutas principales de ingesta de datos. Las sincronizaciones estándar de ingesta de datos en la nube (CDI) y la API /users/track persisten datos en los perfiles. Los CDI Segments (Connected Sources) y los activadores de CDI para Canvas son opciones de copia cero: los datos del warehouse permanecen en tu warehouse y no se escriben en los perfiles de usuario de Braze.
Usa esta comparación cuando estés planificando la arquitectura, dimensionando el rendimiento o explicando las ventajas y desventajas a las partes interesadas de ingeniería y marketing. No reemplaza las guías de configuración de integración de cada opción.
Consideraciones
- La ingesta de datos en la nube es una característica general. Las sincronizaciones estándar de CDI copian datos en los perfiles de Braze (similar a
/users/track). Los Segments de CDI y los desencadenadores de Canvas de CDI mantienen los datos del almacén en su lugar sin escribirlos en los perfiles de usuario de Braze. - Las sincronizaciones recurrentes de CDI pueden ejecutarse con una frecuencia de cada 5 minutos o tan raramente como una vez al mes. De forma predeterminada, el intervalo más corto que puedes configurar en el panel es de 15 minutos, lo que ayuda a gestionar los costos de computación de tu almacén y el volumen de solicitudes. Para sincronizar con una frecuencia de cada 5 minutos, contacta con soporte de Braze o tu administrador de éxito de cliente. Para sincronizar tan pronto como cambien tus datos, llama al endpoint Desencadenar una sincronización cuando finalice la carga de tu almacén. Consulta Ingesta de datos en la nube de Braze.
- Los desencadenadores de Canvas de CDI comparten el límite de velocidad de la REST API
/canvas/trigger/sendcon otro tráfico hacia ese endpoint./users/tracktiene sus propios límites y reglas de lotes. Los límites predeterminados se pueden aumentar. Ve a Configuración > API e identificadores > Límites de API, y consulta Límites de velocidad de API. - Las fuentes conectadas y las extensiones de segmento de CDI ejecutan consultas en tu almacén. Tú asumes el costo de computación del almacén; Braze no registra puntos de datos para esas consultas. Consulta Fuentes conectadas.
Configuración
Paso 1: Asigna tu caso de uso a una ruta de ingesta
Haz coincidir tu objetivo con la ruta de ingesta recomendada y si esa ruta escribe en los perfiles de Braze.
| Tu objetivo | Ruta recomendada | ¿Escribe en perfiles? |
|---|---|---|
| Persistir atributos, eventos, compras o elementos de catálogo desde el almacén de datos | Sincronización CDI estándar | Sí (los datos se copian a los perfiles de Braze o a los catálogos) |
| Crear audiencias a partir de SQL del almacén de datos sin copiar tablas de origen en Braze | CDI Segments (fuentes conectadas) | No (solo membresía) |
| Hacer que los usuarios entren a un Canvas con contexto de fila del almacén de datos que no debe persistir en el perfil | Desencadenadores de Canvas CDI | No (propiedades de contexto de Canvas transitorias) |
| Enviar datos desde aplicaciones, servidores o pipelines de streaming en tiempo casi real | /users/track (o SDK) |
Sí (los datos persisten en los perfiles) |
Paso 2: Compara persistencia, latencia y rendimiento
Compara cómo cada ruta maneja la residencia de datos, la latencia, el rendimiento y la creación de usuarios.
| Dimensión | Sincronización CDI estándar | CDI Segments | Desencadenadores de Canvas CDI | /users/track |
|---|---|---|---|---|
| Qué hace | Lectura programada de una tabla del almacén de datos; escribe atributos, eventos, compras, eliminaciones de usuarios o catálogos | Braze consulta tu almacén de datos para extensiones de segmento SQL | Las filas del almacén de datos desencadenan la entrada a Canvas con contexto de fila como propiedades de contexto de Canvas | Las aplicaciones, servidores o pipelines de streaming escriben atributos, eventos y compras en los perfiles |
| Residencia de datos | Copiados y persistidos en los perfiles de Braze | Permanecen en tu almacén de datos; nada se escribe en los perfiles | Las propiedades de contexto de Canvas son transitorias; no se persisten en los perfiles | Copiados y persistidos en los perfiles de Braze |
| Latencia típica | Se ejecuta según un programa (con una frecuencia de hasta cada 5 minutos; 15 minutos de forma predeterminada) o bajo demanda a través del endpoint Trigger a sync. También aplica la frescura del almacén de datos. | Se actualiza según el programa de tu extensión de segmento. La membresía refleja los datos del almacén de datos a partir de la última actualización. | Se ejecuta según el programa de sincronización (con una frecuencia de hasta cada 5 minutos; 15 minutos de forma predeterminada). | Tiempo casi real (procesamiento asíncrono) |
| Notas de rendimiento | Resultado completo de la consulta por sincronización; Braze agrupa internamente hacia /users/track, /users/delete, o endpoints de catálogo |
Límite de tiempo de ejecución de consulta de 60 minutos por fuente conectada; sin límite de objetos por solicitud | Comparte el límite de velocidad de /canvas/trigger/send; aproximadamente 3,75 millones de entradas a Canvas por hora por ejecución de sincronización |
Hasta 75 objetos combinados por solicitud; consulta los límites de velocidad de la API |
| Tamaño de lote | Sin límite de objetos en el lado de CDI para lecturas del almacén de datos | N/A (la salida de la consulta define la membresía) | Una entrada a Canvas por fila del almacén de datos por ejecución de sincronización | 75 atributos, eventos y compras combinados por solicitud (predeterminado) |
| Creación de usuarios | Sí, a menos que se configure solo actualización de existentes | No (los usuarios desconocidos en los resultados de la consulta se ignoran) | No (solo usuarios de Braze existentes) | Sí, a menos que _update_existing_only sea verdadero |
Paso 3: Compara los requisitos de esquema e identificadores
Compara las columnas requeridas y los identificadores admitidos para cada ruta. Configura un tipo de datos por sincronización CDI estándar (por ejemplo, atributos en una integración y eventos en otra).
| Dimensión | Sincronización CDI estándar | CDI Segments | Desencadenadores de Canvas CDI | /users/track |
|---|---|---|---|---|
| Columnas / forma requeridas | Identificador de usuario + UPDATED_AT + PAYLOAD (JSON) por fila |
SQL debe devolver solo external_user_id |
Identificador + UPDATED_AT + PROPERTIES (JSON; usa {} cuando esté vacío) |
Cuerpo de solicitud estándar de /users/track |
| Identificadores admitidos | external_id, alias de usuario, braze_id, correo electrónico o teléfono |
Solo external_user_id (cadena) |
Solo external_id o alias de usuario |
external_id, alias de usuario, braze_id, correo electrónico o teléfono |
Paso 4: Implementa la ruta que seleccionaste
- Sincronización CDI estándar: Crea una tabla o vista en el almacén de datos, luego sigue Integraciones de ingesta de datos en la nube y Configuración de tablas.
- CDI Segments: Añade una fuente conectada, luego crea una extensión de segmento CDI.
- Desencadenadores de Canvas CDI: Configura una tabla de origen con
PROPERTIES, crea y lanza un Canvas de destino, luego crea una sincronización siguiendo Personalización sin copia usando CDI. /users/track: Envía solicitudes desde tu aplicación o middleware. Formatea las cargas útiles según POST: Crear y actualizar usuarios.
Para MovieCanon, un patrón común es: sincronizaciones CDI estándar para el enriquecimiento nocturno de perfiles, CDI Segments para reglas de audiencia solo en el almacén de datos, desencadenadores de Canvas para el estado de tickets o recorridos de visualización con contexto a nivel de fila, y /users/track para eventos de la aplicación en tiempo real.