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.

Ceci Adobe Experience Platform destination tire parti de la fonction Contact Entity Reference API, 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 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, 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 prerequisites

Conditions préalables d’Experience Platform prerequisites-in-experience-platform

Avant d’activer des données dans Dynamics 365 destination, vous devez avoir une schema, un dataset, et audiences créé dans Experience Platform.

Reportez-vous à la documentation d’Adobe pour Groupe de champs 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éer un champ personnalisé de type Simple avec le type de données de champ comme Single Line of Text quel Experience Platform utilisera pour mettre à jour l’état de l’audience dans Dynamics 365.

Voir Dynamics 365 Création ou modification d’un champ (attribut) si vous avez besoin de conseils supplémentaires.

Notez les Préfixe de personnalisation du champ personnalisé que vous créez dans Dynamics 365. Vous aurez besoin de ce préfixe lors de la Renseignement des détails de destination étape . Voir Créer et modifier des champs de la Dynamics 365 pour plus d’informations.
Copie 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. 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 :

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.
Voir Dynamics 365 documentation pour obtenir des conseils.
Si votre domaine est tel que 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 au destination.
org57771b33.crm.dynamics.com
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é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
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 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.

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

É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 électronique, numéro de téléphone, nom), en fonction de votre mappage de champs.
  • Chaque état d’audience dans Dynamics 365 est mis à jour avec l’état d’audience correspondant de Platform, en fonction de la variable ID de mappage valeur fournie pendant la planification des audiences étape .
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 connect

IMPORTANT
Pour vous connecter à la destination, vous avez besoin de l’événement Affichage des destinations et Gestion des destinations autorisations de contrôle d’accès. 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 authenticate

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

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 Dynamics 365 Région. 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é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.
  • 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.
Capture d’écran de l’interface utilisateur de Platform montrant les détails de 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: la variable Customization prefix du champ personnalisé que vous avez créé dans Dynamics 365. Voir Créer et modifier des champs de la Dynamics 365 pour plus d’informations.

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

IMPORTANT

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 :

  1. Dans l’étape Mappage, sélectionnez Ajouter un nouveau mappage. Une nouvelle ligne de mappage s’affichera à l’écran.
    Capture d’écran de l’interface utilisateur de Platform montrant l’ajout d’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.
    Capture d’écran de l’interface utilisateur de Platform montrant 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.

      Copie d’écran de l’interface utilisateur de 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|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.

      Copie d’écran de l’interface utilisateur de Platform montrant le mappage de Target pour le courrier électronique.

      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 Dynamics 365 date ou horodatage champ cible , assurez-vous que la valeur mappée n’est pas vide. Si la valeur du champ exporté est vide, un événement Bad request reported while pushing events to the destination. Please contact the administrator and try again. et que les données ne seront 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|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 :

      Capture d’écran de l’interface utilisateur de Platform montrant les mappings de ciblage.

Planification de l’export d’audience et exemple schedule-audience-export-example

Dans le Planification de l’exportation des audiences à l’étape 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 ID de mappage champ .

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.

Voici un exemple :
Exemple de capture d’écran de l’interface utilisateur de Platform montrant Planification de l’exportation d’audience.

Valider l’exportation des données exported-data

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 de 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 de Platform montrant l’exécution du flux de données des destinations.

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

  4. Surveillez la synthèse 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 de Platform montrant l’audience.

  5. Connectez-vous au Dynamics 365 , puis accédez à la Customers > Contacts et vérifiez si les profils de l’audience ont été ajoutés. Vous pouvez voir que chaque état d’audience dans Dynamics 365 a été mis à jour avec l’état d’audience correspondant de Platform, en fonction de la variable ID de mappage valeur fournie pendant la planification des audiences étape .
    Copie d’écran de l’interface utilisateur Dynamics 365 présentant la page Contacts avec les statuts d’audience mis à jour.

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.

Copie d’écran de l’interface utilisateur de Platform affichant une erreur de requête incorrecte.

Pour corriger cette erreur, vérifiez que la variable ID de mappage vous avez fourni dans Dynamics 365 pour votre audience Platform 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.

Afficher le journal des modifications
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 de la cible doivent être en minuscules, dans la variable Considérations sur le mappage et exemple étape .
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 de saisie, Préfixe de personnalisation, a été ajouté dans la variable Renseignement des détails de destination étape . (PLATIR-31602).
Nov 2022 Version initiale Version initiale de la destination et publication de la documentation.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6