Connexion d’Demandbase à Experience Platform à l’aide de l’interface utilisateur

Lisez ce guide pour savoir comment connecter votre compte Demandbase à Adobe Experience Platform à l’aide de l’espace de travail Sources dans l’interface utilisateur d’Experience Platform.

Commencer get-started

Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :

Collecter les informations d’identification requises gather-credentials

Avant de commencer, demandez à votre administrateur Demandbase ce qui suit :

  • Identifiant du client
  • Secret client

Ces informations d’identification sont utilisées sous Authentification du compte lors de la création d’une connexion source.

Parcourir le catalogue des sources navigate

Dans l’interface utilisateur d’Experience Platform, sélectionnez Sources dans le volet de navigation de gauche pour accéder à l’espace de travail Sources, puis sélectionnez l’onglet Catalogue. Utilisez la barre de recherche pour rechercher des Demandbase.

Sélectionnez Configurer sur la carte source Demandbase.

NOTE
Si vous disposez déjà d’un compte authentifié, sélectionnez Ajouter des données à la place.

Le catalogue des sources avec la carte Demandbase et son option de configuration mise en surbrillance sous la catégorie DB1Platform.

Authentification de votre compte authentication

Utiliser un compte existant existing

Pour réutiliser une connexion déjà authentifiée, sélectionnez Compte existant. Un tableau des comptes Demandbase créés précédemment s’affiche, affichant le compte Nom, Source, Nom d’utilisateur, les Flux de données associés, la date de Création et son Statut du compte.

Cochez la case en regard du compte à réutiliser et sélectionnez Suivant.

Interface de compte existante du workflow des sources.

Créer un nouveau compte create

Pour créer une connexion, sélectionnez Nouveau compte et fournissez les informations suivantes sous Détails de connexion Source :

  • Nom du compte
  • Description

Ensuite, sous Authentification du compte, fournissez vos Identifiant client et Secret client. Lorsque vous avez terminé, sélectionnez Se connecter à la source et patientez quelques secondes le temps que la connexion s’établisse.

Nouvelle interface de compte du workflow des sources.

Sélectionner vos données select-data

Utilisez l’interface Sélectionner les données pour choisir l’entité Demandbase à ingérer dans Experience Platform. Sélectionnez Comptes dans la liste de gauche pour prévisualiser un exemple de données source dans la partie droite avant de continuer.

Interface de sélection des données du workflow des sources.

Fournir des détails sur le flux de données provide-dataflow-details

Fournissez ensuite des informations sur votre jeu de données et votre flux de données cibles.

Sous Jeu de données cible, choisissez Jeu de données existant ou Nouveau jeu de données. Si vous créez un jeu de données, indiquez un nom du jeu de données de sortie (par exemple, Demandbase account dataset) et sélectionnez un schéma. Par Demandbase, utilisez le schéma Compte B2B .

Vous pouvez éventuellement activer le jeu de données pour l’ingestion du jeu de données de profil afin que les données soient disponibles dans Real-Time Customer Profile. Laissez le diagnostics d’erreur activé et configurez ingestion partielle si vous souhaitez que le flux de données se poursuive même lorsque certains enregistrements échouent.

Sous Détails du flux de données, fournissez un Nom du flux de données (par exemple, Dataflow - accounts) et une description facultative.

Étape des détails du flux de données du workflow des sources.

Champs de mappage mapping

Utilisez l’étape Mappage pour mapper les champs sources Demandbase aux champs de schéma Compte B2B cibles. Le résumé du mappage en haut de la page suit votre progression dans les champs mappés, champs obligatoires et champs d’identité, ainsi que les erreurs de validation.

Demandbase données de compte sont généralement mappées à des champs tels que les suivants :

  • accountKey.sourceKey, accountKey.sourceType, accountKey.sourceInstanceID, accountKey.sourceID
  • accountName
  • accountOrganization.website, accountOrganization.industry
  • accountPhysicalAddress.city, accountPhysicalAddress.country, accountPhysicalAddress.stateProvince, accountPhysicalAddress.postalCode

Interface de mappage affichant les champs sources Demandbase mappés aux champs cibles du compte B2B.

Création d’une clé d’identité composite composite-key

Le champ Identité accountKey.sourceKey doit représenter de manière unique chaque compte Demandbase. Au lieu de la mapper à un champ brut unique, utilisez l’éditeur de champs calculés de la préparation des données pour créer une clé composite qui concatène l’identifiant du compte source, le type de source et l’identifiant de votre instance Demandbase.

Sélectionnez le champ source en regard de accountKey.sourceKey pour ouvrir l’éditeur de champs calculés, puis utilisez la fonction concat pour combiner les valeurs :

concat("{SourceAccount}.sourceId", "-", "{SourceAccount}.sourceType", "@13723.Demandbase")
IMPORTANT
Remplacez 13723 dans l’expression par votre propre ID d’instance Demandbase. Mappez le même ID d’instance à accountKey.sourceInstanceID afin que les champs d’identité restent cohérents.

Pour prévisualiser le résultat, sélectionnez Aperçu, puis sélectionnez Enregistrer.

Éditeur de champ calculé pour le champ d’identité accountKey.sourceKey.

Une fois vos champs calculés et les mappages restants terminés, sélectionnez Suivant pour continuer.

Planifier votre flux de données schedule-dataflow

Une fois le mappage terminé, configurez un planning d’ingestion pour votre flux de données :

  • Fréquence : défini sur Heure pour l’ingestion incrémentielle. Une fréquence par minute n’est pas disponible pour les Demandbase.
  • Intervalle : définit le nombre d’heures qui s’écoulent entre les exécutions d’ingestion. Par exemple, une fréquence de Heure et un intervalle de 24 signifient que le flux de données ingère des données une fois toutes les 24 heures.
  • Heure de début : date et heure auxquelles la planification doit commencer.
NOTE
Toutes les dates et heures correspondent au fuseau horaire UTC.

Sélectionnez une planification qui correspond à vos besoins en matière de fraîcheur des données. Gardez à l’esprit qu’une planification plus fréquente augmente les coûts de calcul.

Interface de planification du workflow des sources.

Vérifier le flux de données review-dataflow

Une fois le planning d’ingestion configuré, utilisez la page Réviser pour confirmer les détails de votre flux de données sur trois cartes de résumé :

  • Connexion : affiche le nom du compte, la plateforme source, le chemin d’accès et le nombre de colonnes.
  • Attribuer des champs de jeu de données et de mappage : affiche le jeu de données cible et le mappage de schéma utilisés.
  • Planification : affiche l’heure de début, la fréquence et l’intervalle.

Sélectionnez Terminer pour terminer la configuration et patienter quelques instants le temps que votre flux de données se lance.

Interface de révision du workflow des sources.

Étapes suivantes next-steps

Une fois le flux de données créé, il exécute un renvoi unique de données suivi de synchronisations incrémentielles selon le planning que vous avez spécifié. Vous pouvez surveiller le statut de synchronisation en accédant au flux de données. Pour plus d’informations, consultez le guide sur la surveillance des flux de données des sources dans l’interface utilisateur.

En suivant ce tutoriel, vous avez terminé l’installation et la configuration de votre source de Demandbase dans Experience Platform. Les données de votre compte Demandbase sont ingérées selon le planning choisi et mappées au schéma XDM Compte B2B standard.

Pour plus d’informations, consultez la documentation suivante :

recommendation-more-help
experience-platform-help-sources