Personalización sin copia utilizando CDI

Aprende a sincronizar los desencadenantes de Canvas utilizando CDI para una personalización sin copia. Esta característica accede a información específica del usuario desde tu solución de almacenamiento de datos y la transfiere a un Canvas de destino. Los pasos en Canvas pueden incluir opcionalmente campos de personalización que no se conservan en los perfiles de usuario de Braze.

Sincronización de desencadenantes de Canvas

Pasos de inicio rápido

Si ya conoces la CDI de Braze, ten en cuenta que la configuración de una sincronización de desencadenantes de Canvas sigue de cerca el proceso de las sincronizaciones de datos de usuario en el mismo origen, con las siguientes salvedades:

• Solo se admiten identificadores de ID externo o alias de usuario. El correo electrónico y los números de teléfono no son identificadores admitidos.
• Solo se pueden sincronizar usuarios existentes de Braze. No se pueden crear usuarios nuevos.
• PROPERTIES reemplaza a la columna PAYLOAD. Se trata de una cadena JSON con los campos que quieres usar como propiedades de entrada en Canvas para la personalización.

Para empezar, selecciona el tipo de datos Desencadenantes de Canvas al crear una nueva sincronización.

Paso 1: Configura el origen de datos para los desencadenantes de Canvas

Para conocer la tabla de origen o el formato de archivo de tu origen, abre la página de tu origen y selecciona la pestaña Desencadenantes de Canvas. Completa también en esa página la configuración de credenciales y de red.

Si ya tienes credenciales de una sincronización existente, puedes reutilizarlas, pero asegúrate de ampliar el acceso a la tabla de origen de los desencadenantes de Canvas.

Paso 2: Configura tu Canvas de destino

1. Configura tu Canvas de destino para los desencadenantes de Canvas. Crea un Canvas nuevo o selecciona uno existente desencadenado por API. Consulta Tipos de programación de entrada para ver instrucciones sobre cómo crear un Canvas con un tipo de programación de entrega desencadenada por API.
2. Después de seleccionar el tipo de programación de entrega desencadenada por API, continúa con la configuración y crea tu Canvas. Los Canvas pueden ir desde envíos sencillos de un solo mensaje hasta flujos de trabajo complejos para clientes con varios pasos.
3. En tus pasos en Canvas, usa las propiedades de entrada en Canvas para personalizar los mensajes con los campos de propiedades que tienes previsto sincronizar desde tu tabla de origen.
   • Por ejemplo, si en el paso 1 instrumentaste un campo de propiedades para account_balance, usarías la siguiente plantilla de Liquid para personalizar tu mensaje: \{\{canvas_entry_properties.\$\{account_balance\}\}\}.
4. Después de crear tu Canvas, lánzalo y continúa con el Paso 3.

Paso 3: Crea tu sincronización sin copia

Con la configuración del origen completada y el Canvas de destino lanzado, crea una nueva sincronización de datos:

1. En Braze, ve a Configuración de datos > Ingesta de datos en la nube.
2. Configura la conexión introduciendo los detalles de conexión (o reutiliza credenciales existentes) y la tabla de origen del Paso 1.
3. Ponle un nombre a la integración.
4. Selecciona el tipo de datos Desencadenantes de Canvas.
5. Elige tu Canvas de destino (del Paso 2).
6. Elige una frecuencia de sincronización.
7. Configura las preferencias de notificación.
8. Selecciona Probar conexión para confirmar que todo funciona como se espera. Si te conectas a Snowflake, primero añade la clave pública que se muestra en el panel al usuario creado para que Braze se conecte a Snowflake. Para completar este paso, necesitarás acceso SECURITYADMIN o superior en Snowflake.
9. Guarda la sincronización para empezar a sincronizar los desencadenantes de Canvas.

Cuando se ejecute la sincronización, los usuarios de tu tabla de origen empezarán a entrar en el Canvas. Usa los análisis de Canvas y la página de registros de sincronización de la ingesta de datos en la nube para supervisar el rendimiento.

Consejo

Revisa toda tu configuración (desde el comportamiento de la sincronización hasta la configuración del Canvas) para evitar envíos inesperados. La configuración del Canvas, como la limitación de velocidad, la limitación de frecuencia y los filtros de segmentación, puede ajustar aún más la entrega de mensajes.

Braze recomienda hacer una prueba con una audiencia pequeña o de prueba antes de implementar casos de uso en producción.

Consideraciones

Los desencadenantes de Canvas de CDI usan tu límite de velocidad de la REST API para /canvas/trigger/send. Si usas este endpoint a la vez con los desencadenantes de Canvas de CDI y con tu integración de la REST API, ten en cuenta que el uso combinado contará para tu límite de velocidad.

Cada ejecución de sincronización introduce a los usuarios en su Canvas de destino a una tasa máxima de aproximadamente 3,75 millones de usuarios por hora. Prepárate para tiempos más largos entre el origen y la entrada en el Canvas cuando:

• Sincronices más de 3,75 millones de usuarios por ejecución de sincronización.
• Uses desencadenantes de Canvas de CDI cuando ya estés saturando el límite de velocidad de tu REST API para /canvas/trigger/send.

Ten en cuenta lo siguiente sobre la CDI de copia cero cuando el archivado de mensajes está habilitado:

• Los resultados de la tabla se almacenan temporalmente en Braze durante el procesamiento. También se exportan a Snowflake durante 30 días para que puedas ver exactamente qué se sincronizó.
• Los mensajes archivados no se guardan en ningún lugar dentro de Braze. Las copias se envían para almacenarse exclusivamente en el almacenamiento que hayas configurado.
• Cuando usas la CDI de copia cero con desencadenantes de Canvas, Braze no almacena una copia de seguridad de los resultados de la consulta del almacén de datos y no se copia ningún dato en el perfil de usuario.
• Las propiedades de contexto de Canvas pueden registrarse en sistemas internos durante un máximo de 30 días.