Partager via

Utilisation de l’API d’événements dans le marketing sortant

  • Article

Note

Dynamics 365 Marketing et Dynamics 365 Customer Insights sont maintenant Customer Insights - Journeys et Customer Insights - Data. Pour plus d’informations, consultez les Dynamics 365 Customer Insights FAQ

Les nouveaux clients Customer Insights - Journeys reçoivent uniquement des fonctionnalités des parcours en temps réel. Pour en savoir plus, consultez Installation de parcours en temps réel par défaut.

Important

Cet article ne s’applique qu’au marketing sortant, qui sera supprimé du produit le 30 juin 2025. Pour éviter les interruptions, passez aux parcours en temps réel avant cette date. Plus d’informations, voir Vue d’ensemble des transitions

L’API d’événements est une méthode par programme qui permet d’accéder aux données des événements, des sessions, des suivis de session, des pass, des haut-parleurs, et des parrainages. En outre, elle vous permet de vous inscrire à des événements et des sessions.

Schéma

L’accès à l’API s’effectue via protocole HTTPS, à partir du point de terminaison de l’API que vous recevez lors de la création d’un jeton d’application Web. Toutes les données sont envoyées et reçues au format JSON.

Les champs vierges sont inclus comme null au lieu d’être omis.

Point de terminaison

Chaque client a sa propre URL du point de terminaison. L’URL du point de terminaison de l’API d’événement est composée de deux parties :

  • Le domaine du point de terminaison
  • Le sous-répertoire

Vous obtenez le point de terminaison racine après avoir créé un jeton d’application Web. Vous trouverez plus d’informations sur la création d’un jeton d’application Web ici : Enregistrer votre application Web.

Exemple de point de terminaison racine

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com

Le sous-répertoire démarre toujours par EvtMgmt/api suivi de la version de l’API, qui peut être récupérée à partir de la documentation de l’API disponible ici : Documents de référence de l’API de gestion des événements.

Exemple de sous-répertoire

EvtMgmt/api/v2.0/

Exemple d’URL du point de terminaison complet

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/

Authentification

Pour utiliser l’API d’événements, vous devez fournir un web application token comme paramètre d’URL dans chaque demande. Le jeton d’application Web est utilisé pour contrôler les requêtes de l’API associées à votre organisation. Voir Enregistrer votre application Web pour plus d’informations sur la création et la récupération d’une application Web.

Le web application token peut être ajouté à la demande en ajoutant un paramètre d’URL appelé emApplicationtoken.

Exemple

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/events/published?emApplicationtoken=B7vdzdhCiLt9c5iT….

En outre, la provenance de la requête doit être égale à celle spécifiée lors de la création du jeton d’application Web.

Si vous ne fournissez pas de jeton d’application Web ou d’en-tête d’origine, l’API d’événements retourne HTTP 400 Bad Request.

Si le jeton d’application Web n’est pas valide, l’API d’événements retourne HTTP 401 Unauthorized.

Enregistrer votre application Web

Pour utiliser l’API d’événements, vous devez fournir un jeton d’application Web comme paramètre d’URL dans chaque demande. Le jeton d’application web est utilisé pour contrôler les requêtes de l’API associées à votre organisation. Informations complémentaires : Enregistrer votre application Web.