Utilisation de Campaign et Microsoft Dynamics 365

Dernière mise à jour : 2024-02-14
  • Créé pour :
  • Beginner
    Intermediate
    Admin
    User

Activez vos données CRM lors d’une communication cross-canal : découvrez comment transférer des contacts de Microsoft Dynamics 365 vers Adobe Campaign et partager les données de performances de la campagne (envois, ouvertures, clics et rebonds) d’Adobe Campaign vers Microsoft Dynamics 365.

Une fois le paramétrage effectué, la synchronisation des données entre les systèmes s'effectue via une activité de workflow dédiée. En savoir plus.

REMARQUE

Les versions de Microsoft Dynamics prises en charge sont présentées dans la matrice de compatibilité de Campaign.

Suivez les étapes ci-dessous pour configurer un compte externe dédié afin d’importer et d’exporter des données Microsoft Dynamics 365 vers Adobe Campaign.

Pour chaque système, ces étapes doivent être exécutées par un administrateur.

ATTENTION

Les étapes de cette documentation vous guideront tout au long de la création des intégrations/inscriptions impliquant l'attribution d'autorisations et/ou d'accès administrateur. Vous êtes tenu de vous assurer que ces étapes sont conformes aux politiques de votre entreprise avant de les exécuter, et de les exécuter avec précaution.

Configuration de Microsoft Dynamics 365

Pour connecter Microsoft Dynamics 365 à Adobe Campaign via l’API Web, connectez-vous à Microsoft Azure Directory à l’aide d’informations d’identification d’Administrateur global, puis procédez comme suit :

  1. Obtenez votre identifiant d’application Dynamics 365 (client). En savoir plus
  2. Génération de l’identifiant de clé de certificat Microsoft Dynamics et de l’ID de clé. En savoir plus
  3. Configuration des autorisations. En savoir plus
  4. Création d'un utilisateur d'application. En savoir plus
  5. Codage de la clé privée. En savoir plus

Obtention de l'identifiant client Dynamics 365

Pour obtenir l'identifiant (client) d’application, vous devez enregistrer une application dans Azure Active Directory.

  1. Parcourez Azure Active Directory > Enregistrements des applications, puis sélectionnez Nouvel enregistrement.
  2. Saisissez un nom unique qui peut aider à identifier une instance, par exemple adobecampaign<instance identifier>.

Une fois que vous procédez à l’enregistrement, Microsoft Azure Directory affecte un identifiant (client) d’application unique à votre application. Vous aurez besoin de cet identifiant ultérieurement lors de la configuration de Dynamics 365 dans Adobe Campaign.

En savoir plus dans la documentation de Microsoft Dynamics 365.

Génération de l’identifiant de clé de certificat Microsoft Dynamics et de l’ID de clé

Pour obtenir l’Identifiant de la clé de certificat (customKeyIdentifier) et l’identifiant de la clé (keyId), vous devez télécharger un certificat. Les certificats peuvent être utilisés comme secrets pour prouver l’identité de l’application lors de la demande d’un jeton. On peut également parler de clés publiques.

Procédez comme suit :

  1. Parcourez Azure Active Directory > Enregistrements des applications et sélectionnez l'application qui a été créée précédemment.
  2. Sélectionnez Certificats et secret.
  3. Dans l’onglet Certificats, cliquez sur Téléchargement du certificat.
  4. Téléchargez votre certificat public.
  5. Accédez au lien Manifeste pour obtenir l'identifiant de clé de certificat (customKeyIdentifier) et l'identifiant de clé (keyId).

L’identifiant de clé de certificat (customKeyIdentifier) et l’identifiant de clé (keyId) sont nécessaires ultérieurement pour configurer votre compte externe CRM Microsoft Dynamics 365 à l’aide du certificat Type O-Auth de CRM.

 Génération du certificat public

Pour générer le certificat, vous pouvez utiliser openssl.

Par exemple :

- openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout '<'private key name'>' -out '<'public certificate name'>
REMARQUE

Vous pouvez modifier le nombre de jours, ici -days 365, dans l’exemple de code pour une période de validité du certificat plus longue.

Vous devez ensuite encoder le certificat en base64. Pour cela, vous pouvez utiliser l'aide d'un encodeur Base64 ou vous servir de la ligne de commande base64 -w0 private.key sous Linux.

Configuration des autorisations

Étape 1 : configurez les autorisations obligatoires pour l'application qui a été créée.

  1. Accédez à Azure Active Directory > Enregistrements des applications et sélectionnez l'application qui a été créée précédemment.
  2. Cliquez sur Paramètres en haut à gauche.
  3. Sur Autorisations obligatoires, cliquez sur Ajouter et Sélectionner une API > Dynamics CRM Online.
  4. Cliquez sur Sélectionner, activez la case Accéder à Dynamics 365 en tant qu’utilisateurs de l’organisation et cliquez sur Sélectionner.
  5. Ensuite, dans l’application, sélectionnez le Manifest sous le menu Gérer.
  6. Dans l’éditeur Manifest, définissez la propriété allowPublicClient de null sur true et cliquez sur Enregistrer.

Étape 2 : autorisez le consentement administrateur

  1. Accédez à Répertoire actif Azure > Applications d’entreprise.
  2. Sélectionnez l’application à laquelle vous souhaitez accorder le consentement administrateur à l’échelle du client.
  3. Dans le menu du volet de gauche, sélectionnez Autorisations sous Sécurité.
  4. Cliquez sur Accorder le consentement administrateur.

Pour plus d'informations à ce propos, consultez la documentation Azure.

Création d'un utilisateur d'application

REMARQUE

Cette étape est facultative avec l’authentification Mots de passe.

L'utilisateur de l'application est l'utilisateur que l'application enregistrée ci-dessus utilisera. Toute modification apportée à Microsoft Dynamics à l'aide de l'application enregistrée ci-dessus sera effectuée via cet utilisateur.

Étape 1 : Création d'un utilisateur non interactif sur Azure Active Directory

  1. Cliquez sur Azure Active Directory > Utilisateurs et sur Nouvel utilisateur.
  2. Donnez un nom adapté que vous souhaitez utiliser et le nom d'utilisateur doit être au format d'un email.
  3. Sélectionnez Administrateur Dynamics 365 dans le Rôle de répertoire.

Étape 2 : Attribuer une licence appropriée à l'utilisateur créé

  1. Dans Microsoft Azure, cliquez sur Application d'administration.
  2. Accédez à Utilisateurs > Utilisateurs actifs et cliquez sur l'utilisateur qui vient d'être créé.
  3. Cliquez sur Modifier les licences de produit et sélectionnez Dynamics 365 Customer Engagement Plan.
  4. Cliquez sur Fermer.

Étape 3 : Création d'un utilisateur d'application sur Dynamics CRM

  1. Depuis Microsoft Azure, accédez à Paramètres > Sécurité > Utilisateurs.
  2. Cliquez dans la liste déroulante, sélectionnez Utilisateurs de l'application, puis cliquez sur Nouveau.
  3. Utilisez le même nom d'utilisateur que celui créé dans Active Directory ci-dessus.
  4. Affectez l'ID de l'application à l'application que vous avez créée précédemment.
  5. Cliquez sur Gérer les rôles et sélectionnez le rôle Administrateur système pour l'utilisateur.

Configuration de Campaign

Création de la connexion

Tout d’abord, vous devez créer le compte externe Microsoft Dynamics 365.

  1. Parcourez le nœud Administration > Plateforme > Comptes externes de l'explorateur Campaign et créez un compte externe.

  2. Sélectionnez le compte externe Microsoft Dynamics CRM dans la section Type.

  3. Sélectionnez la méthode d’authentification dans la liste déroulante Type O-Auth de CRM.

    1. Pour configurer le compte externe Microsoft Dynamics CRM afin de vous connecter à Adobe Campaign avec des mots de passe, fournissez les détails suivants :

      • Serveur : URL de votre serveur Microsoft CRM. Pour trouver votre URL de serveur Microsoft CRM, accédez à votre compte Microsoft Dynamics CRM, puis cliquez sur Dynamics 365 et sélectionnez votre application. Vous pouvez ensuite trouver votre URL de serveur dans la barre d’adresse de votre navigateur, par exemple : https://myserver.crm.dynamics.com/.
      • Compte : compte utilisé pour se connecter à Microsoft CRM
      • Mot de passe : compte utilisé pour se connecter à Microsoft CRM
      • Identifiant client : identifiant (client) d’application qui se trouve sur le portail de gestion Microsoft Azure au niveau de la catégorie Mettre à jour votre code, dans le champ Identifiant du client.
      • Version du CRM : sélectionnez la version du CRM Dynamics 365 CRM.
    2. Pour configurer le compte externe Microsoft Dynamics CRM afin de vous connecter à Adobe Campaign avec un Certificat, fournissez les détails suivants :

      • Serveur : URL de votre serveur Microsoft CRM. Pour trouver votre URL de serveur Microsoft CRM, accédez à votre compte Microsoft Dynamics CRM, puis cliquez sur Dynamics 365 et sélectionnez votre application. Vous pouvez ensuite trouver votre URL de serveur dans la barre d’adresse de votre navigateur, par exemple : https://myserver.crm.dynamics.com/.
      • Clé privée : copiez/collez la clé privée, encodée en base64, comme expliqué dans cette section.
      • Identifiant de clé : clé disponible dans l’onglet Manifeste de votre application, en suivant la procédure décrite dans cette section.
      • Identifiant de clé personnalisée : identifiant disponible dans l’onglet Manifeste de votre application, en suivant la procédure décrite dans cette section.
      • Identifiant du client : identifiant (client) d’application qui se trouve sur le portail de gestion Microsoft Azure, comme expliqué dans cette section.
      • Version du CRM : sélectionnez la version du CRM Dynamics 365 CRM.
  4. Sélectionnez l’option Activer pour activer le compte dans Campaign.

REMARQUE

Pour approuver la configuration, déconnectez-vous puis reconnectez-vous à la console cliente Adobe Campaign.

Sélection des tables à synchroniser

Vous pouvez maintenant configurer les tables à synchroniser.

  1. Cliquez sur l’Assistant de configuration de Microsoft CRM….
  2. Sélectionnez les tables à synchroniser et démarrez le processus.
  3. Vérifiez le schéma généré dans Adobe Campaign, sous le nœud Administration > Paramétrage > Schéma de données.
REMARQUE

Veillez à ajouter à la liste autorisée deux URL : l’URL du serveur et login.microsoftonline.com. Pour ce faire, contactez votre représentant Adobe.

Synchronisation des énumérations

Une fois le schéma créé, vous pouvez synchroniser automatiquement les énumérations entre Dynamics 365 et Adobe Campaign.

  1. Ouvrez l’assistant à partir du lien Synchronisation des énumérations….
  2. Sélectionnez l'énumération Adobe Campaign correspondant à l'énumération Dynamics 365.
    Vous pouvez remplacer toutes les valeurs d'une énumération Adobe Campaign par celles du CRM : pour cela, sélectionnez Oui dans la colonne Remplacer.
  3. Cliquez sur Suivant puis Démarrer pour lancer l'import des énumérations.
  4. Parcourez le nœud Administration > Plateforme > Énumérations pour vérifier les valeurs importées.

Adobe Campaign et Microsoft Dynamics 365 sont maintenant connectés. Vous pouvez configurer la synchronisation des données entre les deux systèmes.

Pour synchroniser les données entre Adobe Campaign et Microsoft CRM, créez un workflow et utilisez l’activité Connecteur CRM.

Pour en savoir plus sur la synchronisation des données, consultez cette page.

Types de données de champ pris en charge

Pour Microsoft Dynamics 365, les types d'attribut pris en charge/non pris en charge sont répertoriés ci-dessous :

Type d'attribut Pris en charge
Types simples : booléen, date et heure, nombre décimal, nombre à virgule flottante, doublon, nombre entier, entier long, chaîne Oui
Devise (en tant que doublon) Oui
mémo, nom de l'entité, clé primaire, identifiant unique (en tant que chaînes) Oui
Statut, liste de sélection (les valeurs possibles sont stockées dans des énumérations), état (chaîne) Oui
propriétaire (comme chaîne) Oui
Recherche (seules les recherches de référence d'entité unique) Oui
client Non
Concernant Non
PartyList Non
ManagedProperty Non

Sur cette page