Microsoft Dynamics 365 接続

最終更新日： 2026年6月16日

トピック：
{"id":"a37e4ecd-c740-426a-addf-cb1b483c5c5a"},{"id":"c132d929-fa62-4271-803e-b823be07b914"}

作成対象：

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"},{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

概要 overview

Microsoft Dynamics 365 は、クラウドベースのビジネスアプリケーションプラットフォームです。エンタープライズリソースプランニング（ERP）と顧客関係管理（CRM）を生産性アプリケーションと AI ツールと組み合わせて、エンドツーエンドのスムーズで制御可能な運用、優れた成長の可能性およびコスト削減を実現します。

このAdobe Experience Platform 宛先は、Contact Entity Reference APIを活用して、オーディエンス内のIDをDynamics 365に更新します。

Dynamics 365 は、認証付与を使用する OAuth 2 を認証メカニズムとして使用して、Contact Entity Reference API と通信します。 Dynamics 365 インスタンスを認証する手順は、さらに下の宛先に対する認証の節にあります。

ユースケース use-cases

マーケターは、Adobe Experience Platformのプロファイルの属性に基づいて、パーソナライズされたエクスペリエンスをユーザーに配信できます。オフラインデータからオーディエンスを作成し、これらのオーディエンスをDynamics 365に送信すると、Adobe Experience Platformでオーディエンスとプロファイルが更新されるとすぐに、ユーザーのフィードに表示できます。

前提条件 prerequisites

Experience Platform の前提条件 prerequisites-in-experience-platform

Dynamics 365宛先にデータをアクティブ化する前に、Experience Platformでスキーマ、データセット、およびオーディエンスを作成しておく必要があります。

オーディエンスのステータスに関するガイダンスが必要な場合は、オーディエンスメンバーシップの詳細スキーマフィールドグループに関するAdobeのドキュメントを参照してください。

Microsoft Dynamics 365 前提条件 prerequisites-destination

Experience PlatformからDynamics 365 アカウントにデータをエクスポートするには、Dynamics 365の次の前提条件に注意してください。

Microsoft Dynamics 365 アカウントが必要です prerequisites-account

アカウントをまだお持ちでない場合は、Dynamics 365 体験版ページに移動し、アカウントを登録して作成してください。

Dynamics 365 内にフィールドを作成 prerequisites-custom-field

フィールドのデータタイプがSingle Line of Textのタイプ Simpleのカスタムフィールドを作成します。このフィールドをExperience PlatformでDynamics 365内のオーディエンスステータスの更新に使用します。

追加のガイダンスが必要な場合は、Dynamics 365 フィールド（属性）の作成または編集に関するドキュメントを参照してください。

Dynamics 365で作成したカスタムフィールドの カスタマイズ接頭辞 を書き留めます。このプレフィックスは、宛先の詳細を入力手順の間に必要になります。詳しくは、Dynamics 365 ドキュメントのフィールドの作成と編集セクションを参照してください。
カスタマイズのプレフィックスを示す Dynamics 365 UIのスクリーンショット。

Dynamics 365内の設定例を次に示します。
カスタムフィールドを示す Dynamics 365 UIのスクリーンショット。

Azure Active Directory 内でのアプリケーションとアプリケーションユーザーの登録 prerequisites-app-user

Dynamics 365 をリソースにアクセスできるようにするには、Azure Account を使用して Azure Active Directory にログインし、以下を作成する必要があります。

Azure Active Directory アプリケーション
サービスプリンシパル
アプリケーション秘密鍵

また、Azure Active Directory でアプリケーションユーザーを作成し、新しく作成したアプリケーションに関連付ける必要があります。

Dynamics 365 資格情報の収集 gather-credentials

Dynamics 365 CRM 宛先に対して認証を行う前に、以下の項目をメモしておきます。

資格情報

説明

例

Client ID

お使いの Azure Active Directory アプリケーションの Dynamics 365 クライアント ID。詳しくは、Dynamics 365 ドキュメントを参照してください。

ababbaba-abab-baba-acac-acacacacacac

Client Secret

お使いの Azure Active Directory アプリケーションの Dynamics 365 クライアント秘密鍵。 Dynamics 365 ドキュメント内のオプション #2 を使用することになります。

説明のための abcde~abcdefghijklmnopqrstuvwxyz12345678。

Tenant ID

お使いの Azure Active Directory アプリケーションの Dynamics 365 テナント ID。詳しくは、Dynamics 365 ドキュメントを参照してください。

1234567-aaaa-12ab-ba21-1234567890

Region

環境URLに関連付けられているMicrosoft リージョン。
詳しくは、Dynamics 365 ドキュメントを参照してください。

ドメインが以下の場合、destinationに対する認証時に、ドロップダウンセレクターのCRM フィールドに強調表示された値を指定する必要があります。
org57771b33.crm.dynamics.com
例：会社が北米（NAM）地域でプロビジョニングされている場合、URLはcrm.dynamics.comになり、crmを選択する必要があります。会社がカナダ（CAN）リージョンでプロビジョニングされている場合、URLはcrm3.dynamics.comになり、crm3を選択する必要があります。

Environment URL

詳しくは、Dynamics 365 ドキュメントを参照してください。

お使いの Dynamics 365 ドメインが以下のようになっている場合は、ハイライト表示された値が必要です。
org57771b33.crm.dynamics.com

ガードレール guardrails

リクエストの制限と割り当てページでは、Dynamics 365 ライセンスに関連する Dynamics 365 API 制限を詳細に説明しています。データとペイロードがこれらの制約内にあることを確認する必要があります。

サポートされる ID supported-identities

Dynamics 365 では、以下の表で説明する ID の更新をサポートしています。 ID についての詳細情報。

ターゲット ID

例

説明

注意点

contactid

77eb682f1-ca75-e511-80d4-00155d2a68d1

連絡先の一意の ID。

必須。詳しくは、Dynamics 365 ドキュメントを参照してください。

サポートされるオーディエンス supported-audiences

この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。

オーディエンスの由来

対応

説明

Segmentation Service

○

Experience Platform セグメント化サービスを通じて生成されたオーディエンス。

その他すべてのオーディエンスの生成元

このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。様々なオーディエンスの起源について読みます。次に例を示します。

カスタムアップロードオーディエンスがCSV ファイルからExperience Platformにをインポートしました。
類似オーディエンス，
連合オーディエンス，
Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
その他。

オーディエンスのデータタイプ別にサポートされるオーディエンス：

オーディエンスのデータタイプ

対応

説明

ユースケース

人物オーディエンス

○

顧客プロファイルにもとづいて、マーケティング施策の特定のグループをターゲットにすることができます。

買い物客やカートの放棄が多い

アカウントオーディエンス

アカウントベースドマーケティング戦略のために、特定の組織内の個人をターゲットにします。

B2B マーケティング

見込みオーディエンス

まだ顧客ではないが、ターゲットオーディエンスと特徴を共有する個人をターゲットにします。

サードパーティデータによる見込み顧客の開拓

データセットの書き出し

Adobe Experience Platform データレイクに保存されている構造化データのコレクション。

レポート，データサイエンスワークフロー

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しタイプと頻度については、次の表を参照してください。

項目

タイプ

メモ

書き出しタイプ

プロファイルベース

オーディエンスのすべてのメンバーを、フィールドマッピングに従って、目的のスキーマフィールド （例：電子メールアドレス、電話番号、姓）と共に書き出します。
Dynamics 365の各オーディエンスステータスは、オーディエンススケジュール手順で指定した マッピング ID 値に基づいて、Experience Platformからの対応するオーディエンスステータスで更新されます。

書き出し頻度

ストリーミング

ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。

宛先への接続 connect

IMPORTANT

宛先に接続するには、宛先を表示および宛先を管理 アクセス制御権限が必要です。詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。

宛先/カタログ内でDynamics 365を検索します。または、CRM カテゴリの下に配置することもできます。

宛先に対する認証 authenticate

宛先に対する認証を行うには、宛先に接続を選択します。
認証方法を示す Experience Platform UIのスクリーンショット。

以下の必須のフィールドに入力します。詳しくは、Dynamics 365 資格情報の収集の節を参照してください。

クライアント ID: Azure Active Directory アプリケーションのDynamics 365 クライアント ID。
テナント ID: Azure Active Directory アプリケーションのDynamics 365 テナント ID。
クライアントシークレット: Azure Active Directory アプリケーションのDynamics 365 クライアントシークレット。
地域：お客様のDynamics 365地域例：会社が北米（NAM）地域でプロビジョニングされている場合、URLはcrm.dynamics.comになり、crmを選択する必要があります。会社がカナダ（CAN）リージョンでプロビジョニングされている場合、URLはcrm3.dynamics.comになり、crm3を選択する必要があります。
環境URL: Dynamics 365環境URL。

指定した詳細が有効な場合、UI には 接続済み ステータスに緑色のチェックマークが表示されます。その後、次の手順に進むことができます。

宛先の詳細を入力 destination-details

宛先の詳細を設定するには、以下の必須フィールドと任意フィールドに入力します。UIのフィールドの横にアスタリスク記号が表示されている場合は、そのフィールドが必須であることを示します。
宛先の詳細を示す Experience Platform UIのスクリーンショット。

名前：今後この宛先を認識する際に使用する名前。
説明：今後この宛先を特定するのに役立つ説明です。
カスタマイズプレフィックス: Dynamics 365で作成したカスタムフィールドのCustomization prefix。詳しくは、Dynamics 365 ドキュメントのフィールドの作成と編集セクションを参照してください。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続の詳細の提供が完了したら、次へを選択します。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT

データをアクティブ化するには、宛先の表示、宛先のアクティブ化、プロファイルの表示およびセグメントの表示 アクセス制御の権限が必要です。アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
IDをエクスポートするには、ID グラフの表示 アクセス制御権限が必要です。
{width="100" modal="regular"}

この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。

マッピングの考慮事項と例 mapping-considerations-example

オーディエンスデータをAdobe Experience PlatformからDynamics 365宛先に正しく送信するには、フィールドマッピング手順を実行する必要があります。マッピングでは、Experience Platform アカウントのExperience Data Model （XDM）スキーマフィールドと、ターゲット先の対応するスキーマフィールドとの間にリンクを作成します。 XDM フィールドを Dynamics 365 宛先フィールドに正しくマッピングするには、次の手順に従います。

マッピング手順で、新しいマッピングを追加を選択します。新しいマッピング行が画面に表示されます。
ソースフィールドを選択 ウィンドウで、ID名前空間を選択 カテゴリを選択し、contactidを選択します。

ターゲットフィールドを選択 ウィンドウで、ソースフィールドをマッピングするターゲットフィールドのタイプを選択します。

ID名前空間を選択: リストからID名前空間にソースフィールドをマッピングするには、このオプションを選択します。

XDM プロファイルスキーマとDynamics 365 インスタンスの間に次のマッピングを追加します。

table 0-row-3 1-row-3
XDM プロファイルスキーマ	Dynamics 365 インスタンス	必須
`contactid`	`contactid`	○

カスタム属性を選択: ソースフィールドを属性名 フィールドで定義したカスタム属性にマッピングするには、このオプションを選択します。サポートされる属性の包括的なリストについては、Dynamics 365 ドキュメントを参照してください。
メールのTarget マッピングを示す Experience Platform UI スクリーンショット。

note important

IMPORTANT

ターゲットフィールド名はlowercaseにする必要があります。
さらに、Dynamics 365 日付またはタイムスタンプターゲットフィールドにマッピングされた日付またはタイムスタンプソースフィールドがある場合は、マッピングされた値が空でないことを確認してください。書き出されたフィールド値が空の場合、Bad request reported while pushing events to the destination. Please contact the administrator and try again. エラーメッセージが表示され、データは更新されません。（これは Dynamics 365 の制限です。）

例えば、更新する値に応じて、XDM プロファイルスキーマとDynamics 365 インスタンスの間に次のマッピングを追加します。

table 0-row-2 1-row-2 2-row-2 3-row-2
XDM プロファイルスキーマ	Dynamics 365 インスタンス
`person.name.firstName`	`firstname`
`person.name.lastName`	`lastname`
`personalEmail.address`	`emailaddress1`

これらのマッピングの使用例を次に示します。

Target マッピングを示すExperience Platform UI スクリーンショットの例。

オーディエンスの書き出しのスケジュールと例 schedule-audience-export-example

アクティベーションワークフローのオーディエンスの書き出しをスケジュール手順では、Experience Platform オーディエンスをDynamics 365のカスタムフィールド属性に手動でマッピングする必要があります。

これを行うには、各オーディエンスを選択し、マッピング ID フィールドにDynamics 365から対応するカスタムフィールド属性を入力します。

IMPORTANT

マッピング IDに使用される値は、Dynamics 365内で作成されたカスタムフィールド属性の名前と完全に一致する必要があります。カスタムフィールド属性を見つけるガイダンスが必要な場合は、Dynamics 365 ドキュメントを参照してください。

例を次に示します。
Experience Platform UIのスクリーンショットの例。スケジュールオーディエンスの書き出しを示します。

データの書き出しを検証する exported-data

宛先が正しく設定されていることを検証するには、次の手順に従います。

宛先のリストに移動するには、宛先/参照を選択します。
宛先を選択し、ステータスが enabled であることを検証します。
宛先データフロー実行を示す
「Activation data」タブに切り替えて、オーディエンス名を選択します。
宛先アクティベーションデータを示す
オーディエンスの概要を監視し、プロファイルの数がオーディエンス内で作成された数に対応していることを確認します。
オーディエンスを示す
Dynamics 365 web サイトに移動し、Customers > Contacts ページに移動して、オーディエンスのプロファイルが追加されているかどうかを確認します。オーディエンススケジュール手順で指定された マッピング ID 値に基づいて、Dynamics 365の各オーディエンスステータスが、Experience Platformの対応するオーディエンスステータスで更新されていることがわかります。
更新されたオーディエンスのステータスを含む連絡先ページを示す

データの使用とガバナンス data-usage-governance

Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。 Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

エラーとトラブルシューティング errors-and-troubleshooting

イベントを宛先にプッシュする際に不明なエラーが発生しました unknown-errors

データフローの実行を確認する際に、次のエラーメッセージが表示される場合。Bad request reported while pushing events to the destination. Please contact the administrator and try again.

不正なリクエストエラーを示す Experience Platform UIのスクリーンショット。

このエラーを修正するには、Dynamics 365で指定したExperience Platform オーディエンスの マッピング ID が有効であり、Dynamics 365内に存在することを確認してください。

その他のリソース additional-resources

Dynamics 365 ドキュメントからのその他の役に立つ情報は次のとおりです。

変更ログ changelog

この節では、この宛先コネクタに対する機能の概要と重要なドキュメントの更新について説明します。

変更ログを表示

table 0-row-3 1-row-3 2-row-3 3-row-3 layout-auto
リリース月	更新タイプ	説明
2023年10月	ドキュメントの更新	すべてのターゲット属性名を小文字にする必要があることを示すガイダンスが、マッピングの考慮事項と例の手順で更新されました。
2023年8月	機能とドキュメントの更新	Dynamics 365のデフォルトソリューション内で作成されなかったカスタムフィールドのDynamics 365 カスタムフィールド接頭辞のサポートを追加しました。新しい入力フィールドカスタマイズのプレフィックスが、宛先の詳細を入力ステップに追加されました。（PLATIR-31602）。
2022年11月	初回リリース	最初の宛先リリースとドキュメントの公開。

recommendation-more-help

experience-platform-help-destinations