コードを使用してアウトバウンド マーケティングの対話を取得する

  • [アーティクル]

注意

Dynamics 365 Marketing と Dynamics 365 Customer Insights は Customer Insights - Journeys と Customer Insights - Data になりました。 詳細については、Dynamics 365 Customer Insights のよくあるご質問 をご覧ください

Customer Insights - Journeys の新しい顧客には、リアルタイム体験機能のみが提供されます。 詳細については、既定のリアルタイム体験のインストールを参照してください。

重要

この記事は、アウトバウンド マーケティングにのみ適用されます。

重要

以下の方法でインタラクションを取得することは非推奨であるため、将来的に利用できなくなる可能性があります。

インタラクション データを取得するためには、Azure Blob ストレージを設定し、Dynamics 365 Customer Insights - Journeys アプリに接続する方法が推奨されています。 詳細情報: Power BI を使用した分析レポートの準備

msdyncrm_LoadInteractionsPublic アクションを使用して、プログラムで取引先担当者の対話を取得できます。 このアクションは、さまざまなプライバシー法や規制を遵守するために データ取得リクエスト に応答するのに役立ちます。

チップ

さらに、アプリケーション コードに含めるこのアクションに対する要求と応答クラスを生成することができます。 詳細: 操作用の事前バインド型を生成する

アクション パラメーター

msdyncrm_LoadInteractionsPublic アクションでは、次の入力パラメーターを使用します。

名前 型 説明
ContactId Edm.String 対話を取得する取引先担当者レコードの ID。 必須。
DateFrom Edm.String 対話取得の開始日 (MM-DD-YYYY の形式)。 省略可能。
DateTo Edm.String 対話取得の終了日 (MM-DD-YYYY の形式)。 省略可能。
InteractionType Edm.String 取得する対話の種類。 必須。
次のいずれかの値を指定できます。
  • 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 省略可能。 1 件の取引先担当者レコードに対して返される対話の数を制限する正の整数。 省略可能。
SkipToken Edm.String 取引先担当者レコードに対して返される対話のコレクション内の開始点を示します。 省略可能。

アクションの戻り値の型

msdyncrm_LoadInteractionsPublic アクションは次の値を返します。

名前 型 説明
msdyncrm_LoadInteractionsPublicResponse ComplexType msdyncrm_LoadInteractionsPublic アクションからの応答を含みます。 これには、次の型の構造化されたデータを含んだプロパティが含まれます。
名前 型 説明
Data Edm.String エスケープされた JSON 配列として示された対話の一覧。
NextSkipToken Edm.String 取引先担当者レコードに対して返される対話のコレクション内の、次のカーソル位置またはブックマークを示します。

例

要求

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",
}

応答

応答には、対話の完全な一覧を含んだ Data プロパティを持つ JSON オブジェクトが含まれます。

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
}