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, pour 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 depuis votre entrepôt de données sans écrire de SQL ni restructurer vos données. Au lieu de créer une table spécifique à Braze avec les colonnes EXTERNAL_ID, UPDATED_AT et payload, vous mappez les colonnes de votre table existante aux champs Braze directement 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 Intégrations d’entrepôt de données.
• 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 dans votre table contenant un identifiant utilisateur pris en charge, ainsi qu’une colonne avec 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 ne sont pas conservés.

Créer 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 votre 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 liste 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 que les deux ne sont pas terminés :

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

Pour chaque colonne restante, vous pouvez :

• Conserver le mappage par défaut. Chaque colonne est mappée à un champ Braze du 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. Effectuez une recherche dans le menu déroulant 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 le menu déroulant du champ de destination pour mapper une colonne à un nouvel attribut personnalisé.
• Exclure la colonne. Décochez la case Importer pour ne pas inclure une colonne dans la synchronisation.

Conseil

Avant de créer un nouvel attribut, recherchez un attribut existant dans le menu déroulant de destination. Par exemple, si votre table contient une colonne fav_color mais 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é de votre colonne affichent un avertissement Incompatibilité de type. Vous pouvez quand 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 effectuer une vérification en lecture seule sur votre table ou vue. L’aperçu affiche les 10 premières lignes avec vos 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’erreurs de synchronisation. Vous pouvez également activer les alertes Erreurs de ligne (envoyées lorsqu’un pourcentage de lignes ne parvient pas à se mettre à jour) et les notifications de Synchronisation réussie.
2. À l’étape Planification, activez Synchronisation récurrente pour exécuter la synchronisation selon un calendrier, ou laissez l’option désactivée pour une synchronisation ponctuelle.
3. Vérifiez l’étape Résumé. Elle liste votre configuration, les attributs nouveaux par rapport aux existants, ainsi que les colonnes exclues de l’importation en raison de problèmes de type de données ou de vos sélections.
4. Sélectionnez Créer la synchronisation. Vous pouvez également sélectionner Enregistrer comme brouillon à n’importe quelle étape pour terminer ultérieurement.

Gestion des modifications de schéma

Le mappeur visuel vérifie le schéma de votre table ou 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 Edit sync et vérifiez vos mappages. La colonne supprimée est signalée et n’apparaît plus dans le mappeur. Enregistrer vos mappages confirme que la synchronisation doit continuer sans cette colonne. Vous pouvez également, si les données ont été déplacées vers une autre colonne, mapper la nouvelle colonne avant d’enregistrer.

Questions fréquentes

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 vos mappages précédents enregistrés lors de la création de la synchronisation. Vous pouvez 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 l’option SQL à l’étape de définition des données afin de façonner vos données avec une requête. Pour plus d’informations, consultez Cloud Data Ingestion : éditeur SQL.

Mes synchronisations CDI existantes sont-elles modifiées ?

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

Comment mon utilisation de Braze est-elle affectée ?

Chaque colonne que vous importez et mappez est écrite en tant que mise à jour de champ Braze, et la facturation des points de donnée 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 vos synchronisations efficaces. Pour plus d’informations, consultez Bonnes pratiques pour Cloud Data Ingestion.