Ir al contenido

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 hasta cada 5 minutos o tan poco 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 cómputo de tu almacén de datos y el volumen de solicitudes. Para sincronizar con una frecuencia de hasta cada 5 minutos, ponte en contacto con el soporte de Braze o con tu administrador de éxito del cliente.
  • Sincronizaciones bajo demanda: Para sincronizar los datos en cuanto cambien, llama al endpoint Desencadenar una sincronización con el ID de tu integración cuando termine tu trabajo de carga o transformación en el almacén de datos. 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) se basan en eventos y no usan una programación. Braze ingiere los archivos nuevos a medida que se suben. Para conocer los detalles de configuración, consulta Amazon S3, Google Cloud Storage o Azure Blob Storage.

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.

Casos de uso

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 los 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 sin copia. Puedes hacer que Braze consulte directamente tu almacén de datos o solución de almacenamiento de archivos para crear 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 los siguientes orígenes. Cada origen tiene su propia página de configuración en Orígenes de la ingesta de datos en la nube.

Almacenes de datos

Almacenamiento de archivos

Tipos de datos compatibles

La ingesta de datos en la nube admite los siguientes tipos de datos:

Datos de usuario

  • Atributos de usuario, incluidos:
    • 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
  • Objetos de datos, incluidas las relaciones de usuarios y las relaciones de objetos

Mensajería sin copia

  • Desencadenantes de Canvas
  • Fuentes conectadas

Identificadores de usuario para la ingesta de datos

Cuando sincronizas datos de usuario mediante la ingesta de datos en la nube, puedes identificar a los usuarios con uno o varios 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 identificador.

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 que se usa 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 cada alias_label.
BRAZE_ID El identificador de usuario de Braze generado por el SDK de Braze. No se pueden crear nuevos usuarios con un ID de Braze mediante la ingesta de datos en la nube. 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 prioriza para las actualizaciones el perfil actualizado más recientemente. Si incluyes tanto el correo electrónico como el teléfono, se usa el correo electrónico 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 prioriza para las actualizaciones el perfil actualizado más recientemente.

Para obtener información detallada sobre cómo configurar 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 ver instrucciones de configuración específicas de cada origen y ejemplos de SQL, consulta Orígenes de la ingesta de datos en la nube.

Encontrar tu ID de integración

Puedes encontrar tu ID de integración en la URL cuando ves una integración en el panel de Braze. Ve a Configuración de datos > Ingesta de datos en la nube 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 hacer llamadas a la API para desencadenar sincronizaciones o comprobar su estado.

Uso de puntos de datos

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

Limitaciones del producto

Limitación Descripción
Número de integraciones No hay límite en la cantidad de integraciones que puedes configurar.
Número de filas De forma predeterminada, cada ejecución puede sincronizar hasta 500 millones de filas. Se detendrá cualquier sincronización con más de 500 millones de filas nuevas. Si necesitas un límite superior, ponte en contacto con tu administrador de éxito del cliente de Braze o con el soporte de Braze.
Atributos por fila Para las sincronizaciones que usan una columna PAYLOAD, cada fila debe contener un único ID de usuario y un objeto JSON con hasta 250 atributos. Cada clave del objeto JSON cuenta como un atributo (es decir, una matriz cuenta como un atributo).
Campos por objeto de datos Un tipo de objeto de datos puede tener hasta 500 campos. Una relación entre dos tipos puede tener hasta 25 campos.
Tamaño de la carga útil Para las sincronizaciones que usan 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, solicitudes de eliminación de usuarios, desencadenantes de Canvas, artículos del catálogo, objetos de datos y relaciones entre objetos de datos mediante la ingesta de datos en la nube.
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 nube.
New Stuff!