Récupérer les interactions d'un contact dans le marketing sortant à l'aide de code

  • 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 s’applique uniquement à marketing sortant, qui sera supprimé du produit le 30 juin 2025. Pour éviter les interruptions, passez aux trajets en temps réel avant cette date. Plus d’informations : Aperçu de la transition

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 :
  • ActivityContactBlocked
  • ActivityContactDispatched
  • ActivityContactProcessingFailed
  • CreateCrmActivityContactProcessed
  • CreateCustomChannelActivityContactProcessed
  • CustomChannelResponse
  • CustomerJourneyContactRecordUpdated
  • EmailBlockBounced
  • EmailBlocked
  • EmailClicked
  • EmailContainsBlockListedLinks
  • EmailDelivered
  • EmailFeedbackLoop
  • EmailForwarded
  • EmailHardBounced
  • EmailOpened
  • EmailSendingFailed
  • EmailSent
  • EmailSoftBounced
  • EmailSubscriptionSubmit
  • EventCheckIn
  • EventRegistration
  • FormSubmitted
  • FormVisited
  • InvalidRecipientAddress
  • InvalidSenderAddress
  • LeadScoreBoost
  • OutOfEmailCredits
  • PassThroughActivityContactProcessed
  • RedirectLinkClicked
  • SchedulerActivityContactProcessed
  • SegmentRelationshipEdited
  • SegmentSubscribed
  • SegmentUnsubscribed
  • SplitterActivityContactProcessed
  • SurveyResponse
  • TriggerActivityContactProcessed
  • TriggerCrmWorkflowActivityContactProcessed
  • WebsiteClicked
  • WebsiteVisited
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 :
Nom Type Description
Data Edm.String Liste d’interactions sous forme de tableau JSON placé dans une séquence d’échappement.
NextSkipToken Edm.String Identifie le curseur ou le signet suivant dans l’ensemble des interactions retournées pour un enregistrement de contact.

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
}