Ingestion de données cloud : Mappeur visuel

Cette page explique comment utiliser le mappeur visuel pour synchroniser une table ou une vue depuis votre entrepôt de données vers Braze, sans écrire de SQL ni restructurer vos données.

Le mappeur visuel est disponible pour les synchronisations d’attributs, d’événements personnalisés et de déclencheurs Canvas, sur toutes les sources d’entrepôt de données de l’ingestion de données cloud. Pour les autres types de synchronisation, consultez Choisir une option de définition des données.

Avec le mappeur visuel, vous pouvez synchroniser une table ou une vue existante de votre entrepôt de données sans écrire de SQL ni restructurer vos données en amont. Au lieu de créer une table spécifique à Braze avec les colonnes EXTERNAL_ID, UPDATED_AT et payload, vous mappez directement les colonnes de votre table existante aux champs Braze dans le tableau de bord.

Prérequis

Avant de créer une synchronisation avec le mappeur visuel, vous aurez besoin des éléments suivants :

• Une source d’entrepôt de données Cloud Data Ingestion active. Si vous n’en avez pas encore configuré, consultez Sources de Cloud Data Ingestion.
• Le nom de la table ou de la vue que vous souhaitez synchroniser, tel qu’il apparaît dans votre entrepôt de données.
• Une colonne de votre table contenant un identifiant utilisateur pris en charge, et une colonne contenant un horodatage que Braze peut utiliser pour le suivi des modifications.

Remarque

Braze exécute uniquement des requêtes en lecture seule sur vos données et ne modifie pas vos tables sous-jacentes. Des objets temporaires peuvent être créés pendant l’exécution des requêtes, mais ils ne sont pas conservés.

Création d’une synchronisation avec le mappeur visuel

Étape 1 : Configurer la synchronisation

1. Accédez à Paramètres des données > Ingestion de données cloud > Synchronisations, puis sélectionnez Créer une synchronisation de données.
2. Choisissez un nom pour votre synchronisation et sélectionnez une source de données active. Seules les sources actives peuvent être utilisées.
3. Pour Destination des données, sélectionnez Braze Data Platform.
4. Sélectionnez un Type de données.
5. Sélectionnez Suivant : Définition des données.

Étape 2 : Mapper le schéma source

1. À l’étape Définition des données, sélectionnez Visuel.
2. Saisissez le nom de la table ou de la vue tel qu’il apparaît dans votre entrepôt de données.
3. Sélectionnez Mapper le schéma source. Braze lit le schéma de votre table ou de votre vue et répertorie chaque colonne avec son type de données détecté, afin que vous puissiez la mapper à un champ Braze.

Étape 3 : Vérifier vos mappages

La section Vérifier le mappage suit deux mappages obligatoires. Votre synchronisation ne peut pas être créée tant qu’ils ne sont pas tous les deux terminés :

• Mappez une colonne à un identifiant utilisateur accepté par Braze : external_id, braze_id, email, phone ou un alias d’utilisateur. Les options d’identifiant apparaissent sous Identifiants dans la liste déroulante du champ de destination.
• Mappez une colonne à updated_at. Braze utilise cet horodatage pour le suivi des modifications : chaque exécution de la synchronisation importe les lignes dont la valeur updated_at est postérieure à la dernière valeur synchronisée.

Pour chacune des colonnes restantes, vous pouvez :

• Conserver le mappage par défaut. Chaque colonne est mappée à un champ Braze portant le même nom. Si le champ n’existe pas encore dans votre espace de travail, il est marqué Nouvel attribut et sera créé lors de la première exécution de la synchronisation.
• Mapper à un champ existant. Recherchez dans la liste déroulante du champ de destination pour mapper une colonne à un attribut par défaut ou personnalisé existant dans votre espace de travail.
• Mapper à un nouveau champ. Saisissez directement dans la liste déroulante du champ de destination pour mapper une colonne à un nouvel attribut personnalisé.
• Exclure la colonne. Décochez la case Importer pour exclure une colonne de la synchronisation.

Conseil

Avant de créer un nouvel attribut, recherchez-en un existant dans la liste déroulante de destination. Par exemple, si votre table contient une colonne fav_color alors que votre espace de travail suit déjà favorite_color, envisagez de mapper fav_color à favorite_color plutôt que de créer un autre attribut.

Remarque

Les champs dont le type de données ne correspond pas au type détecté pour votre colonne affichent un avertissement Incompatibilité de type. Vous pouvez tout de même continuer, mais les valeurs incompatibles risquent de ne pas se synchroniser et d’apparaître comme des erreurs de ligne. Vous pouvez consulter les erreurs de ligne dans les détails d’exécution d’une synchronisation.

Étape 4 : Prévisualiser et valider

Sélectionnez Prévisualiser et valider pour lancer une vérification en lecture seule de votre table ou de votre vue. L’aperçu affiche les 10 premières lignes avec les noms de champs mappés et inclut uniquement les colonnes que vous importez.

Étape 5 : Terminer la création de la synchronisation

1. À l’étape Notifications, saisissez au moins une adresse e-mail de contact pour les notifications d’erreur de synchronisation. Vous pouvez également activer les alertes Erreur de ligne (envoyées lorsqu’un certain pourcentage de lignes ne parvient pas à se mettre à jour) et les notifications Synchronisation réussie.
2. À l’étape Planification, activez Synchronisation récurrente pour exécuter la synchronisation selon une planification, ou laissez-la désactivée pour une synchronisation ponctuelle.
3. Vérifiez l’étape Résumé. Elle récapitule votre configuration, indique quels attributs sont nouveaux ou existants, et liste les colonnes exclues de l’importation en raison de problèmes de type de données ou de vos choix.
4. Sélectionnez Créer la synchronisation. Vous pouvez aussi sélectionner Enregistrer comme brouillon à n’importe quelle étape pour terminer plus tard.

Gestion des modifications de schéma

Le mappeur visuel vérifie le schéma de votre table ou de votre vue à chaque exécution de synchronisation et réagit en fonction du type de modification :

Pour reprendre une synchronisation mise en pause après la suppression d’une colonne, sélectionnez Modifier la synchronisation et vérifiez vos mappages. La colonne supprimée est signalée et n’apparaît plus dans le mappeur. En enregistrant vos mappages, vous confirmez que la synchronisation doit se poursuivre sans cette colonne. Si les données ont été déplacées vers une autre colonne, vous pouvez également mapper la nouvelle colonne avant d’enregistrer.

Foire aux questions

Puis-je modifier mes mappages après la création d’une synchronisation ?

Oui. Modifiez la synchronisation et sélectionnez Afficher et modifier le mappage. Le schéma actuel de la table source se charge, avec les mappages que vous aviez définis lors de la création de la synchronisation. Vous pouvez ensuite modifier vos mappages à partir de là.

Puis-je transformer mes données dans le mappeur visuel ?

Non. Le mappeur visuel synchronise les valeurs des colonnes exactement telles qu’elles apparaissent dans votre source. Il ne prend pas en charge les transformations, la logique conditionnelle ni les jointures entre tables. Pour ces cas d’usage, utilisez plutôt l’option SQL à l’étape de définition des données afin de structurer vos données à l’aide d’une requête. Pour plus d’informations, consultez Ingestion de données cloud : éditeur SQL.

Mes synchronisations CDI existantes sont-elles modifiées ?

Non. Les synchronisations qui utilisent le format de table existant avec les colonnes EXTERNAL_ID, UPDATED_AT et payload continuent de fonctionner, et vous pouvez toujours en créer.

Quel est l’impact sur mon utilisation de Braze ?

Chaque colonne que vous importez et mappez est écrite sous forme de mise à jour de champ Braze, et la facturation des points de données fonctionne de la même manière que pour les autres synchronisations de données utilisateur CDI. Exclure les colonnes dont vous n’avez pas besoin permet de garder des synchronisations efficaces. Pour plus d’informations, consultez Bonnes pratiques d’ingestion de données cloud.