Extensiones de segmento CDI

Con la ingesta de datos en la nube (CDI) de Braze, puedes configurar una conexión directa desde tu almacén de datos o sistema de almacenamiento de archivos a Braze para sincronizar datos relevantes de usuarios o catálogos de forma recurrente.

Advertencia

Las extensiones de segmento CDI consultan tu almacén de datos directamente, por lo que incurrirás en todos los costos asociados con la ejecución de estas consultas en tu almacén de datos. Las extensiones de segmento CDI no consumen créditos de segmentos SQL, no cuentan para tu límite de extensiones de segmento y no registran puntos de datos.

Requisitos previos

Para utilizar los datos de tu almacén de datos para la segmentación dentro de tu espacio de trabajo de Braze, tendrás que crear un origen conectado y luego crear un segmento CDI dentro de tus extensiones de segmento. Las extensiones de segmento CDI te permiten escribir SQL que consulta directamente tu propio almacén de datos utilizando los datos disponibles a través de tus conexiones CDI, y crear un grupo de usuarios al que se puede dirigir dentro de Braze.

Creación de un segmento CDI

Paso 1: Configura tu origen de datos

Antes de crear tu primera extensión de segmento CDI, configura un nuevo origen de datos conectado con tu almacén de datos siguiendo los pasos en Orígenes de datos conectados.

Paso 2: Crea un segmento

1. Ve a Audiencia > Extensiones de segmento y selecciona Crear nueva extensión.
2. En el menú Selecciona tu experiencia de creación de extensión de segmento, selecciona Actualización completa (incluidos los segmentos CDI).

3. En el menú Selecciona el origen de datos para esta extensión de segmento, elige Tablas de datos CDI. Este menú solo aparece después de que hayas configurado al menos un origen de datos conectado.

4. Selecciona una conexión para usar y luego escribe tu consulta. Cada conexión tiene un conjunto específico de tablas de datos. Tu equipo de desarrollo puede configurar tus conexiones y tablas de datos durante la configuración de CDI.
5. Visualiza las tablas de datos disponibles, incluidos sus esquemas y cualquier descripción disponible, seleccionando Explorador de origen.

6. Escribe el SQL para tu segmento utilizando la sintaxis SQL de Braze. Ten en cuenta que todas las extensiones de segmento CDI deben usar external_user_id como la columna seleccionada, y tu external_user_id debe coincidir con el configurado en Braze para los usuarios.
   
   Si los resultados de tu consulta incluyen usuarios que no existen en Braze, esos usuarios se ignoran. Braze no crea nuevos usuarios basándose en el resultado de tu extensión de segmento CDI.

Importante

external_user_id debe ser un valor de cadena. Si tu ID de origen se almacena como un número (por ejemplo, client_id como un entero), conviértelo a cadena en tu SQL para que coincida con el tipo external_id en Braze.

7. Usa esta extensión de segmento dentro de un Segment de Braze para enviar una Campaign o un Canvas a esta audiencia.

Consejo

Para aprender cómo puedes previsualizar tus extensiones de segmento, gestionar tus extensiones de segmento y ejecutar actualizaciones automatizadas de membresía, consulta Extensiones de segmento SQL.

Consideraciones

• Una extensión de segmento solo puede hacer referencia a datos de una conexión, no de varias.
• Una extensión de segmento puede usar uno de los siguientes como origen de datos: datos de CDI o datos de Braze Snowflake (Currents). No puedes combinar orígenes de datos dentro de una extensión de segmento, pero puedes crear varias extensiones de segmento para hacer referencia a ellas de forma conjunta dentro de un Segment.

Solución de problemas

• Es posible que tu consulta agote el tiempo de espera cuando alcance el tiempo máximo de ejecución, que se configura para cada sincronización de conexión en la página de Cloud Data Ingestion. El tiempo máximo de ejecución permitido es de 60 minutos.
• Asegúrate de que tu SQL esté escrito con la sintaxis adecuada para tu almacén de datos.