Intégrations d’entrepôts de données

1. Créez un principal de service et accordez-lui l’accès aux API Fabric.
2. Configurez un espace de travail partagé et accordez-y l’accès au principal de service.
3. Dans l’espace de travail Fabric partagé, configurez les tables ou les vues à synchroniser avec Braze.
4. Créez une nouvelle source et une synchronisation dans le tableau de bord de Braze.
5. Testez l’intégration et lancez la synchronisation.

Étape 1.1 : Configurer le principal de service et accorder l’accès

Braze se connecte à votre entrepôt Fabric à l’aide d’un principal de service avec l’authentification Entra ID. Créez un nouveau principal de service que Braze utilisera, et accordez l’accès aux ressources Fabric selon vos besoins. Braze a besoin des informations suivantes pour se connecter :

• ID de locataire (également appelé répertoire) de votre compte Azure
• ID de principal (également appelé ID d’application) pour le principal de service
• Secret client pour permettre à Braze de s’authentifier

1. Dans le portail Azure, accédez au centre d’administration Microsoft Entra, puis à App Registrations.
2. Sélectionnez + New registration sous Identity > Applications > App registrations.
3. Saisissez un nom et sélectionnez Accounts in this organizational directory only comme type de compte pris en charge. Ensuite, sélectionnez Register.
4. Sélectionnez l’application (principal de service) que vous venez de créer, puis accédez à Certificates & secrets > + New client secret.
5. Saisissez une description pour le secret et définissez une période d’expiration. Ensuite, sélectionnez Add.
6. Notez le secret client créé afin de l’utiliser lors de la configuration de Braze.

Remarque

Azure n’autorise pas d’expiration illimitée pour les secrets des principaux de service. Pensez à actualiser les identifiants avant leur expiration pour maintenir le flux de données vers Braze.

Étape 1.2 : Accorder l’accès aux ressources Fabric

Autorisez Braze à se connecter à votre instance Fabric. Dans votre portail d’administration Fabric, accédez à Settings > Governance and insights > Admin portal > Tenant settings.

• Dans Developer settings, activez Service principals can use Fabric APIs pour que Braze puisse se connecter avec Microsoft Entra ID.
• Dans OneLake settings, activez Users can access data stored in OneLake with apps external to Fabric pour que le principal de service puisse accéder aux données depuis une application externe.

Étape 1.3 : Configurer un espace de travail partagé et accorder l’accès

Toutes les ressources Fabric que vous souhaitez connecter à Braze doivent se trouver dans un espace de travail partagé. Si vous n’utilisiez jusqu’à présent que l’espace par défaut My Workspace, créez un nouvel espace de travail partagé :

1. Dans le menu de navigation, sélectionnez Workspaces, puis + New workspace.
2. Saisissez un Name pour l’espace de travail, puis sélectionnez Apply.

Une fois l’espace de travail partagé créé, accordez-y l’accès au principal de service :

1. Sélectionnez l’espace de travail, puis Manage Access.
2. Sélectionnez + Add people or groups.
3. Recherchez et sélectionnez le nom du principal de service créé à l’étape 1.1. S’il n’apparaît pas, vérifiez que vous avez bien activé le paramètre Service principals can use Fabric APIs à l’étape 1.2.
4. Dans la liste déroulante des rôles, sélectionnez Contributor.

Le principal de service peut désormais accéder aux ressources d’entrepôt Fabric de cet espace de travail via leurs endpoints SQL, y compris l’entrepôt à utiliser pour Braze.

Étape 1.4 : Configurer la table

Braze prend en charge les tables comme les vues dans les entrepôts Fabric. Si vous devez créer un nouvel entrepôt, créez-le dans l’espace de travail partagé de l’étape 1.3. Dans la console Fabric, accédez à Create > Data Warehouse > Warehouse.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name]
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PAYLOAD VARCHAR NOT NULL,
  --at least one of external_id, alias_name and alias_label, email, phone, or braze_id is required
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR,
  --braze_id can only be used to update existing users created through the Braze SDK
  BRAZE_ID VARCHAR,
  --If you include both email and phone, email is used as the primary identifier
  EMAIL VARCHAR,
  PHONE VARCHAR
)
GO

Vous pouvez nommer l’entrepôt, le schéma et la table ou la vue comme vous le souhaitez, mais les noms des colonnes doivent correspondre à la définition précédente.

• UPDATED_AT - Moment où cette ligne a été mise à jour dans la table ou ajoutée à celle-ci. Braze synchronise les lignes dont la valeur UPDATED_AT est postérieure à la dernière valeur synchronisée. Les lignes dont l’horodatage correspond exactement à la limite peuvent être synchronisées de nouveau si de nouvelles lignes partagent ce même horodatage.
• Colonnes d’identifiant utilisateur - Votre table peut contenir une ou plusieurs colonnes d’identifiant utilisateur. Chaque ligne ne doit contenir qu’un seul identifiant (soit external_id, soit la combinaison de alias_name et alias_label, soit braze_id, email ou phone). Une table source peut comporter des colonnes pour un, deux, trois, quatre ou les cinq types d’identifiants.
  • EXTERNAL_ID - Identifie l’utilisateur à mettre à jour. Cette valeur doit correspondre à la valeur external_id utilisée dans Braze.
  • ALIAS_NAME et ALIAS_LABEL - Ces deux colonnes créent un objet alias d’utilisateur. alias_name doit être un identifiant unique, et alias_label précise le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec des libellés différents, mais un seul alias_name par alias_label.
  • BRAZE_ID - Identifiant utilisateur Braze. Il est généré par le SDK de Braze, et il est impossible de créer de nouveaux utilisateurs à partir d’un ID Braze via Cloud Data Ingestion. Pour créer de nouveaux utilisateurs, indiquez un ID utilisateur externe ou un alias d’utilisateur.
  • EMAIL - Adresse e-mail de l’utilisateur. S’il existe plusieurs profils avec la même adresse e-mail, le profil mis à jour le plus récemment est prioritaire pour les mises à jour. Si vous incluez à la fois l’e-mail et le téléphone, l’e-mail sert d’identifiant principal.
  • PHONE - Numéro de téléphone de l’utilisateur. S’il existe plusieurs profils avec le même numéro de téléphone, le profil mis à jour le plus récemment est prioritaire pour les mises à jour.
• payload - Chaîne de caractères JSON contenant les champs à synchroniser avec l’utilisateur dans Braze.

Étape 1.5 : Obtenir la chaîne de connexion de l’entrepôt

Pour récupérer l’endpoint SQL de votre entrepôt, accédez à l’espace de travail dans Fabric, survolez le nom de l’entrepôt dans la liste des éléments et sélectionnez Copy SQL connection string.

Étape 1.6 : Autoriser les adresses IP de Braze dans le pare-feu (facultatif)

Selon la configuration de votre compte Microsoft Fabric, vous devrez peut-être autoriser les adresses IP suivantes dans votre pare-feu pour accepter le trafic provenant de Braze. Pour plus d’informations sur cette opération, consultez la documentation sur l’accès conditionnel Entra.

• united states (us)
• european union (eu)
• australia (au)
• indonesia (id)
• japan (jp)
• south korea (kr)

Dans le tableau de bord de Braze, accédez à Paramètres des données > Cloud Data Ingestion > Sources, sélectionnez Ajouter une source de données, puis Microsoft Fabric.

Étape 2.1 : Configurer une synchronisation Cloud Data Ingestion

Choisissez un nom pour votre source et saisissez vos identifiants et votre configuration Microsoft Fabric.

• Nom des identifiants est un libellé pour ces identifiants dans Braze ; vous pouvez y saisir une valeur explicite.
• Consultez les étapes de la section 1 pour savoir comment récupérer l’ID du locataire, l’ID du principal, le secret client et la chaîne de connexion.

Étape 2.2 : Tester la connexion et se connecter à la source

Sélectionnez ensuite Tester la connexion. Une fois le test réussi, finalisez les paramètres restants et sélectionnez Se connecter à la source. Si la connexion échoue, un message d’erreur s’affiche pour vous aider à résoudre le problème.

Remarque

Vous devez tester une source avec succès avant de pouvoir la créer. Si vous fermez la page de création, votre source n’est pas enregistrée.

Étape 3.1 : Configurer les détails de la synchronisation et définir vos données

Saisissez un nom pour votre synchronisation. Sélectionnez ensuite une source active et un type de données de synchronisation. Puis sélectionnez Visuel ou Table et saisissez votre table source, ou sélectionnez SQL pour écrire une requête SQL personnalisée. Enfin, sélectionnez Prévisualiser et valider.

Une fois la validation réussie, un aperçu des données s’affiche. Sélectionnez Suivant : Notifications pour continuer. Si la validation échoue, un message d’erreur s’affiche pour vous aider à résoudre le problème.

Remarque

Vous devez valider une synchronisation avec succès avant de passer aux étapes suivantes. Si vous devez fermer la page de création de la synchronisation, sélectionnez Enregistrer comme brouillon pour conserver votre travail en cours.

Étape 3.2 : Ajouter les préférences de notification

Saisissez une ou plusieurs adresses e-mail de contact pour les notifications d’erreur de synchronisation. Braze utilise ces coordonnées pour envoyer des notifications sur les erreurs d’intégration, comme une perte inattendue de l’accès à une table.

Les adresses e-mail de contact reçoivent uniquement les notifications d’erreurs globales ou au niveau de la synchronisation, comme des tables manquantes ou des problèmes d’autorisations. Elles ne reçoivent pas les problèmes au niveau des lignes. Les erreurs globales signalent des problèmes critiques de connexion qui empêchent l’exécution des synchronisations.

Ces problèmes peuvent inclure :

• Problèmes de connectivité
• Manque de ressources
• Problèmes d’autorisations
• Espace insuffisant dans le niveau de catalogue (synchronisations de catalogue uniquement)

Étape 3.3 : Planification

Enfin, configurez votre synchronisation comme non récurrente ou récurrente.

Les synchronisations non récurrentes s’exécutent uniquement lorsque vous sélectionnez Synchroniser maintenant dans le tableau de bord ou que vous appelez l’endpoint Déclencher une synchronisation.

Les synchronisations récurrentes peuvent s’exécuter aussi souvent que toutes les 5 minutes ou aussi rarement qu’une fois par mois. Par défaut, l’intervalle le plus court que vous pouvez définir dans le tableau de bord est de 15 minutes, ce qui vous aide à maîtriser les coûts de calcul de votre entrepôt et le volume de requêtes. Pour synchroniser jusqu’à toutes les 5 minutes, contactez l’assistance Braze ou votre gestionnaire de la satisfaction client. Braze planifie les synchronisations récurrentes en UTC.

Vous pouvez configurer plusieurs intégrations avec Braze. Lorsque vous créez des synchronisations supplémentaires, vous pouvez réutiliser des identifiants existants si vous vous connectez au même compte Fabric.

Si vous réutilisez le même utilisateur pour plusieurs intégrations, vous ne pouvez pas le supprimer dans le tableau de bord de Braze tant qu’il n’a pas été retiré de toutes les synchronisations actives.

Une fois activée, votre synchronisation s’exécute selon la planification configurée lors de la configuration. Si vous souhaitez lancer la synchronisation en dehors de sa planification ou récupérer les données les plus récentes, sélectionnez Synchroniser maintenant. Cette exécution n’a aucune incidence sur les futures synchronisations planifiées. Pour lancer automatiquement une synchronisation lorsque vos données sont mises à jour, appelez l’endpoint Déclencher une synchronisation depuis votre pipeline.