Personnalisation sans copie à l’aide de CDI

Découvrez comment synchroniser les déclencheurs de Canvas à l’aide de CDI pour une personnalisation sans copie. Cette fonctionnalité accède aux informations propres à chaque 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 de Braze.

Synchroniser les déclencheurs de Canvas

Étapes de démarrage rapide

Si vous connaissez déjà le CDI de Braze, sachez que la configuration d’une synchronisation de déclencheurs de Canvas suit de près le processus des synchronisations de données utilisateur sur la même source, avec les réserves suivantes :

• Seuls les identifiants de type ID externe ou alias d’utilisateur sont pris en charge. Les adresses e-mail et les numéros de téléphone ne sont pas des identifiants pris en charge.
• 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 contenant les champs que vous souhaitez utiliser comme propriétés d’entrée du Canvas pour la personnalisation.

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

Étape 1 : Configurer la source de données pour les déclencheurs de Canvas

Pour connaître la table source ou le format de fichier de votre source, ouvrez la page de votre source et sélectionnez l’onglet Déclencheurs de Canvas. Effectuez également la configuration des identifiants et du réseau sur cette page.

Si vous disposez déjà d’identifiants provenant d’une synchronisation existante, vous pouvez les réutiliser, mais veillez à étendre l’accès à la table source des déclencheurs de Canvas.

Étape 2 : Configurer votre Canvas de destination

1. Configurez votre Canvas de destination pour les déclencheurs de Canvas. Créez un nouveau Canvas déclenché par API ou sélectionnez-en un existant. Consultez la section Types de planification d’entrée pour savoir comment créer un Canvas avec un type de planification de réception déclenchée par API.
2. Après avoir sélectionné le type de planification de réception déclenchée par API, poursuivez la configuration et créez votre Canvas. Les Canvas peuvent aller de simples envois d’un seul message à des parcours clients complexes comportant plusieurs étapes.
3. Dans les étapes de votre Canvas, utilisez les propriétés d’entrée du Canvas pour personnaliser vos 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 utiliserez 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 zéro copie

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

1. Dans Braze, allez dans Paramètres des données > Ingestion de données cloud.
2. Configurez la connexion en saisissant les informations de connexion (ou en réutilisant des identifiants existants) ainsi que la table source de l’étape 1.
3. Donnez un nom à l’intégration.
4. Sélectionnez le type de données Déclencheurs de Canvas.
5. Choisissez votre Canvas de destination (de l’étape 2).
6. Choisissez une fréquence de synchronisation.
7. Configurez vos préférences de notification.
8. Sélectionnez Tester la connexion pour vérifier que tout fonctionne comme prévu. Si vous vous connectez à Snowflake, ajoutez d’abord la clé publique affichée dans le tableau de bord à l’utilisateur créé pour permettre à Braze de se connecter à Snowflake. Pour réaliser cette étape, vous aurez besoin 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 du Canvas et la page des journaux de synchronisation de l’ingestion de données cloud pour suivre les performances.

Conseil

Vérifiez l’ensemble de votre configuration (du comportement de synchronisation à la configuration du Canvas) pour éviter les envois inattendus. Les paramètres du Canvas, comme la limitation du débit, la limite de fréquence et les filtres de segmentation, permettent d’affiner davantage la distribution des messages.

Braze vous recommande d’effectuer un essai avec une audience réduite ou de test avant de mettre en œuvre des cas d’usage en production.

Points à prendre en compte

Les déclencheurs Canvas CDI consomment votre limite de débit REST API pour /canvas/trigger/send. Si vous utilisez cet endpoint à la fois avec les déclencheurs Canvas CDI et votre intégration REST API, l’utilisation combinée sera décomptée de votre limite de débit.

Chaque exécution de synchronisation fait entrer les utilisateurs dans le Canvas de destination correspondant à un rythme maximal d’environ 3,75 millions d’utilisateurs par heure. Attendez-vous à des délais plus longs entre la source et l’entrée dans le Canvas dans les cas suivants :

• Vous synchronisez plus de 3,75 millions d’utilisateurs par exécution de synchronisation.
• Vous utilisez des déclencheurs Canvas CDI alors que vous atteignez déjà la limite de débit pour /canvas/trigger/send de votre REST API.

Tenez compte des points suivants concernant la CDI zéro copie lorsque l’archivage des messages est activé :

• Les résultats de la table sont stockés temporairement dans Braze pendant le traitement. Ils sont également exportés vers Snowflake pendant 30 jours afin que vous puissiez voir exactement ce qui a été synchronisé.
• Les messages archivés ne sont enregistrés nulle part dans Braze. Les copies sont envoyées pour être stockées exclusivement dans l’espace de stockage que vous avez configuré.
• Lorsque vous utilisez la CDI zéro copie avec des déclencheurs Canvas, Braze ne conserve aucune sauvegarde des résultats de la requête provenant de l’entrepôt de données, et aucune donnée n’est copiée dans le profil utilisateur.
• Les propriétés de contexte Canvas peuvent être journalisées dans des systèmes internes pendant 30 jours maximum.