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é permet d’accéder aux informations spécifiques à l’utilisateur à partir de 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, veuillez noter que la configuration d’une synchronisation de déclencheur Canvas suit de près le processus d’intégration CDI des données utilisateur, avec les réserves suivantes :

• Seuls les ID externes ou les alias d’utilisateur sont pris en charge. Les adresses de 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 lapayloadcolonne. 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, veuillez sélectionner 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 : Veuillez configurer votre destination canvas.

1. Configurez votre destination Canvas pour les déclencheurs Canvas. Veuillez créer un nouveau canvas déclenché par API ou sélectionner un canvas existant. Veuillez vous référer aux types de planification de saisie pour obtenir des instructions sur la manière de créer un canvas avec un type de planification de réception/distribution déclenché par API.
2. Après avoir sélectionné le type de planification de livraison déclenché par l’API, veuillez poursuivre la configuration de Canvas et créer votre Canvas. Les canevas peuvent aller de simples envois de messages à des flux de travail clients personnalisés comportant plusieurs étapes.
3. Dans vos étapes du canvas, veuillez utiliser les propriétés d’entrée Canvas pour réaliser la personnalisation des 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 utiliseriez le modèle Liquid suivant pour réaliser la personnalisation de votre message : \{\{canvas_entry_properties.\$\{account_balance\}\}\}.
4. Une fois votre canvas créé, veuillez le lancer et passer à l’étape 3.

Étape 3 : Veuillez créer votre synchronisation sans copie.

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

1. Dans Braze, veuillez vous rendre dans Paramètres des données > Ingestion de données cloud.
2. Veuillez configurer la connexion en saisissant les informations de connexion (ou en réutilisant les identifiants existants) et la table source de l’étape 1.
3. Veuillez attribuer un nom à l’intégration.
4. Veuillez sélectionner le type de données « Déclencheurs Canvas ».
5. Veuillez sélectionner votre destination Canvas (à partir de l’étape 2).
6. Veuillez sélectionner une fréquence de synchronisation.
7. Veuillez configurer vos préférences de notification.
8. Veuillez sélectionner « Tester la connexion » pour vérifier que tout fonctionne correctement. Si vous vous connectez à Snowflake, veuillez d’abord ajouter la clé publique affichée sur le tableau de bord de Braze à l’utilisateur créé pour Braze afin de vous connecter à Snowflake. Pour effectuer 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 est effectuée, les utilisateurs de votre tableau source commenceront à entrer dans Canvas. Veuillez utiliser les analyses Canvas et la page des journaux de synchronisation de l’ingestion de données pour surveiller les performances.

Considérations

Les déclencheurs CDI canvas utilisent votre limite de débit 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, veuillez noter que l’utilisation combinée sera prise en compte dans votre limite de débit.

Les déclencheurs CDI canvas étant actuellement en accès anticipé, veuillez prendre en considération les détails suivants :

• Jusqu’à 5 synchronisations de déclencheurs canvas actives par espace de travail
• Chaque synchronisation permettra d’ajouter des utilisateurs à leur canvas de destination respective à un rythme maximal d’environ 3,75 millions d’utilisateurs par heure.
  • Veuillez vous préparer à des délais plus longs entre la source et l’entrée dans canvas lorsque :
    • Synchronisation de plus de 3,75 millions d’utilisateurs par cycle de synchronisation.
    • Utilisation des déclencheurs CDI Canvas lorsque la limite de débit de votre API REST est déjà saturée pour /canvas/trigger/send.