Personnalisation sans copie à l’aide du CDI

Découvrez comment synchroniser les déclencheurs de Canvas à l’aide de CDI pour une personnalisation sans copie. Cette fonctionnalité permet d’accéder à des informations spécifiques à l’utilisateur à partir de votre solution de stockage de données et de les transmettre à 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 de Braze.

Synchronisation des déclencheurs Canvas

Démarrage rapide

Si vous connaissez déjà le CDI de Braze, notez que la configuration d’un déclencheur de synchronisation Canvas suit de près le processus d’intégration de données utilisateur dans le CDI, avec les mises en garde suivantes :

• Seuls les ID externes ou les alias d’utilisateurs sont pris en charge. Les e-mails et les numéros de téléphone ne sont pas des identifiants pris en charge.
• Seuls les utilisateurs existants de Braze 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 dans Canvas pour la personnalisation.

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

Utilisation des déclencheurs Canvas

Étape 1 : Configuration de 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 : Configurez votre Canvas de destination

1. Configurez vos déclencheurs Canvas for Canvas de destination. Créez un nouveau canvas ou sélectionnez un canvas existant déclenché par l’API. Reportez-vous à la section Types de planification d’entrée pour savoir comment créer un canvas avec un type de planification de réception/distribution déclenché par l’API.
2. Après avoir sélectionné le type de planification de réception/distribution déclenchée par l’API, poursuivez la configuration de Canvas et créez votre Canvas. Les canevas peuvent aller du simple envoi d’un message unique à des flux de travail complexes pour les clients, avec plusieurs étapes.
3. Dans vos étapes du canvas, utilisez les propriétés d’entrée du canvas pour personnaliser les messages avec les champs de propriétés que vous prévoyez de synchroniser à partir de votre table source.
   • Par exemple, si à l’étape 1 vous avez instrumenté un champ de propriétés pour account_balance, vous utiliserez le modèle Liquid suivant pour personnaliser votre message : \{\{canvas_entry_properties.\$\{account_balance\}\}\}.
4. Après avoir créé votre Canvas, lancez-le et passez à l’étape 3.

Étape 3 : Créez votre copie zéro de synchronisation

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

1. Dans Braze, accédez à Paramètres des données > Ingestion de données dans le cloud.
2. Établissez la connexion en saisissant les détails de la connexion (ou en réutilisant les informations d’identification existantes) et le tableau source de l’étape 1.
3. Donnez un nom à l’intégration.
4. Sélectionnez le type de données des déclencheurs Canvas.
5. Choisissez votre canvas de destination (à partir de l’étape du canvas 2).
6. Choisissez une fréquence de synchronisation.
7. Définir les préférences de notification.
8. Sélectionnez Tester la connexion pour confirmer que tout fonctionne comme prévu. Si vous vous connectez à Snowflake, ajoutez d’abord la clé publique affichée sur le tableau de bord à l’utilisateur créé pour Braze afin de vous connecter à Snowflake. Pour réaliser 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 de Canvas.

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

Considérations

Les déclencheurs CDI Canvas utilisent la limite de débit de votre API REST pour /canvas/trigger/send. Si vous utilisez cet endpoint simultanément avec des déclencheurs CDI Canvas et votre intégration REST API, attendez-vous à ce que l’utilisation combinée soit prise en compte dans votre limite de débit.

Bien que les déclencheurs CDI Canvas soient en accès anticipé, tenez compte des détails suivants :

• Jusqu’à 5 synchronisations actives du déclencheur Canvas par espace de travail
• Chaque cycle de synchronisation entrera les utilisateurs dans leur canvas de destination respectif à un rythme maximum d’environ 3,75 millions d’utilisateurs par heure.
  • Préparez-vous à des délais d’entrée plus longs entre la source et le canvas lorsque :
    • Synchronisation de plus de 3,75 millions d’utilisateurs par cycle de synchronisation.
    • Utiliser les déclencheurs CDI Canvas lorsque vous saturez déjà la limite de débit de votre API REST pour /canvas/trigger/send.