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 宛先の スキーマ, a データセット、および audiences 次で作成: Experience Platform.

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

Microsoft Dynamics 365 前提条件 prerequisites-destination

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 ドキュメント 指導のために
ドメインが次のような場合、 宛先.
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

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

この宛先では、Experience Platform のセグメント化サービスで生成したすべてのオーディエンスのアクティブ化をサポートします。

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

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

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

宛先への接続 connect

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

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

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

宛先に対する認証 authenticate

宛先を認証するには、「 宛先に接続」を選択します。
認証方法を示す 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 のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
宛先の詳細を示す Platform UI のスクリーンショット。

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

アラートの有効化 enable-alerts

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

宛先接続の詳細の入力を終えたら「次へ」を選択します。

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

IMPORTANT
  • データをアクティブ化するには、 宛先の表示, 宛先のアクティブ化, プロファイルの表示、および セグメントを表示 アクセス制御権限. アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • 書き出す idID グラフを表示 アクセス制御権限.
    ワークフローでハイライト表示された ID 名前空間を選択して、宛先に対するオーディエンスをアクティブ化します。 {width="100" modal="regular"}

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

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

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

  1. マッピング ​手順で、「新しいマッピングを追加」を選択します。画面に新しいマッピング行が表示されます。
    「新しいマッピングを追加」の Platform UI のスクリーンショットの例。

  2. ソースフィールドを選択 ​ウィンドウで、「ID 名前空間カテゴリを選択」を選択します。contactid
    ソースマッピング用の Platform UI のスクリーンショットの例。

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

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

      コンタクト先のターゲットマッピングを示す Platform UI のスクリーンショット。

    • XDM プロファイルスキーマと Dynamics 365 インスタンスの間の次のマッピングを追加:
      |XDM プロファイルスキーマ|Dynamics 365 インスタンス| 必須|
      |—|—|—|
      |contactid|contactid| はい |

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

      E メールの Target マッピングを示す 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 インスタンスの間に次のようにマッピングを追加します。
      |XDM プロファイルスキーマ|Dynamics 365 インスタンス|
      |—|—|
      |person.name.firstName|firstname|
      |person.name.lastName|lastname|
      |personalEmail.address|emailaddress1|

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

      ターゲットマッピングを示した Platform UI のスクリーンショットの例。

オーディエンスのエクスポートと例のスケジュール設定 schedule-audience-export-example

Adobe Analytics の オーディエンスの書き出しをスケジュール アクティベーションワークフローの手順では、Platform オーディエンスを、 Dynamics 365.

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

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

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

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

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

  1. 宛先参照 を選択して、宛先のリストに移動します。
    宛先の参照を示す Platform UI のスクリーンショット。

  2. 宛先を選択し、ステータスが「 有効」であることを確認します。
    宛先のデータフロー実行を示した Platform UI のスクリーンショット。

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

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

  5. にログインします。 Dynamics 365 web サイトに移動し、 Customers > Contacts ページを開き、オーディエンスからのプロファイルが追加されたかどうかを確認します。 各オーディエンスのステータスは、 Dynamics 365 は、 マッピング ID 期間中に指定された値 オーディエンススケジュール 手順
    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.

無効なリクエストエラーを示す Platform UI のスクリーンショット。

このエラーを修正するには、 マッピング ID 指定した Dynamics 365 は、Platform オーディエンスが有効で、内に存在する場合に使用します。 Dynamics 365.

その他のリソース additional-resources

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

変更ログ

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

変更ログを表示
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