Microsoft Dynamics 365 接続

概要 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

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

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

Customization prefix​で作成したカスタムフィールドの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

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

項目
タイプ
メモ
書き出しタイプ
Profile-based
  • オーディエンスのすべてのメンバーを、フィールドマッピングに従って、目的のスキーマフィールド (例:電子メールアドレス、電話番号、姓)​と共に書き出します。
  • Dynamics 365の各オーディエンスステータスは、Mapping ID オーディエンススケジュール 手順で指定した値に基づいて、Experience Platformからの対応するオーディエンスステータスで更新されます。
書き出し頻度
Streaming
  • ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。

宛先への接続 connect

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

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

Destinations > Catalog​内でDynamics 365を検索します。 または、CRM カテゴリの下に配置することもできます。

宛先に対する認証 authenticate

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

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

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

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

宛先の詳細を入力 destination-details

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

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

アラートの有効化 enable-alerts

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

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

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

IMPORTANT
  • データをアクティブ化するには、View DestinationsActivate DestinationsView Profiles​および​View Segments ​ アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • ID​をエクスポートするには、View Identity Graph ​ アクセス制御権限が必要です。
    ​ ワークフローで強調表示されているID名前空間を選択して、オーディエンスを宛先にアクティブ化します。 {width="100" modal="regular"}

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

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

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

  1. Mapping ステップで、Add new mapping​を選択します。 画面に新しいマッピング行が表示されます。
    新しいマッピングを追加するExperience Platform UIのスクリーンショット例。

  2. Select source field ウィンドウで、Select identity namespace カテゴリを選択し、contactidを選択します。
    Source マッピングのExperience Platform UIのスクリーンショット例。

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

    • Select identity namespace: ソースフィールドをリストからID名前空間にマッピングするには、このオプションを選択します。
      contactidのTarget マッピングを示すExperience Platform UI スクリーンショット。

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

      table 0-row-3 1-row-3
      XDM プロファイルスキーマ Dynamics 365 インスタンス 必須
      contactid contactid
    • Select custom attributes: ソースフィールドを​Attribute name フィールドで定義したカスタム属性にマッピングするには、このオプションを選択します。 サポートされる属性の包括的なリストについては、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

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

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

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

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

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

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

  1. 宛先のリストに移動するには、Destinations > Browse​を選択します。
    宛先を参照を示すExperience Platform UIのスクリーンショット。

  2. 宛先を選択し、ステータスが​ enabled ​であることを検証します。
    宛先データフロー実行を示す Experience Platform UIのスクリーンショット。

  3. Activation data」タブに切り替えて、オーディエンス名を選択します。
    宛先アクティベーションデータを示す Experience Platform UI スクリーンショットの例。

  4. オーディエンスの概要を監視し、プロファイルの数がオーディエンス内で作成された数に対応していることを確認します。
    オーディエンスを示す Experience Platform UI スクリーンショットの例。

  5. Dynamics 365 web サイトに移動し、Customers > Contacts ページに移動して、オーディエンスのプロファイルが追加されているかどうかを確認します。 Dynamics 365の各オーディエンスステータスが、Mapping ID オーディエンススケジュール 手順で指定した値に基づいて、Experience Platformの対応するオーディエンスステータスで更新されていることがわかります。
    更新されたオーディエンスのステータスを含む連絡先ページを示す Dynamics 365 UIのスクリーンショット。

データの使用とガバナンス 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のスクリーンショット。

このエラーを修正するには、Mapping ID​で指定したExperience Platform オーディエンスのDynamics 365が有効であり、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 カスタムフィールド接頭辞のサポートを追加しました。 新しい入力フィールド Customization Prefix​が、宛先の詳細を入力手順で追加されました。 (PLATIR-31602)。
2022年11月 初回リリース 最初の宛先リリースとドキュメントの公開。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6