Intégration de l’entrepôt de données

1. Créez un principal de service et autorisez l’accès aux API Fabric.
2. Configurez un espace de travail partagé et accordez au principal de service l’accès à celui-ci.
3. Dans l’espace de travail Fabric partagé que vous avez créé à l’étape 2, configurez les tables ou les vues que vous souhaitez synchroniser avec Braze.
4. Créez une nouvelle intégration dans le tableau de bord de Braze.
5. Testez l’intégration et démarrez la synchronisation.

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

Braze se connectera à votre entrepôt Fabric à l’aide d’un principal de service avec une authentification Entra ID. Vous créerez un nouveau principal de service dédié à Braze et accorderez l’accès aux ressources Fabric selon les besoins. Braze aura besoin des informations suivantes pour se connecter :

• ID de locataire (également appelé répertoire) de votre compte Azure
• ID du principal (également appelé ID d’application) pour le principal de service
• Secret client pour l’authentification de Braze

1. Dans le portail Azure, accédez au centre d’administration Microsoft Entra, puis à Inscriptions d’applications.
2. Sélectionnez + New registration sous Identity > Applications > App registrations.
3. Saisissez un nom, puis sélectionnez Accounts in this organizational directory only comme type de compte pris en charge. Sélectionnez ensuite 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 et une période d’expiration pour le secret. Sélectionnez ensuite Add.
6. Notez le secret client créé pour l’utiliser dans la configuration de Braze.

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

Vous accorderez à Braze l’accès pour 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 via 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 être placées dans un espace de travail partagé. Si vous n’avez utilisé que l’espace My Workspace par défaut, créez un nouvel espace de travail partagé :

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

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

1. Sélectionnez l’espace de travail, puis sélectionnez 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 activé le paramètre Service principals can use Fabric APIs à l’étape 1.2.
4. Dans le menu déroulant des rôles, sélectionnez Contributor.

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

Étape 1.4 : Configurer la table

Braze prend en charge les tables et 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. Accédez à Create > Data Warehouse > Warehouse dans la console Fabric.

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 vue comme vous le souhaitez, mais les noms de colonnes doivent correspondre à la définition ci-dessus.

• UPDATED_AT : L’heure à laquelle cette ligne a été mise à jour ou ajoutée à la table. Braze synchronise les lignes dont la valeur UPDATED_AT est postérieure à la dernière valeur synchronisée. Les lignes situées exactement à l’horodatage limite peuvent être re-synchronisées si de nouvelles lignes partagent ce même horodatage.
• Colonnes d’identification de l’utilisateur : Votre table peut contenir une ou plusieurs colonnes d’identification de l’utilisateur. Chaque ligne ne doit contenir qu’un seul identifiant (soit external_id, la combinaison de alias_name et alias_label, 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 que vous souhaitez 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 d’alias d’utilisateur. alias_name doit être un identifiant unique et alias_label spécifie le type d’alias. Les utilisateurs peuvent avoir plusieurs alias avec différentes étiquettes, mais un seul alias_name par alias_label.
  • BRAZE_ID : L’identifiant utilisateur Braze. Celui-ci est généré par le SDK Braze, et il n’est pas possible de créer de nouveaux utilisateurs à l’aide d’un ID Braze via l’ingestion de données cloud. Pour créer de nouveaux utilisateurs, spécifiez un ID utilisateur externe ou un alias d’utilisateur.
  • EMAIL : L’adresse e-mail de l’utilisateur. Si plusieurs profils avec la même adresse e-mail existent, le profil le plus récemment mis à jour est prioritaire. Si vous incluez à la fois l’e-mail et le téléphone, l’e-mail est utilisé comme identifiant principal.
  • PHONE : Le numéro de téléphone de l’utilisateur. Si plusieurs profils avec le même numéro de téléphone existent, le profil le plus récemment mis à jour est prioritaire.
• PAYLOAD : Il s’agit d’une chaîne de caractères JSON des champs que vous souhaitez synchroniser avec l’utilisateur dans Braze.

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

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

Étape 1.6 : Autoriser les 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 permettre le trafic en provenance de Braze. Pour plus d’informations, consultez la documentation sur l’accès conditionnel Entra.

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

Étape 2.1 : Configurer une synchronisation d’ingestion de données cloud

Vous allez créer une nouvelle synchronisation de données pour Microsoft Fabric. Dans le tableau de bord de Braze, accédez à Data Settings > Cloud Data Ingestion, sélectionnez Create New Data Sync, puis sélectionnez Microsoft Fabric Import.

Étape 2.2 : Ajouter les informations de connexion Microsoft Fabric et la table source

Saisissez les informations relatives aux identifiants de votre entrepôt Microsoft Fabric et à la table source, puis passez à l’étape suivante.

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

Étape 2.3 : Configurer les détails de la synchronisation

Configurez ensuite les détails suivants pour votre synchronisation :

• Nom de la synchronisation
• Type de données : les types de données pris en charge sont les attributs personnalisés, les événements personnalisés, les événements d’achat, les catalogues et les suppressions d’utilisateurs. Le type de données d’une synchronisation ne peut pas être modifié après sa création.
• Fréquence de synchronisation : la fréquence peut aller de toutes les 15 minutes à une fois par mois. Le fuseau horaire configuré dans votre tableau de bord de Braze sera utilisé pour planifier la synchronisation récurrente.
  • Les synchronisations non récurrentes peuvent être déclenchées manuellement ou via l’API.

Étape 2.4 : Configurer les préférences de notification

Saisissez ensuite les e-mails de contact. Ces coordonnées serviront à vous informer de toute erreur d’intégration, comme la suppression inattendue de l’accès à la table, ou à vous alerter lorsque des lignes spécifiques ne sont pas mises à jour.

Par défaut, les e-mails de contact ne recevront que les notifications d’erreurs globales ou au niveau de la synchronisation, telles que les tables manquantes, les problèmes d’autorisations, etc. Les erreurs globales indiquent des problèmes critiques avec la 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
• (Pour les synchronisations de catalogues uniquement) Le niveau de catalogue n’a plus d’espace

Vous pouvez également configurer des alertes pour les problèmes au niveau des lignes, ou choisir de recevoir une alerte chaque fois qu’une synchronisation s’exécute avec succès.

Après avoir saisi tous les détails de configuration de votre synchronisation, sélectionnez Test connection. En cas de succès, vous verrez un aperçu des données. Si la connexion échoue, un message d’erreur s’affichera pour vous aider à résoudre le problème.

Vous pouvez configurer plusieurs intégrations avec Braze, mais chaque intégration doit être configurée pour synchroniser une table différente. Lors de la création de synchronisations supplémentaires, vous pouvez réutiliser les identifiants existants si vous vous connectez au même compte Fabric.

Si vous réutilisez le même utilisateur entre les 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écutera selon la planification configurée lors de la mise en place. Si vous souhaitez exécuter la synchronisation en dehors de la planification normale ou récupérer les données les plus récentes, sélectionnez Sync Now. Cette exécution n’aura pas d’impact sur les synchronisations futures régulièrement planifiées.