コードを使用してアウトバウンド マーケティングの対話を取得する
注意
Dynamics 365 Marketing と Dynamics 365 Customer Insights は Customer Insights - Journeys と Customer Insights - Data になりました。 詳細については、Dynamics 365 Customer Insights のよくあるご質問 をご覧ください
Customer Insights - Journeys の新しい顧客には、リアルタイム体験機能のみが提供されます。 詳細については、既定のリアルタイム体験のインストールを参照してください。
重要
この記事は、2025 年 6 月 30 日に製品から削除される アウトバウンド マーケティングにのみ適用されます。 中断を避けるため、この日付より前にリアルタイムの旅程に移行してください。 詳細: 切り替えの概要
重要
以下の方法でインタラクションを取得することは非推奨であるため、将来的に利用できなくなる可能性があります。
インタラクション データを取得するためには、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 | 取得する対話の種類。 必須。 次のいずれかの値を指定できます。
|
Top |
Edm.Int32 | 省略可能。 1 件の取引先担当者レコードに対して返される対話の数を制限する正の整数。 省略可能。 |
SkipToken |
Edm.String | 取引先担当者レコードに対して返される対話のコレクション内の開始点を示します。 省略可能。 |
アクションの戻り値の型
msdyncrm_LoadInteractionsPublic アクションは次の値を返します。
| 名前 | 型 | 説明 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
msdyncrm_LoadInteractionsPublicResponse |
ComplexType | msdyncrm_LoadInteractionsPublic アクションからの応答を含みます。 これには、次の型の構造化されたデータを含んだプロパティが含まれます。
|
例
要求
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",
}
応答
応答には、対話の完全な一覧を含んだ 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\":\"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
}