Connexion Microsoft Dynamics 365
Présentation overview
Microsoft Dynamics 365 est une plateforme d’applications métier cloud qui combine la planification des ressources de l’entreprise (ERP) et la gestion de la relation client (CRM), ainsi que des applications de productivité et des outils d’IA, afin d’offrir des opérations de bout en bout plus fluides et plus contrôlées, un meilleur potentiel de croissance et des coûts réduits.
Cette Adobe Experience Platform destination tire parti de Contact Entity Reference API, ce qui vous permet de mettre à jour les identités dans une audience en Dynamics 365.
Dynamics 365 utilise OAuth 2 avec l’octroi d’autorisation comme mécanisme d’authentification permettant de communiquer avec l’Contact Entity Reference API. Les instructions vous permettant de vous authentifier sur votre instance Dynamics 365 sont plus loin dans la section Authentifier à la destination.
Cas d’utilisation use-cases
En tant que professionnel du marketing, vous pouvez proposer des expériences personnalisées à vos utilisateurs en fonction des attributs de leurs profils Adobe Experience Platform. Vous pouvez créer des audiences à partir de vos données hors ligne et envoyer ces audiences à Dynamics 365 afin qu’elles s’affichent dans les flux des utilisateurs dès que les audiences et les profils sont mis à jour dans Adobe Experience Platform.
Conditions préalables prerequisites
Conditions préalables d’Experience Platform prerequisites-in-experience-platform
Avant d’activer des données vers la destination Dynamics 365, vous devez avoir un schéma, un jeu de données et des audiences créés dans Experience Platform.
Reportez-vous à la documentation de l’Adobe pour le groupe de champs de schéma Détails de l’appartenance à une audience si vous avez besoin de conseils sur les états d’audience.
Conditions préalables de Microsoft Dynamics 365 prerequisites-destination
Notez les conditions préalables suivantes dans Dynamics 365, afin d’exporter des données de Platform vers votre compte Dynamics 365 :
Vous devez avoir un compte Microsoft Dynamics 365. prerequisites-account
Accédez à la page Évaluation de Dynamics 365 pour vous enregistrer et créer un compte, le cas échéant.
Créer un champ dans Dynamics 365 prerequisites-custom-field
Créez le champ personnalisé de type Simple
avec le type de données de champ Single Line of Text
que l’Experience Platform utilisera pour mettre à jour l’état de l’audience dans Dynamics 365.
Reportez-vous à la documentation Dynamics 365 Créer ou modifier un champ (attribut) si vous avez besoin de conseils supplémentaires.
Notez le préfixe de personnalisation du champ personnalisé que vous créez dans Dynamics 365. Vous aurez besoin de ce préfixe lors de l’étape Remplir les détails de destination . Pour plus d’informations, consultez la section Créer et modifier des champs de la documentation Dynamics 365 .
Un exemple de configuration dans Dynamics 365 est illustré ci-dessous :
Enregistrez une application et un utilisateur de l’application dans Azure Active Directory. prerequisites-app-user
Pour permettre à Dynamics 365 d’accéder aux ressources, vous devez vous connecter avec votre Azure Account à Azure Active Directory et créer les éléments suivants :
- Une application Azure Active Directory
- Un principal de service
- Une clé secrète
Vous devrez également créer un utilisateur de l’application dans Azure Active Directory et l’associer à l’application nouvellement créée.
Collectez les informations d’identification de Dynamics 365. gather-credentials
Notez les éléments ci-dessous avant de vous authentifier à la destination CRM Dynamics 365 :
Client ID
ababbaba-abab-baba-acac-acacacacacac
Client Secret
abcde~abcdefghijklmnopqrstuvwxyz12345678
pour obtenir des conseils.Tenant ID
1234567-aaaa-12ab-ba21-1234567890
Region
Reportez-vous à la Dynamics 365 documentation pour obtenir des conseils.
org57771b33.
crm
.dynamics.comPar exemple : si votre société est configurée dans la région Amérique du Nord (NAM), votre URL sera
crm.dynamics.com
et vous devez sélectionner crm
. Si votre société est configurée dans la région Canada (CAN), votre URL sera crm3.dynamics.com
et vous devez sélectionner crm3
.Environment URL
org57771b33
.crm.dynamics.comMécanismes de sécurisation guardrails
La page Limites et allocations de requêtes détaille les limites d’API Dynamics 365 associées à votre licence Dynamics 365. Vous devez vous assurer que vos données et votre payload sont conformes à ces contraintes.
Identités prises en charge supported-identities
Dynamics 365 prend en charge la mise à jour des identités décrites dans le tableau ci-dessous. En savoir plus sur les identités.
contactid
Audiences prises en charge supported-audiences
Cette section décrit toutes les audiences que vous pouvez exporter vers cette destination.
Cette destination prend en charge l’activation de toutes les audiences générées par le Segmentation Service d’Experience Platform.
Type et fréquence d’exportation export-type-frequency
Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.
- Vous exportez tous les membres d’une audience, ainsi que les champs de schéma souhaités (par exemple : adresse email, numéro de téléphone, nom), en fonction de votre mappage de champs.
- Chaque état d’audience de Dynamics 365 est mis à jour avec l’état d’audience correspondant de Platform, en fonction de la valeur ID de mappage fournie à l’étape planification d’audience.
- Les destinations de diffusion en continu sont des connexions basées sur l’API « toujours actives ». Dès qu’un profil est mis à jour dans Experience Platform en fonction de l’évaluation des audiences, le connecteur envoie la mise à jour en aval vers la plateforme de destination. En savoir plus sur les destinations de diffusion en continu.
Se connecter à la destination connect
Pour vous connecter à cette destination, procédez comme décrit dans le tutoriel sur la configuration des destinations. Dans le workflow de configuration des destinations, renseignez les champs répertoriés dans les deux sections ci-dessous.
Dans Destinations > Catalogue, recherchez Dynamics 365. Vous pouvez également localiser cet élément dans la catégorie CRM.
S’authentifier auprès de la destination authenticate
Pour vous authentifier auprès de la destination, sélectionnez Se connecter à la destination.
Renseignez les champs obligatoires ci-dessous. Reportez-vous à la section Collecter des informations d’identification Dynamics 365 pour obtenir des conseils.
- Identifiant client : l’identifiant client Dynamics 365 pour votre application Azure Active Directory.
- Identifiant client : l’identifiant client Dynamics 365 pour votre application Azure Active Directory.
- Secret client : le secret client Dynamics 365 pour votre application Azure Active Directory.
- Région : votre région Dynamics 365. Par exemple : si votre société est configurée dans la région Amérique du Nord (NAM), votre URL sera
crm.dynamics.com
et vous devez sélectionnercrm
. Si votre société est configurée dans la région Canada (CAN), votre URL seracrm3.dynamics.com
et vous devez sélectionnercrm3
. - URL d’environnement : votre URL d’environnement Dynamics 365.
Si les détails fournis sont valides, l’interface utilisateur affiche un statut Connecté avec une coche verte. Vous pouvez ensuite passer à l’étape suivante.
Renseigner les détails de la destination destination-details
Pour configurer les détails de la destination, renseignez les champs obligatoires et facultatifs ci-dessous. Un astérisque situé en regard d’un champ de l’interface utilisateur indique que le champ est obligatoire.
- Nom : un nom par lequel vous reconnaîtrez cette destination à l’avenir.
- Description : une description qui vous aidera à identifier cette destination à l’avenir.
- Préfixe de personnalisation :
Customization prefix
du champ personnalisé que vous avez créé dans Dynamics 365. Pour plus d’informations, consultez la section Créer et modifier des champs de la documentation Dynamics 365 .
Activer les alertes enable-alerts
Vous pouvez activer les alertes pour recevoir des notifications sur le statut de votre flux de données vers votre destination. Sélectionnez une alerte dans la liste et abonnez-vous à des notifications concernant le statut de votre flux de données. Pour plus d’informations sur les alertes, consultez le guide sur l’abonnement aux alertes des destinations dans l’interface utilisateur.
Lorsque vous avez terminé de renseigner les détails sur votre connexion de destination, sélectionnez Suivant.
Activer des audiences vers cette destination activate
-
Pour activer les données, vous avez besoin des , Activer les destinations, et autorisations de contrôle d’accès. Lisez la présentation du contrôle d’accès ou contactez votre administrateur ou administratrice du produit pour obtenir les autorisations requises.
-
Pour exporter des identités, vous avez besoin de l'autorisation Afficher le graphique d'identités 🔗.
{width="100" modal="regular"}
Consultez la section Activer les profils et les audiences vers les destinations d’exportation d’audiences en flux continu pour obtenir des instructions sur l’activation des audiences vers cette destination.
Considérations sur le mappage et exemple mapping-considerations-example
Pour envoyer correctement vos données d’audience d’Adobe Experience Platform vers la destination Dynamics 365, vous devez passer par l’étape de mappage des champs. Le mappage consiste à créer un lien entre vos champs de schéma de modèle de données d’expérience (XDM) dans votre compte Platform et leurs équivalents issus de la destination cible. Pour mapper correctement vos champs XDM vers les champs de destination Dynamics 365, procédez comme suit :
-
Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Une nouvelle ligne de mappage s’affichera à l’écran.
-
Dans la fenêtre Sélectionner le champ source, choisissez la catégorie Sélectionner un espace de noms d’identité et sélectionnez
contactid
.
-
Dans la fenêtre Sélectionner le champ cible, sélectionnez le type de champ cible vers lequel vous souhaitez mapper votre champ source.
-
Sélectionner un espace de noms d’identité : sélectionnez cette option pour mapper votre champ source vers un espace de noms d’identité de la liste.
-
Ajoutez le mappage suivant entre votre schéma de profil XDM et votre instance Dynamics 365 :
table 0-row-3 1-row-3 Schéma de profil XDM Dynamics 365 Instance Obligatoire contactid
contactid
Oui -
Sélectionner des attributs personnalisés : sélectionnez cette option pour mapper votre champ source vers un attribut personnalisé que vous définissez dans le champ Nom de l’attribut. Pour une liste complète des attributs pris en charge, consultez la Dynamics 365 documentation.
note important IMPORTANT - Les noms des champs cibles doivent se trouver dans
lowercase
. - De plus, si vous disposez d’un champ source de date ou d’horodatage mappé à un champ cible Dynamics 365 date ou timestamp , assurez-vous que la valeur mappée n’est pas vide. Si la valeur du champ exporté est vide, un message d’erreur
Bad request reported while pushing events to the destination. Please contact the administrator and try again.
s’affiche et les données ne sont pas mises à jour. Il s’agit d’une limitation de Dynamics 365.
- Les noms des champs cibles doivent se trouver dans
-
Par exemple, en fonction des valeurs que vous souhaitez mettre à jour, ajoutez le mappage suivant entre votre schéma de profil XDM et votre instance Dynamics 365 :
table 0-row-2 1-row-2 2-row-2 3-row-2 Schéma de profil XDM Dynamics 365 Instance person.name.firstName
firstname
person.name.lastName
lastname
personalEmail.address
emailaddress1
-
Un exemple d’utilisation de ces mappages est illustré ci-dessous :
-
Planification de l’export d’audience et exemple schedule-audience-export-example
À l’étape Planification de l’export d’audience du workflow d’activation, vous devez mapper manuellement les audiences Platform à l’attribut de champ personnalisé dans Dynamics 365.
Pour ce faire, sélectionnez chaque audience, puis saisissez l’attribut de champ personnalisé correspondant à partir de Dynamics 365 dans le champ ID de mappage .
Voici un exemple :
Valider l’exportation des données exported-data
Pour vérifier que vous avez correctement configuré la destination, procédez comme suit :
-
Sélectionnez Destinations > Parcourir pour accéder à la liste des destinations.
-
Sélectionnez la destination et vérifiez que le statut est activé.
-
Passez à l’onglet Activation data, puis sélectionnez un nom d’audience.
-
Surveillez la synthèse de l’audience et assurez-vous que le nombre de profils correspond au nombre créé dans l’audience.
-
Connectez-vous au site web Dynamics 365, puis accédez à la page Customers > Contacts et vérifiez si les profils de l’audience ont été ajoutés. Vous pouvez constater que chaque état d’audience de Dynamics 365 a été mis à jour avec l’état d’audience correspondant de Platform, en fonction de la valeur ID de mappage fournie à l’étape planification d’audience.
Utilisation et gouvernance des données data-usage-governance
Lors de la gestion de vos données, toutes les destinations Adobe Experience Platform se conforment aux politiques d’utilisation des données. Pour obtenir des informations détaillées sur la manière dont Adobe Experience Platform applique la gouvernance des données, lisez la présentation de la gouvernance des données.
Erreurs et résolution des problèmes errors-and-troubleshooting
Erreurs inconnues rencontrées lors de la publication d’événements vers la destination unknown-errors
Lors de la vérification d’une exécution de flux de données, si vous obtenez le message d’erreur suivant : Bad request reported while pushing events to the destination. Please contact the administrator and try again.
Pour corriger cette erreur, vérifiez que l’ ID de mappage que vous avez fourni dans Dynamics 365 pour votre audience Platform est valide et existe dans Dynamics 365.
Ressources supplémentaires additional-resources
Retrouvez d’autres informations utiles de la documentation de Dynamics 365ci-dessous :
Journal des modifications
Cette section répertorie les nouvelles fonctionnalités et les mises à jour importantes de la documentation consacrée au connecteur de destination.
table 0-row-3 1-row-3 2-row-3 3-row-3 layout-auto | ||
---|---|---|
Mois de publication | Type de mise à jour | Description |
Octobre 2023 | Mise à jour de la documentation | Mise à jour des conseils pour indiquer que tous les noms d’attributs cible doivent être en minuscules, à l’étape Considérations sur le mappage et exemple . |
Août 2023 | Nouvelles fonctionnalités et mise à jour de la documentation | Ajout de la prise en charge de préfixes de champ personnalisés Dynamics 365 pour les champs personnalisés qui n’ont pas été créés dans la solution par défaut dans Dynamics 365. Un nouveau champ d’entrée, Préfixe de personnalisation, a été ajouté à l’étape Remplir les détails de destination. (PLATIR-31602). |
Nov 2022 | Version initiale | Version initiale de la destination et publication de la documentation. |