Outbound-Marketing-Interaktionen für einen Kontakt mithilfe von Code abrufen

  • Artikel

Anmerkung

Dynamics 365 Marketing und Dynamics 365 Customer Insights sind jetzt Customer Insights - Journeys und Customer Insights - Data. Weitere Informationen finden Sie in den FAQs zu Dynamics 365 Customer Insights

Neue Kunden von Customer Insights - Journeys erhalten ausschließlich Echtzeitmarketingfunktionen. Zusätzliche Informationen finden Sie in Echtzeitkontaktverläufe – Standardinstallation.

Wichtig

Dieser Artikel gilt nur für Outbound-Marketing.

Wichtig

Die folgende Methode zum Abrufen von Interaktionen ist veraltet und möglicherweise in Zukunft nicht mehr verfügbar.

Um Interaktionsdaten abzurufen, empfiehlt es sich derzeit, Azure Blob Storage festzulegen und mit der Dynamics 365 Customer Insights - Journeys-App zu verbinden. Erfahren Sie mehr: Vorbereiten auf analytische Berichte mit Power BI

Verwenden Sie die Aktion msdyncrm_LoadInteractionsPublic, um programmgesteuert Interaktionen für einen Kontakt abzurufen. Diese Aktion ist nützlich, um auf Anforderungen zum Abruf persönlicher Daten zu reagieren und verschiedene Datenschutzgesetze und -vorschriften einzuhalten.

Tipp

Sie können auch Anforderungs- und Antwortklassen für Ihre Aktion generieren, um sie in Ihren Anwendungscode aufzunehmen. Weitere Informationen: Generieren von Typen mit früher Bindung für eine Aktion

Aktionsparameter

Die Aktion msdyncrm_LoadInteractionsPublic erwartet die folgenden Eingabeparameter:

Name Typ Beschreibung
ContactId Edm.String ID des Kontaktdatensatzes, der für die Interaktionen abgerufen werden soll. Erforderlich.
DateFrom Edm.String Startdatum für den Abruf der Interaktionen im Format MM/TT/JJJJ. Optional.
DateTo Edm.String Enddatum für den Abruf der Interaktionen im Format MM/TT/JJJJ. Optional.
InteractionType Edm.String Typ der abzurufenden Interaktion. Erforderlich.
Sie können einen der folgenden Werte angeben:
  • 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 Optional. Positive Zahl, die die Anzahl der zurückgegebenen Interaktionen für einen Kontaktdatensatz begrenzt. Optional.
SkipToken Edm.String Identifiziert einen Startpunkt in der Sammlung der Interaktionen, die für einen Kontaktdatensatz zurückgegeben werden. Optional.

Aktionsrückgabetyp

Die Aktion msdyncrm_LoadInteractionsPublic gibt den folgenden Wert zurück:

Name Typ Beschreibung
msdyncrm_LoadInteractionsPublicResponse KomplexTyp Enthält die Reaktion der Aktion „msdyncrm_LoadInteractionsPublic“. Es enthält die folgenden Eigenschaften, die die strukturierten Daten des Typs enthalten:
Name Typ Beschreibung
Data Edm.String Liste der Interaktionen als übergangener JSON-Array.
NextSkipToken Edm.String Identifiziert den nächsten Cursor oder das nächste Lesezeichen in der Sammlung der Interaktionen, die für einen Kontaktdatensatz zurückgegeben werden.

Beispiel

Anforderung

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": "0dbe0fa3-8e18-e811-a951-000d3a37caec",
}

Antwort

Die Antwort enthält ein JSON-Objekt mit einer Data-Eigenschaft, die die vollständige Liste der Interaktionen enthält.

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\":\"e47e99c2-20e3-4ef3-bbd4-288258bd6bf9\",\"EmailDomain\":\"microsoft.com\",\"ActivityId\":\"b6aeb700-f1c1-4cb1-e8f8-e883eac6bfbc\",\"SendingId\":\"5a019802-f763-3b72-fc91-0a9c95b67c5f\",\"ContactId\":\"0dbe0fa3-8e18-e811-a951-000d3a37caec\",\"MessageId\":\"5a2f3e76-9518-e811-a951-000d3a38caec\",\"CustomerJourneyId\":\"4c3846a1-9618-e811-a951-000d3a37cafc\",\"CustomerJourneyIterationId\":\"538825cf-fe1c-4fee-a671-7984eabb62eb\",\"UsageType\":\"CustomerJourney\",\"EmailAddressUsed\":\"sample@adventure-works.com\"}]",
    "NextSkipToken":null
}