アウトバウンド マーケティングでイベント API を使用する

  • [アーティクル]

注意

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

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

重要

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

イベント API は、イベント、セッション、セッション トラック、パス、スピーカー、スポンサーシップのデータにアクセスするためのプログラムによる方法です。 また、それを使用してイベントやセッションに登録できます。

スキーマ

API アクセスは HTTPS プロトコル経由で行われ、Web アプリケーション トークンの作成中に受け取った API エンドポイントからアクセスされます。 すべてのデータは JSON として送受信されます。

空白のフィールドは、省略されずに null として含まれます。

エンドポイント

すべての顧客は独自のエンドポイント URL を持ちます。 イベント API のエンドポイント URL は 2 つの部分で構成されています:

  • エンドポイント ドメイン
  • サブディレクトリ

Web アプリケーション トークンを作成した後、ルート エンドポイントを取得します。 Web アプリケーション トークンの作成方法については、こちらを参照してください: Web アプリケーションの登録。

ルート エンドポイントの例

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com

サブディレクトリは常に EvtMgmt/api で始まり、その後に API のバージョンが続きます (それは、ここから利用可能な API ドキュメントから取得できます: イベント管理 API リファレンスのドキュメント。

サブディレクトリの例

EvtMgmt/api/v2.0/

完全なエンドポイント URL の例

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/

認証

イベント API を使用するには、各リクエストごとに URL パラメーターとして web application token を提供する必要があります。 Web アプリケーション トークンが組織に関連付けられるコントロール API 要求に使用されます。 Web アプリケーションを作成および取得する方法の詳細は Web アプリケーションの登録 を参照してください。

web application token は、emApplicationtoken と呼ばれる URL パラメータを追加することで要求に追加できます。

例

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/events/published?emApplicationtoken=B7vdzdhCiLt9c5iT….

さらに、リクエストの送信元は、Web アプリケーション トークンの作成時に指定したものと同じである必要があります。

Web アプリケーション トークンまたはオリジン ヘッダーを指定しない場合、イベント API は HTTP 400 Bad Request を返します。

Web アプリケーション トークンが無効の場合、イベント API は HTTP 401 Unauthorized を返します。

Web アプリケーションの登録

イベント API を使用するには、各リクエストごとに Web アプリケーション トークンを指定する必要があります。 Web アプリケーション トークンが組織に関連付けられるコントロール API 要求に使用されます。 詳細: 独自の Web アプリケーションの登録。