Synchroniser les données de BrazeAI Decisioning Studio

Cette page explique comment synchroniser les données de votre entrepôt de données directement vers BrazeAI Decisioning Studio™ à l’aide de l’ingestion de données cloud (CDI).

Grâce à la destination Decisioning Studio de CDI, CDI peut également synchroniser les données de votre entrepôt directement vers BrazeAI Decisioning Studio. Les données issues de ces synchronisations sont mises à disposition de Decisioning Studio pour l’activation, mais vos profils utilisateur et vos espaces de travail Braze restent inchangés.

Important

Cette fonctionnalité est en accès anticipé. Contactez votre gestionnaire du succès des clients ou votre gestionnaire de compte pour y accéder.

Fonctionnement

Lorsque vous créez une synchronisation, choisissez Decisioning Studio comme destination et rédigez une requête SQL qui renvoie les données à synchroniser. CDI exécute cette requête selon la planification que vous avez définie et transmet les résultats sous forme de ressource Decisioning Studio. Chaque synchronisation correspond à une seule ressource : vous ne pouvez donc pas diriger plusieurs synchronisations vers la même ressource.

Contrairement aux synchronisations vers la plateforme de données Braze, les synchronisations Decisioning Studio n’associent pas vos données à des profils utilisateurs, des événements ou des catalogues.

Pour découvrir les autres moyens de rendre vos données disponibles dans Decisioning Studio, consultez Connecter vos données.

Prérequis

• Un accès à Braze et à BrazeAI Decisioning Studio.
• Une source d’entrepôt de données Cloud Data Ingestion active. Si vous n’en avez pas encore configuré, consultez la page Sources de Cloud Data Ingestion.
• La table ou la vue que vous souhaitez synchroniser.
• Une ou plusieurs colonnes de cette table à utiliser comme clé primaire, ainsi qu’une colonne d’horodatage que CDI peut utiliser pour la synchronisation incrémentielle.

Créer une synchronisation Decisioning Studio

Étape 1 : Créer la synchronisation et sélectionner la destination

1. Accédez à Paramètres des données > Ingestion de données cloud > Synchronisations.
2. Sélectionnez Créer une synchronisation de données.
3. Saisissez un Nom d’intégration, puis sélectionnez votre source sous Sources de données.
4. Sous Destination, définissez Destination des données sur BrazeAI Decisioning Studio™.
5. Sous Catégorie de données, sélectionnez le type de données Decisioning Studio qui correspond le mieux à votre table. Vous avez le choix entre Profil utilisateur, Événements d’engagement liés aux messages, Événements de conversion ou Autre. Ce choix étiquette les données pour Decisioning Studio, sans modifier la façon dont CDI traite vos lignes.

Étape 2 : Rédiger votre requête SQL

À l’étape Définition des données, rédigez une requête SQL qui renvoie les données de la table ou de la vue que vous souhaitez synchroniser. Le résultat de la requête devient le schéma de votre synchronisation.

Vous pouvez utiliser l’explorateur de sources pour parcourir les tables et vues disponibles, ou le générateur SQL par IA pour vous aider à rédiger votre requête.

Votre requête doit renvoyer une colonne UPDATED_AT, car CDI utilise UPDATED_AT pour la synchronisation incrémentielle et le suivi des modifications. À chaque exécution, CDI ne synchronise que les lignes dont la valeur UPDATED_AT est postérieure à la dernière valeur synchronisée. Si la colonne d’horodatage que vous avez identifiée ne s’appelle pas déjà UPDATED_AT, vous pouvez lui attribuer un alias dans votre requête :

1

SELECT *, LAST_MODIFIED AS UPDATED_AT FROM my_table

Pour en savoir plus sur la façon dont UPDATED_AT contrôle la synchronisation incrémentielle, y compris ce qui se passe lorsque vous reculez sa valeur, consultez Comprendre la colonne UPDATED_AT.

Remarque

Seules les requêtes en lecture seule à instruction unique sont prises en charge, y compris les clauses JOIN. CDI exécute des requêtes en lecture seule et ne modifie pas vos tables sous-jacentes.

Étape 3 : Prévisualiser et valider votre requête

Sélectionnez Prévisualiser et valider pour exécuter votre requête. La section Aperçu de la requête (10 premières lignes) affiche les 10 premières lignes renvoyées par votre source, ainsi que le type de données détecté pour chaque colonne. Vous pouvez ainsi vérifier que les données sont correctes avant de continuer.

Étape 4 : Sélectionner une clé primaire

Chaque synchronisation Decisioning Studio nécessite une clé primaire ou composite, c’est-à-dire une ou plusieurs colonnes qui identifient chaque ligne de manière unique. Une fois la validation réussie, ouvrez la liste déroulante Clé primaire et sélectionnez la colonne qui servira de clé primaire. Si vous sélectionnez plusieurs colonnes, elles forment une clé composite.

Conseil

Une bonne clé primaire est unique pour chaque ligne, jamais vide et stable d’une exécution de synchronisation à l’autre. Évitez les valeurs générées au moment de la requête, comme UUID() ou CURRENT_TIMESTAMP, car elles peuvent entraîner des lignes en double ou perdues.

Étape 5 : Configurer les notifications et la planification, puis créer la synchronisation

1. À l’étape Notifications, saisissez une ou plusieurs adresses dans E-mail(s) de contact pour recevoir les notifications d’erreur de synchronisation. Vous pouvez également activer les notifications Erreur de ligne et Synchronisation réussie.
2. À l’étape Planification, activez Synchronisation récurrente pour exécuter automatiquement la synchronisation selon une planification. Lorsque Synchronisation récurrente est désactivée, la synchronisation ne s’exécute que lorsque vous la déclenchez, soit manuellement depuis le tableau de bord, soit via l’endpoint Déclencher une synchronisation.
3. Vérifiez le Résumé, puis créez la synchronisation.

Modifier une synchronisation

Lorsque vous modifiez une synchronisation existante, toute modification de votre requête SQL doit être revalidée avant de pouvoir l’enregistrer. Les clés primaires et composites ne peuvent pas être modifiées et doivent toujours être renvoyées par la requête.

Les modifications valides prennent effet lors de la prochaine exécution de la synchronisation.

Gestion des modifications de schéma

CDI gère les modifications du schéma source de manière additive. À chaque exécution de synchronisation, CDI compare votre schéma source à la ressource Decisioning Studio existante et ajoute les nouvelles colonnes tout en conservant celles déjà présentes.

Lorsque CDI détecte une modification de schéma, celle-ci s’affiche dans les détails d’exécution de la synchronisation et sur la page de modification de la synchronisation, et vos contacts de notification reçoivent une alerte par e-mail. Pour modifier les colonnes livrées, mettez à jour votre requête SQL et validez-la à nouveau.