Personnalisation sans copie à l’aide de CDI

Découvrez comment synchroniser les déclencheurs Canvas à l’aide de CDI pour une personnalisation sans copie. Cette fonctionnalité accède aux informations spécifiques à l’utilisateur depuis votre solution de stockage de données et les transmet à un Canvas de destination. Les étapes du Canvas peuvent éventuellement inclure des champs de personnalisation qui ne sont pas conservés dans les profils utilisateurs Braze.

Synchronisation des déclencheurs Canvas

Étapes de démarrage rapide

Si vous connaissez déjà Braze CDI, notez que la configuration d’une synchronisation de déclencheur Canvas suit de près le processus des intégrations CDI de données utilisateur, avec les réserves suivantes :

• Seuls les ID externes ou les alias d’utilisateur sont pris en charge. Les adresses e-mail et les numéros de téléphone ne sont pas des identifiants acceptés.
• Seuls les utilisateurs Braze existants peuvent être synchronisés. Il n’est pas possible de créer de nouveaux utilisateurs.
• properties remplace la colonne payload. Il s’agit d’une chaîne de caractères JSON des champs que vous souhaitez utiliser comme propriétés d’entrée Canvas pour la personnalisation.

Pour commencer, sélectionnez le type de données Canvas Triggers lors de la création d’une nouvelle synchronisation.

Utilisation des déclencheurs Canvas

Étape 1 : Configurer la source de données pour les déclencheurs 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

Étape 2 : Configurer votre Canvas de destination

1. Configurez votre Canvas de destination pour les déclencheurs Canvas. Créez un nouveau Canvas déclenché par API ou sélectionnez-en un existant. Consultez Types de planification d’entrée pour savoir comment créer un Canvas avec un type de planification de réception déclenché par API.
2. Après avoir sélectionné le type de planification de réception déclenché par API, poursuivez la configuration et créez votre Canvas. Les Canvas peuvent aller de simples envois de messages uniques à des workflows clients complexes comportant plusieurs étapes.
3. Dans vos étapes du Canvas, utilisez les propriétés d’entrée Canvas pour personnaliser les messages avec les champs de propriétés que vous prévoyez de synchroniser depuis votre table source.
   • Par exemple, si à l’étape 1 vous avez instrumenté un champ de propriétés pour account_balance, vous utiliseriez le modèle Liquid suivant pour personnaliser votre message : \{\{canvas_entry_properties.\$\{account_balance\}\}\}.
4. Une fois votre Canvas créé, lancez-le et passez à l’étape 3.

Étape 3 : Créer votre synchronisation sans copie

Une fois la configuration de la source terminée et le Canvas de destination lancé, créez une nouvelle synchronisation de données :

1. Dans Braze, accédez à Paramètres des données > Ingestion de données cloud.
2. Configurez la connexion en saisissant les informations de connexion (ou en réutilisant les identifiants existants) et la table source de l’étape 1.
3. Attribuez un nom à l’intégration.
4. Sélectionnez le type de données Canvas triggers.
5. Choisissez votre Canvas de destination (depuis l’étape 2).
6. Choisissez une fréquence de synchronisation.
7. Configurez vos préférences de notification.
8. Sélectionnez Test Connection pour vérifier que tout fonctionne correctement. Si vous vous connectez à Snowflake, ajoutez d’abord la clé publique affichée sur le tableau de bord à l’utilisateur créé pour permettre à Braze de se connecter à Snowflake. Pour cette étape, vous devez disposer d’un accès SECURITYADMIN ou supérieur dans Snowflake.
9. Enregistrez la synchronisation pour commencer à synchroniser les déclencheurs Canvas.

Lorsque la synchronisation s’exécute, les utilisateurs de votre table source commencent à entrer dans le Canvas. Utilisez les analyses Canvas et la page des journaux de synchronisation de l’ingestion de données cloud pour surveiller les performances.

Considérations

Les déclencheurs CDI Canvas utilisent votre limite de débit de l’API REST pour /canvas/trigger/send. Si vous utilisez cet endpoint simultanément avec les déclencheurs CDI Canvas et votre intégration API REST, l’utilisation combinée sera comptabilisée dans votre limite de débit.

Les déclencheurs CDI Canvas étant en accès anticipé, prenez en compte les détails suivants :

• Jusqu’à 5 synchronisations de déclencheurs Canvas actives par espace de travail
• Chaque exécution de synchronisation fait entrer les utilisateurs dans leur Canvas de destination respectif à un rythme maximal d’environ 3,75 millions d’utilisateurs par heure.
  • Préparez-vous à des délais plus longs entre la source et l’entrée dans le Canvas lorsque :
    • Vous synchronisez plus de 3,75 millions d’utilisateurs par cycle de synchronisation.
    • Vous utilisez les déclencheurs CDI Canvas alors que la limite de débit de votre API REST pour /canvas/trigger/send est déjà saturée.