Connexion Microsoft Dynamics 365

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 destination Adobe Experience Platform utilise Contact Entity Reference API, ce qui vous permet de mettre à jour les identités d’un segment 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 segments à partir de vos données hors ligne et envoyer ces segments vers Dynamics 365, pour les afficher dans les flux des utilisateurs dès que les segments 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 un schéma, un jeu de données, ainsi que des segments créés dans Experience Platform.

Si vous avez besoin de conseils pour les statuts de segment, reportez-vous à la documentation d’Adobe pour le groupe de champs de schéma Détails de l’appartenance à un segment.

Conditions préalables de Microsoft Dynamics 365

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.

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 un 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 du segment dans Dynamics 365.
Reportez-vous à la documentation Dynamics 365 pour créer un champ (attribut) si vous avez besoin de conseils supplémentaires.

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 365 pour 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 365 pour obtenir des conseils. 1234567-aaaa-12ab-ba21-1234567890
Environment URL Reportez-vous à la documentation de Dynamics 365 pour 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 365 pour plus d’informations.

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’un segment, 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 du segment dans Dynamics 365 est mis à jour avec le statut du segment correspondant de Platform, en fonction de la valeur de l’identifiant de mappage fournie pendant l’étape de planification des segments.
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 segments, 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 devez disposer de l’autorisation de contrôle d’accès 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 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.
  • 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 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.

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 segments vers cette destination

IMPORTANT

Pour activer les données, vous avez besoin des autorisations de contrôle d’accès pour les fonctions Gérer 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 de produit pour obtenir les autorisations requises.

Consultez Activer les profils et les segments vers les destinations d’exportation de segments de diffusion en continu pour obtenir des instructions sur l’activation des segments d’audience 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 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.
      Capture 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.
      Capture d’écran de l’interface utilisateur de Platform montrant le mapping de ciblage pour le nom de famille.

      IMPORTANT

      Si vous disposez d’un champ source de date ou d’horodatage mappé vers un champ cible Dynamics 365 date ou horodatage, assurez-vous que la valeur mappée n’est pas vide. Si la valeur passée est vide, un message d’erreur Bad request reported while pushing events to the destination. Please contact the administrator and try again. apparaîtra et 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|Email|

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

Planifier l’exportation de segments et exemple

Dans l’étape Planier l’exportation de segments du workflow d’activation, vous devez mapper manuellement les segments Platform vers l’attribut de champ personnalisé dans Dynamics 365.

Pour ce faire, sélectionnez chaque segment, puis saisissez l’attribut de champ personnalisé correspondant à partir de Dynamics 365 dans le champ ID 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.

Voici un exemple :
Capture d’écran de l’interface utilisateur de Platform montrant la planification de l’exportation de segments.

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 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 l’onglet Activation data, puis sélectionnez un nom de segment.
    Exemple de capture d’écran de l’interface utilisateur de Platform montrant les données d’activation des destinations.

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

  5. Connectez-vous au site web de Dynamics 365, puis accédez à Customers > Contacts et vérifiez si les profils du segment ont été ajoutés. Comme vous pouvez le constater, chaque statut de segment dans Dynamics 365 a été mis à jour avec le statut du segment correspondant de Platform, en fonction de la valeur de l’identifiant de mappage fournie lors de la planification des segments.
    Capture d’écran de l’interface utilisateur Dynamics 365 montrant la page Contacts avec les statuts de segments 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.

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

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

Ressources supplémentaires

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

Sur cette page