Ingesta de datos de Cloud de Braze
Braze Cloud Data Ingestion (CDI) te permite configurar una conexión directa desde tu solución de almacenamiento de datos para sincronizar datos de usuario relevantes y otros datos no relacionados con los usuarios con Braze. Estos datos pueden utilizarse para la personalización o segmentación con el fin de potenciar tus casos de uso de marketing. La integración flexible de la Ingesta de datos de Cloud admite estructuras de datos complejas, incluyendo JSON anidados y matrices de objetos.
Cómo funciona
Con Braze Cloud Data Ingestion (CDI), configuras una integración entre tu instancia de almacén de datos y tu espacio de trabajo de Braze para sincronizar datos de forma periódica. Esta sincronización se ejecuta según la planificación que establezcas, y cada integración puede tener una planificación diferente. Las sincronizaciones pueden ejecutarse con una frecuencia de hasta cada 15 minutos o tan infrecuentemente como una vez al mes. Si necesitas que las sincronizaciones se produzcan con una frecuencia superior a 15 minutos, ponte en contacto con tu administrador del éxito del cliente o considera la posibilidad de utilizar llamadas a la REST API para la ingesta de datos en tiempo real.
Cuando se ejecuta una sincronización, Braze se conecta directamente a tu instancia de almacén de datos, recupera todos los datos nuevos de la tabla especificada y actualiza los datos correspondientes en tu panel de Braze. Cada vez que se ejecuta la sincronización, los datos actualizados se reflejan en Braze.
Encontrar tu ID de integración
Puedes encontrar tu ID de integración en la URL cuando visualizas una integración en el panel de Braze. Ve a Configuración de datos > Ingesta de datos de Cloud y selecciona una integración. El ID de integración aparece en la URL con el formato https://[instance].braze.com/integrations/cloud_data_ingestion/[integration_id]. Por ejemplo, si tu URL es https://dashboard-01.braze.com/integrations/cloud_data_ingestion/abc123xyz, tu ID de integración es abc123xyz. Puedes utilizar este ID al realizar llamadas a la API para desencadenar sincronizaciones o comprobar el estado de la sincronización.
Casos de uso
Con las capacidades de Ingesta de datos de Cloud de Braze, puedes:
- Crear una integración sencilla directamente desde tu almacén de datos o tu solución de almacenamiento de archivos a Braze en solo unos minutos.
- Sincronizar de forma segura los datos de usuario, incluidos los atributos, los eventos y las compras, desde tu almacén de datos a Braze.
- Cerrar el ciclo de datos con Braze combinando la Ingesta de datos de Cloud con Currents o Snowflake Data Sharing.
Además, las fuentes conectadas son una alternativa de copia cero. Puedes hacer que Braze realice una consulta directa en tu almacén de datos o en tu solución de almacenamiento de archivos para construir segmentos CDI, todo ello sin copiar los datos subyacentes a Braze.
Fuentes de datos compatibles
La Ingesta de datos de Cloud puede sincronizar datos desde:
- Amazon Redshift
- Databricks
- Google BigQuery
- Microsoft Fabric
- Snowflake
- Amazon S3
Tipos de datos admitidos
La Ingesta de datos de Cloud admite los siguientes tipos de datos:
Datos de usuario
- Atributos de usuario, incluyendo:
- Atributos personalizados anidados
- Matrices de objetos
- Estados de suscripción
- Eventos personalizados
- Eventos de compra
- Solicitudes de eliminación de usuarios
Objetos que no son de usuario
- Artículos del catálogo
Mensajería de copia cero
- Fuentes conectadas
Identificadores de usuario para la ingesta de datos
Al sincronizar los datos de usuario a través de la Ingesta de datos de Cloud, puedes identificar a los usuarios utilizando uno o varios de los siguientes tipos de identificadores. Cada fila de la tabla de origen debe contener un valor para un solo tipo de identificador a la vez, pero la tabla puede incluir columnas para uno, dos, tres, cuatro o los cinco tipos de identificadores.
| Identificador | Descripción |
|---|---|
EXTERNAL_ID |
El ID externo que identifica el perfil de usuario que se va a crear o actualizar. Debe coincidir con el valor external_id utilizado en Braze. |
ALIAS_NAME y ALIAS_LABEL |
Estas dos columnas crean un objeto de alias de usuario. alias_name debe ser un identificador único y alias_label especifica el tipo de alias. Los usuarios pueden tener varios alias con etiquetas diferentes, pero solo un alias_name por alias_label. |
BRAZE_ID |
El identificador de usuario de Braze generado por el SDK de Braze. No se pueden crear nuevos usuarios utilizando un ID de Braze a través de la Ingesta de datos de Cloud. Para crear nuevos usuarios, especifica un ID de usuario externo o un alias de usuario. |
EMAIL |
La dirección de correo electrónico del usuario. Si existen varios perfiles con la misma dirección de correo electrónico, se dará prioridad al perfil actualizado más recientemente. Si incluyes tanto el correo electrónico como el teléfono, el correo electrónico se utilizará como identificador principal. |
PHONE |
El número de teléfono del usuario. Si existen varios perfiles con el mismo número de teléfono, se dará prioridad al perfil actualizado más recientemente. |
Para obtener información detallada sobre la configuración de las columnas de la tabla y los requisitos de formato de la carga útil, consulta Configuración de tablas para la Ingesta de datos de Cloud.
Para instrucciones de configuración específicas de cada fuente y ejemplos de SQL, consulta Integraciones de almacenes de datos.
Uso de puntos de datos
Para los clientes con facturación basada en puntos de datos, la facturación por puntos de datos para la Ingesta de datos de Cloud es equivalente a la facturación por actualizaciones a través del punto de conexión /users/track. Consulta Puntos de datos para obtener más información.

La Ingesta de datos de Cloud de Braze cuenta para el límite de velocidad disponible, por lo que si envías datos utilizando otro método, el límite de velocidad se combina entre la API de Braze y la Ingesta de datos de Cloud.
Limitaciones del producto
| Limitación | Descripción |
|---|---|
| Número de integraciones | No hay límite en el número de integraciones que puedes configurar. Sin embargo, solo puedes configurar una integración por tabla o vista. |
| Cantidad de filas | De forma predeterminada, cada ejecución puede sincronizar hasta 500 millones de filas. Se detienen todas las sincronizaciones con más de 500 millones de filas nuevas. Si necesitas un límite superior, ponte en contacto con tu administrador del éxito del cliente de Braze o con soporte de Braze. |
| Atributos por fila | Cada fila debe contener un único ID de usuario y un objeto JSON con un máximo de 250 atributos. Cada clave del objeto JSON cuenta como un atributo (es decir, un array cuenta como un atributo). |
| Tamaño de la carga útil | Cada fila puede contener una carga útil de hasta 1 MB. Las cargas útiles superiores a 1 MB se rechazan y se registra el error “La carga útil era superior a 1 MB” en el registro de sincronización, junto con el ID externo asociado y la carga útil truncada. |
| Tipo de datos | Puedes sincronizar atributos de usuario, eventos y compras a través de la Ingesta de datos de Cloud. |
| Región de Braze | Este producto está disponible en todas las regiones de Braze. Cualquier región de Braze puede conectarse a cualquier región de datos de origen. |
| Región de origen | Braze se conecta a tu almacén de datos o entorno en la nube en cualquier región o proveedor de servicios en la nube. |