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 los desencadenantes de Canvas

Pasos para una puesta en marcha rápida

Si ya estás familiarizado con Braze CDI, ten en cuenta que la configuración de la sincronización de desencadenantes de Canvas sigue muy de cerca el proceso de las integraciones de CDI de datos de usuario, con las siguientes salvedades:

• Solo se admiten identificadores de ID externo o alias de usuario. Los correos electrónicos y los números de teléfono no son identificadores válidos.
• Solo se pueden sincronizar los usuarios existentes de Braze. No se pueden crear nuevos usuarios.
• properties reemplaza la columna payload. Es una cadena JSON de los campos que deseas utilizar como propiedades de entrada de Canvas para la personalización.

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

Uso de los desencadenantes de Canvas

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

• snowflake
• redshift
• bigquery
• databricks
• fabric
• file storage

1
2
3
4
5
6
7
8
9
10
11
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id or alias_name and alias_label is required  
     EXTERNAL_ID VARCHAR(16777216),
     --if using user alias, both alias_name and alias_label are required
     ALIAS_LABEL VARCHAR(16777216),
     ALIAS_NAME VARCHAR(16777216),
     PROPERTIES VARCHAR(16777216)
);

1
2
3
4
5
6
7
8
9
10
11
12
13
CREATE ROLE BRAZE_INGESTION_ROLE;

GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC TO ROLE BRAZE_INGESTION_ROLE;

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;
GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

CREATE USER BRAZE_INGESTION_USER;
GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

1
2
3
4
5
6
7
8
9
10
11
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC (
    updated_at timestamptz default sysdate not null,
    --at least one of external_id or alias_name and alias_label is required
    external_id varchar not null,.
    --if using user alias, both alias_name and alias_label are required
    alias_label varchar,
    alias_name varchar,
    properties varchar(max)
 );

1
2
3
CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE CANVAS_TRIGGERS_SYNC TO braze_user;

1
CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

1
2
3
4
5
6
7
8
9
10
CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp,
  --At least one of external_id or alias_name and alias_label is required  
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  properties JSON
);

1
CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

1
2
3
4
5
6
7
8
9
10
CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp(),
  --At least one of external_id or alias_name and alias_label is required  
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  properties STRING, STRUCT, or MAP
);

1
2
3
4
5
6
7
8
9
10
11
CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name] 
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PROPERTIES VARCHAR NOT NULL,
  --at least one of external_id or alias_name and alias_label is required  
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR
)
GO

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 que se desencadene por API. Consulta Tipos de programación de entradas para obtener instrucciones sobre cómo crear un Canvas con un tipo de programación de entrega desencadenado 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 variar desde simples envíos de un solo mensaje hasta complejos flujos de trabajo para clientes con múltiples pasos.
3. Dentro de tus pasos en Canvas, utiliza las propiedades de entrada de Canvas para personalizar los mensajes con los campos de propiedades que planeas sincronizar desde tu tabla de origen.
   • Por ejemplo, si en el paso 1 instrumentaste un campo de propiedades para account_balance, utilizarías la siguiente plantilla 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

Una vez completada la configuración del origen de datos y lanzado el Canvas, 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 datos de conexión (o reutiliza las credenciales existentes) y la tabla de origen del paso 1.
3. Proporciona un nombre para la integración.
4. Selecciona el tipo de datos Canvas Triggers.
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 Test Connection para confirmar que todo funciona según lo previsto. Si te conectas a Snowflake, primero añade la clave pública que se muestra en el dashboard 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 comenzar a sincronizar los desencadenantes de Canvas.

Cuando se ejecute la sincronización, los usuarios de tu tabla de origen comenzarán a entrar en el Canvas. Utiliza 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.

Consideraciones

Los desencadenantes de CDI Canvas utilizan tu límite de velocidad de la API REST para /canvas/trigger/send. Si utilizas este punto de conexión simultáneamente con los desencadenantes de CDI Canvas y tu integración de API REST, ten en cuenta que el uso combinado se contabilizará en tu límite de velocidad.

Mientras los desencadenantes de CDI Canvas se encuentran en fase de acceso anticipado, ten en cuenta los siguientes detalles:

• Hasta 5 sincronizaciones activas de desencadenantes de Canvas por espacio de trabajo
• Cada ejecución de sincronización introducirá a los usuarios en su Canvas de destino respectivo a una tasa máxima de aproximadamente 3,75 millones de usuarios por hora.
  • Prepárate para tiempos de entrada más largos desde el origen hasta Canvas cuando:
    • Sincronices más de 3,75 millones de usuarios por cada ejecución de sincronización.
    • Uses los desencadenantes de CDI Canvas cuando ya hayas saturado el límite de velocidad de tu API REST para /canvas/trigger/send.