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

1. Créez un principal de service et autorisez l’accès à l’espace de travail Fabric qui sera utilisé pour votre intégration.
2. Dans votre espace de travail Fabric, configurez les tables ou les vues que vous souhaitez synchroniser avec Braze.
3. Créez une nouvelle intégration dans le tableau de bord de Braze.
4. Testez l’intégration et débutez la synchronisation.

Étape 1.1 : Configurer le principal du service et lui 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 que Braze utilisera 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 de l’application) pour le principal du service.
• Secret client pour l’authentification de Braze

1. Dans le portail Azure, naviguez vers le centre d’administration de Microsoft Entra, puis vers Enregistrements d’applications
2. Sélectionnez + Nouvel enregistrement sous Identité > Applications > Enregistrements d’applications.
3. Saisissez un nom, puis sélectionnez Accounts in this organizational directory only comme type de compte pris en charge. Sélectionnez ensuite Enregistrer.
4. Sélectionnez l’application (service principal) que vous venez de créer, puis naviguez vers Certificats & secrets > + Nouveau secret client.
5. Saisissez une description et une période d’expiration pour le secret. Sélectionnez ensuite Ajouter.
6. Notez le secret client créé pour être utilisé dans la configuration de Braze.

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

Vous fournirez un accès permettant à Braze de se connecter à votre instance Fabric. Dans votre portail d’administration Fabric, naviguez vers Paramètres > Gouvernance et informations > Portail d’administration > Paramètres des locataires.

• Dans les paramètres du développeur, activez l’option “Principal de service peut utiliser les API de Fabric” pour que Braze puisse se connecter à l’aide de Microsoft Entra ID.
• Dans les paramètres de OneLake, activez “Les utilisateurs peuvent accéder aux données stockées dans OneLake avec des apps externes à Fabric” afin que le principal du service puisse accéder aux données à partir d’une app externe.

Étape 1.3 : Configurer le tableau

Braze prend en charge à la fois les tables et les vues dans les entrepôts Fabric. Si vous devez créer un nouvel entrepôt, allez dans Créer > Entrepôt de données > Entrepôt 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, we will use the email 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 : L’heure à laquelle la rangée a été mise à jour ou ajoutée au tableau. Nous ne synchroniserons que les rangées qui ont été ajoutées ou mises à jour depuis la dernière synchronisation.
• Colonnes d’identification de l’utilisateur - Votre tableau 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). Un tableau source peut comporter des colonnes pour un, deux, trois, quatre ou les cinq types d’identifiants.
  • EXTERNAL_ID : Ceci identifie l’utilisateur que vous désirez mettre à jour. Cela 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 seulement un alias_name par alias_label.
  • BRAZE_ID : L’identifiant d’utilisateur Braze. Celui-ci est généré par le SDK de Braze, et il n’est pas possible de créer de nouveaux utilisateurs à l’aide d’un ID de Braze par le biais de l’ingestion de données dans le cloud. Pour créer de nouveaux utilisateurs, spécifiez un ID utilisateur externe ou un alias utilisateur.
  • EMAIL - L’adresse e-mail de l’utilisateur. S’il existe plusieurs profils avec la même adresse e-mail, le profil le plus récemment mis à jour sera prioritaire pour les mises à jour. Si vous indiquez à la fois l’e-mail et le téléphone, nous utiliserons l’e-mail comme identifiant principal.
  • PHONE - Le 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 le plus récemment mis à jour sera mis à jour en priorité.
• PAYLOAD : Il s’agit d’une chaîne de caractères JSON des champs que vous désirez synchroniser à l’utilisateur dans Braze.

Étape 1.4 : 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 la récupérer, allez dans l’espace de travail dans Fabric, et dans la liste des éléments, survolez le nom de l’entrepôt et sélectionnez Copier la chaîne de connexion SQL.

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

En fonction de 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 sur l’activation de cette fonction, reportez-vous à la documentation relative à l’accès conditionnel d’Entra.

Étape 2.1 : Configuration de la synchronisation d’ingestion de données dans le cloud

Vous allez créer une nouvelle synchronisation de données pour Microsoft Fabric. Dans le tableau de bord de Braze, accédez à Paramètres des données > Ingestion de données dans le cloud, sélectionnez Créer une nouvelle synchronisation de données, puis sélectionnez Importation Microsoft Fabric.

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

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

• Nom de l’identifiant est le libellé utilisé pour ces identifiants dans Braze, vous pouvez définir une valeur ici
• Voir les étapes de la section 1 pour plus de détails sur la façon de récupérer l’ID du locataire, l’ID du principal, le secret du client et la chaîne de connexion.

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

Ensuite, configurez 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. Nous utiliserons le fuseau horaire configuré dans votre tableau de bord de Braze 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

Ensuite, saisissez les e-mails des personnes à contacter. Nous utiliserons ces informations de contact pour vous informer de toute erreur d’intégration, telle que la suppression inattendue de l’accès à la table, ou pour vous alerter lorsque des lignes spécifiques ne sont pas mises à jour.

Par défaut, les e-mails de contact ne recevront que des notifications d’erreurs globales ou au niveau de la synchronisation, telles que des tables manquantes, des autorisations et autres. Les erreurs globales indiquent des problèmes critiques avec la connexion qui empêchent l’exécution des synchronisations. Ces problèmes peuvent être les suivants :

• Problèmes de connectivité
• Manque de ressources
• Problèmes de permissions
• (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 la configuration de votre synchronisation, sélectionnez Tester la connexion. Si vous avez réussi, vous pourrez voir un aperçu des données. Si, pour une raison quelconque, nous ne pouvons pas nous connecter, nous afficherons un message d’erreur pour vous aider à résoudre le problème.

Vous pouvez également définir plusieurs intégrations avec Braze, mais chaque intégration devra être configurée pour se synchroniser à un tableau différent. Lors de la création de synchronisations supplémentaires, vous pouvez réutiliser les informations d’identification existantes si vous vous connectez au même compte Fabric.

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

Lorsqu’elle est activée, votre synchronisation s’effectuera selon la planification configurée lors de la configuration. Si vous souhaitez exécuter la synchronisation en dehors de la planification normale des tests ou récupérer les données les plus récentes, sélectionnez Synchroniser maintenant. Cette exécution n’aura pas d’impact sur les synchronisations futures et habituelles planifiées.