Ir al contenido

Esta página fue traducida automáticamente y puede contener errores. Para informar de un error de traducción, usa el componente de comentarios situado bajo el sumario, a la derecha de la página.

Ingesta de datos de Cloud de Braze

La Ingesta de datos de Cloud (CDI) de Braze 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 la ingesta de datos en la nube (CDI) de Braze, configuras una integración entre tu instancia de almacén de datos y tu espacio de trabajo de Braze para sincronizar datos de forma programada o bajo demanda. Cada integración puede tener su propia programación.

Sincronizaciones programadas: las sincronizaciones recurrentes pueden ejecutarse con una frecuencia de cada 5 minutos o tan esporádicamente 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 costes de computación de tu almacén de datos y el volumen de solicitudes. Para sincronizar con una frecuencia de cada 5 minutos, ponte en contacto con soporte de Braze o tu CSM.
Sincronizaciones bajo demanda: para sincronizar datos en cuanto cambien, llama al endpoint Desencadenar una sincronización con el ID de tu integración cuando finalice tu carga de almacén de datos o trabajo de transformación. Las sincronizaciones bajo demanda no afectan a tu programación recurrente. Solo puede ejecutarse una sincronización por integración a la vez.

Las integraciones de almacenamiento de archivos (Amazon S3, Azure Blob Storage y Google Cloud Storage) están basadas en eventos y no utilizan una programación. Braze ingiere los nuevos archivos a medida que se cargan. Para obtener detalles de configuración, consulta Integraciones de almacenamiento de archivos.

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, cualquier dato actualizado se refleja en Braze.

Ejemplos

Con las capacidades de ingesta de datos en la nube de Braze, puedes:

Crear una integración sencilla directamente desde tu almacén de datos o solución de almacenamiento de archivos a Braze en solo unos minutos.
Sincronizar de forma segura datos de usuario, incluidos atributos, eventos y compras, desde tu almacén de datos a Braze.
Cerrar el ciclo de datos con Braze combinando la ingesta de datos en la nube con Currents o Snowflake Data Sharing.

Además, las fuentes conectadas son una alternativa de copia cero. Puedes hacer que Braze consulte directamente tu almacén de datos o solución de almacenamiento de archivos para construir segmentos CDI —todo ello sin copiar los datos subyacentes a Braze.

Orígenes de datos compatibles

La ingesta de datos en la nube puede sincronizar datos desde:

Almacenes de datos en la nube:

Amazon Redshift
Databricks
Google BigQuery
Microsoft Fabric
Snowflake

Almacenamiento de datos en la nube:

Amazon S3
Azure Blob Storage
Google Cloud Storage

Tipos de datos compatibles

La ingesta de datos en la nube 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

Elementos de catálogo

Mensajería de copia cero

Desencadenantes de Canvas
Fuentes conectadas

Identificadores de usuario para la ingesta de datos

Al sincronizar datos de usuario a través de la ingesta de datos en la nube, puedes identificar a los usuarios utilizando uno o más de los siguientes tipos de identificador. Cada fila de tu tabla de origen debe contener un valor para un solo tipo de identificador a la vez, pero tu 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 múltiples alias con diferentes etiquetas, pero solo un `alias_name` por cada `alias_label`.
`BRAZE_ID`	El identificador de usuario de Braze generado por el SDK de Braze. No se pueden crear nuevos usuarios utilizando un Braze ID a través de la ingesta de datos en la nube. Para crear nuevos usuarios, especifica un ID externo o un alias de usuario.
`EMAIL`	La dirección de correo electrónico del usuario. Si existen múltiples perfiles con la misma dirección de correo electrónico, se prioriza el perfil actualizado más recientemente. Si incluyes tanto correo electrónico como teléfono, el correo electrónico se utiliza como identificador principal.
`PHONE`	El número de teléfono del usuario. Si existen múltiples perfiles con el mismo número de teléfono, se prioriza el 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 en la nube.

Para instrucciones de configuración específicas de cada origen de datos y ejemplos de SQL, consulta Integraciones de almacenes de datos.

Encontrar tu ID de integración

Puedes encontrar tu ID de integración en la URL cuando consultas una integración en el panel de Braze. Ve a Data Settings > Cloud Data Ingestion 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 usar este ID al realizar llamadas a la API para desencadenar sincronizaciones o comprobar el estado de la sincronización.

Uso de puntos de datos

Para los clientes con facturación basada en puntos de datos, la facturación de puntos de datos de la ingesta de datos de Cloud es equivalente a la facturación de las actualizaciones a través del endpoint /users/track. Consulta Puntos de datos para obtener más información.

Importante

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.
Número de filas	De forma predeterminada, cada ejecución puede sincronizar hasta 500 millones de filas. Cualquier sincronización con más de 500 millones de filas nuevas se detiene. Si necesitas un límite más alto, ponte en contacto con tu administrador de éxito de cliente de Braze o con soporte de Braze.
Atributos por fila	Para las sincronizaciones que utilizan una columna `PAYLOAD`, 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	Para las sincronizaciones que utilizan una columna `PAYLOAD`, cada fila puede contener una carga útil de hasta 1 MB. Las cargas útiles superiores a 1 MB se rechazan y el error “Payload was greater than 1MB” se registra 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 personalizados, eventos de compra, elementos de catálogo, solicitudes de eliminación de usuarios y desencadenantes de Canvas 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 origen de datos.
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.

New Stuff!