DocumentationExperience PlatformGuide des destinations

Connexion Microsoft Dynamics 365

Last update: Fri Apr 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :
  • Destinations

Créé pour :

  • Administration
  • Utilisateur ou utilisatrice

Présentation

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 exploite le Contact Entity Reference API , ce qui vous permet de mettre à jour les identités d’une audience dans 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

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, pour les afficher dans les flux des utilisateurs dès que les audiences et les profils sont mis à jour dans Adobe Experience Platform.

Conditions préalables

Conditions préalables d’Experience Platform

Avant d’activer des données dans la destination Dynamics 365, vous devez avoir créé un schéma, un jeu de données et des audiences dans Experience Platform.

Reportez-vous à la documentation d’Adobe pour le groupe de champs de schéma Détails sur l’appartenance à une audience si vous avez besoin de conseils sur les statuts de l’audience.

Conditions préalables de Microsoft Dynamics 365

Notez les conditions préalables suivantes dans Dynamics 365, afin d’exporter des données d’Experience Platform vers votre compte Dynamics 365 :

Vous devez avoir un compte Microsoft Dynamics 365.

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

Créez le champ personnalisé de type Simple avec le type de données de champ comme Single Line of Text qu’Experience Platform utilisera pour mettre à jour le statut 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 Renseigner les détails de la destination. Reportez-vous à la section Créer et modifier des champs de la documentation Dynamics 365 pour plus d’informations.
Capture d’écran de l’interface utilisateur Dynamics 365 présentant le préfixe de personnalisation.

Un exemple de configuration dans Dynamics 365 est illustré ci-dessous :
Copie d’écran de l’interface utilisateur Dynamics 365 présentant les champs personnalisés.

Enregistrez une application et un utilisateur de l’application dans Azure Active Directory.

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.

Notez les éléments ci-dessous avant de vous authentifier à la destination CRM Dynamics 365 :

Informations d’identification
Description
Exemple
Client ID
L’identifiant client Dynamics 365 pour votre application Azure Active Directory. Reportez-vous à la documentation de Dynamics 365pour obtenir des conseils.
ababbaba-abab-baba-acac-acacacacacac
Client Secret
Le Secret client Dynamics 365 pour votre application Azure Active Directory. Vous utiliseriez l’option #2 dans la documentation de Dynamics 365.
abcde~abcdefghijklmnopqrstuvwxyz12345678 pour obtenir des conseils.
Tenant ID
L’identifiant client Dynamics 365 pour votre application Azure Active Directory. Reportez-vous à la documentation de Dynamics 365pour obtenir des conseils.
1234567-aaaa-12ab-ba21-1234567890
Region
Région Microsoft associée à l’URL de l’environnement.
Reportez-vous à la Dynamics 365 documentation pour obtenir des conseils.
Si votre domaine est comme ci-dessous, vous devez fournir la valeur mise en surbrillance pour le champ CRM dans le sélecteur de liste déroulante lors de l’authentification auprès de la destination.
org57771b33.crm.dynamics.com
À titre d’exemple : si votre société est approvisionnée dans la région Amérique du Nord (NAM), votre URL est crm.dynamics.com et vous devez sélectionner crm. Si votre entreprise est approvisionnée dans la région du Canada (CAN), votre URL sera crm3.dynamics.com et vous devrez sélectionner crm3.
Environment URL
Reportez-vous à la documentation de Dynamics 365pour obtenir des conseils.
Si votre domaine Dynamics 365 est comme ci-dessous, vous avez besoin de la valeur mise en surbrillance.
org57771b33.crm.dynamics.com

Mécanismes de sécurisation

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

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.

Identité cible
Exemple
Description
Considérations
contactid
7eb682f1-ca75-e511-80d4-00155d2a68d1
Identifiant unique d’un contact.
Obligatoire. Reportez-vous à la documentation de Dynamics 365pour plus d’informations.

Audiences prises en charge

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

Reportez-vous au tableau ci-dessous pour plus d’informations sur le type et la fréquence d’exportation des destinations.

Élément
Type
Notes
Type d’exportation
Basé sur les profils
  • Vous exportez tous les membres d’une audience, ainsi que les champs de schéma souhaités (par exemple : adresse e-mail, numéro de téléphone, nom), en fonction de votre mappage de champs.
  • Chaque statut d’audience dans Dynamics 365 est mis à jour avec le statut d’audience correspondant d’Experience Platform, en fonction de la valeur Identifiant de mappage fournie lors de l’étape planification de l’audience.
Fréquence des exportations
Diffusion en continu
  • 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

IMPORTANT
Pour vous connecter à la destination, vous avez besoin des autorisations de contrôle d’accès Afficher les destinations et Gérer les destinations 🔗. Lisez la présentation du contrôle d’accès ou contactez votre administrateur de produit pour obtenir les autorisations requises.

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

Pour vous authentifier auprès de la destination, sélectionnez Se connecter à la destination.
Capture d’écran de l’interface utilisateur d’Experience Platform montrant comment s’authentifier.

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.
  • Region : Votre Région Dynamics 365. À titre d’exemple : si votre société est approvisionnée dans la région Amérique du Nord (NAM), votre URL est crm.dynamics.com et vous devez sélectionner crm. Si votre entreprise est approvisionnée dans la région du Canada (CAN), votre URL sera crm3.dynamics.com et vous devrez sélectionner crm3.
  • 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

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.
Capture d’écran de l’interface utilisateur d’Experience Platform affichant les détails de la destination.

  • 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. Reportez-vous à la section Créer et modifier des champs de la documentation Dynamics 365 pour plus d’informations.

Activer les alertes

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

IMPORTANT

  • Pour activer les données, vous avez besoin des autorisations de contrôle d’accès Afficher les destinations, Activer les destinations, Afficher les profils et Afficher les segments 🔗. 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 devez disposer de l’autorisation de contrôle d’accès Afficher le graphique d’identités 🔗.

    Sélectionnez l’espace de noms d’identité en surbrillance dans le workflow pour activer les audiences vers les destinations.

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

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 Experience 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 :

  1. Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Une nouvelle ligne de mappage s’affichera à l’écran.
    Exemple de capture d’écran de l’interface utilisateur d’Experience Platform pour Ajouter un nouveau mappage.

  2. 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.
    Exemple de capture d’écran de l’interface utilisateur d’Experience Platform pour le mappage Source.

  3. 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.

      Capture d’écran de l’interface utilisateur d’Experience Platform montrant le mapping de ciblage pour contactid.

    • Ajoutez le mappage suivant entre votre schéma de profil XDM et votre instance Dynamics 365 :

      Schéma de profil XDM
      Instance Dynamics 365
      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.

      Capture d’écran de l’interface utilisateur d’Experience Platform montrant le mapping de ciblage pour l’e-mail.

      IMPORTANT
      • Les noms des champs cibles doivent être en lowercase.
      • En outre, si vous disposez d’un champ source de date ou d’horodatage mappé à un champ cible Dynamics 365 date ou horodatage, 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.

    • 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 :

      Schéma de profil XDM
      Instance Dynamics 365
      person.name.firstName
      firstname
      person.name.lastName
      lastname
      personalEmail.address
      emailaddress1

    • Un exemple d’utilisation de ces mappages est illustré ci-dessous :

    Exemple de capture d’écran de l’interface utilisateur d’Experience Platform montrant les mappings de ciblage.

Planifier l’exportation de l’audience et exemple

À l’étape ​ Planifier l’exportation d’audience ​ du workflow d’activation, vous devez mapper manuellement les audiences Experience 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 Identifiant de mappage.

IMPORTANT
La valeur utilisée pour l’ID de mappage doit correspondre exactement au nom de l’attribut de champ personnalisé créé dans Dynamics 365. Voir Dynamics 365 documentation si vous avez besoin de conseils pour trouver vos attributs de champ personnalisés.

Un exemple est illustré ci-dessous :
Exemple de capture d’écran de l’interface utilisateur d’Experience Platform montrant la planification de l’exportation de l’audience.

Valider l’exportation des données

Pour vérifier que vous avez correctement configuré la destination, procédez comme suit :

  1. Sélectionnez Destinations > Parcourir pour accéder à la liste des destinations.
    Capture d’écran de l’interface utilisateur d’Experience Platform montrant la navigation des destinations.

  2. Sélectionnez la destination et vérifiez que le statut est activé.
    Capture d’écran de l’interface utilisateur d’Experience Platform montrant l’exécution du flux de données des destinations.

  3. Passez à l’onglet Activation data , puis sélectionnez un nom d’audience.
    Exemple de capture d’écran de l’interface utilisateur d’Experience Platform montrant les données d’activation des destinations.

  4. Surveillez le résumé de l’audience et assurez-vous que le nombre de profils correspond au nombre créé dans l’audience.
    Exemple de capture d’écran de l’interface utilisateur d’Experience Platform montrant l’audience.

  5. 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. Comme vous pouvez le constater, chaque statut d’audience dans Dynamics 365 a été mis à jour avec le statut d’audience correspondant d’Experience Platform, en fonction de la valeur Identifiant de mappage fournie lors de l’étape planification de l’audience.
    Capture d’écran de l’interface utilisateur Dynamics 365 montrant la page Contacts avec les statuts d’audience mis à jour.

Utilisation et gouvernance des données

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

Erreurs inconnues rencontrées lors de la publication d’événements vers la destination

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.

Capture d’écran de l’interface utilisateur d’Experience Platform montrant une erreur de requête incorrecte.

Pour corriger cette erreur, vérifiez que l’identifiant de mappage que vous avez fourni en Dynamics 365 pour votre audience Experience Platform est valide et existe dans Dynamics 365.

Ressources supplémentaires

Retrouvez d’autres informations utiles de la documentation de Dynamics 365ci-dessous :

  • Méthode IOrganizationService.Update(Entity)
  • Mettre à jour et supprimer des lignes de table à l’aide de l’API Web

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.

Afficher le journal des modifications
Mois de publication
Type de mise à jour
Description
Octobre 2023
Mise à jour de la documentation
Les conseils mis à jour pour indiquer tous les noms d’attributs cibles doivent être en minuscules, dans l’étape Considérations relatives au 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 Renseigner les détails de la destination. (PLATIR-31602).
Novembre 2022
Version initiale
Publication de la destination initiale et de la documentation.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6