Récupérer les interactions d'un contact dans le marketing sortant à l'aide de code
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
Important
La méthode ci-dessous pour récupérer les interactions a été déconseillée et pourrait ne plus être disponible à l’avenir.
Pour récupérer les données d’interaction, la méthode actuellement recommandée consiste à configurer Stockage Azure Blob et à le connecter à l’application Dynamics 365 Customer Insights - Journeys. En savoir plus : Préparer la création de rapports d’analyse avec Power BI
Utilisez l’action msdyncrm_LoadInteractionsPublic pour récupérer par programme les interactions d’un contact. Cette action est utile pour répondre aux demandes d’obtention de mes données pour se conformer à diverses lois et réglementations sur la confidentialité.
Astuce
Vous pouvez également générer des classes de demande et de réponse pour cette action à inclure dans votre code d’application. Pour plus d’informations : Générer des types à liaison anticipée pour une action
Paramètres de l’action
L’action msdyncrm_LoadInteractionsPublic requiert les paramètres d’entrée suivants :
Nom | Type | Description |
---|---|---|
ContactId |
Edm.String | ID de l’enregistrement de contact pour lequel récupérer les interactions. Obligatoire. |
DateFrom |
Edm.String | Date de début au format MM-JJ-AAAA à partir de laquelle vous souhaitez récupérer des interactions. Facultatif. |
DateTo |
Edm.String | Date de fin au format MM-JJ-AAAA jusqu’à laquelle vous souhaitez récupérer des interactions. Facultatif. |
InteractionType |
Edm.String | Type d’interaction à récupérer. Obligatoire. Vous pouvez spécifier l’une des valeurs suivantes :
|
Top |
Edm.Int32 | Facultatif. Entier non négatif qui limite le nombre d’interactions retournées pour un enregistrement de contact. Facultatif. |
SkipToken |
Edm.String | Identifie un point de départ dans l’ensemble des interactions retournées pour un enregistrement de contact. Facultatif. |
Type de retour d’action
L’action msdyncrm_LoadInteractionsPublic retourne la valeur suivante :
Nom | Type | Description | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
msdyncrm_LoadInteractionsPublicResponse |
ComplexType | Contient la réponse de l’action msdyncrm_LoadInteractionsPublic. Elle contient les propriétés suivantes qui contiennent les données structurées du type :
|
Exemple
Demande
POST [Organization URI]/api/data/v9.0/msdyncrm_LoadInteractionsPublic HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
{
"InteractionType": "WebsiteClicked",
"ContactId": "33dd33dd-ee44-ff55-aa66-77bb77bb77bb",
}
Réponse
La réponse contient un objet JSON avec une propriété Data
contenant la liste complète des interactions.
HTTP/1.1 200 OK
Content-Type: application/json; odata.metadata=minimal
OData-Version: 4.0
{
"@odata.context":"[Organization URI]/api/data/v9.0/$metadata#Microsoft.Dynamics.CRM.msdyncrm_LoadInteractionsPublicResponse",
"Data":"[{\"InteractionId\":\"172C1E59A3CD4D85B392316DD76651CE\",\"InteractionType\":\"EmailSent\",\"Timestamp\":\"2018-02-23T13:10:48Z\",\"OrganizationId\":\"00aa00aa-bb11-cc22-dd33-44ee44ee44ee\",\"EmailDomain\":\"microsoft.com\",\"ActivityId\":\"11bb11bb-cc22-dd33-ee44-55ff55ff55ff\",\"SendingId\":\"22cc22cc-dd33-ee44-ff55-66aa66aa66aa\",\"ContactId\":\"33dd33dd-ee44-ff55-aa66-77bb77bb77bb\",\"MessageId\":\"44ee44ee-ff55-aa66-bb77-88cc88cc88cc\",\"CustomerJourneyId\":\"55ff55ff-aa66-bb77-cc88-99dd99dd99dd\",\"CustomerJourneyIterationId\":\"66aa66aa-bb77-cc88-dd99-00ee00ee00ee\",\"UsageType\":\"CustomerJourney\",\"EmailAddressUsed\":\"sample@adventure-works.com\"}]",
"NextSkipToken":null
}