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
Experience Platformが Simple 内のオーディエンスステータスの更新に使用する Single Line of Text のフィールドデータタイプを使用して、タイプ Dynamics 365 のカスタムフィールドを作成します。
追加のガイダンスが必要な場合は、Dynamics 365 フィールド(属性)の作成または編集) ドキュメントを参照してください。
Customization prefix で作成したカスタムフィールドの Dynamics 365 を書き留めます。 宛先の詳細の入力 手順で、このプレフィックスが必要になります。 詳しくは、 ドキュメントの フィールドの作成と編集 Dynamics 365 の節を参照してください。
Dynamics 365 内の設定例を次に示します。
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 IDababbaba-abab-baba-acac-acacacacacacClient Secretabcde~abcdefghijklmnopqrstuvwxyz12345678。Tenant ID1234567-aaaa-12ab-ba21-1234567890Region詳しくは、Dynamics 365 ドキュメント を参照してください。
への認証時に、ドロップダウンセレクターの CRM フィールドのハイライト表示された値を指定する必要があります org57771b33。
crm.dynamics.com例:会社が北米(NAM)地域でプロビジョニングされている場合、URL は
crm.dynamics.com になり、crm を選択する必要があります。 会社がカナダ(CAN)地域でプロビジョニングされている場合、URL は crm3.dynamics.com になり、crm3 を選択する必要があります。Environment URLorg57771b33.crm.dynamics.comガードレール guardrails
リクエストの制限と割り当てページでは、Dynamics 365 ライセンスに関連する Dynamics 365 API 制限を詳細に説明しています。データとペイロードがこれらの制約内にあることを確認する必要があります。
サポートされる ID supported-identities
Dynamics 365 では、以下の表で説明する ID の更新をサポートしています。ID についての詳細情報。
サポートされるオーディエンス supported-audiences
この節では、この宛先に書き出しできるすべてのオーディエンスについて説明します。
この宛先では、Experience Platform のセグメント化サービスで生成したすべてのオーディエンスのアクティブ化をサポートします。
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
- フィールドマッピングに従って、目的のスキーマフィールド (例:メールアドレス、電話番号、姓) と共に、オーディエンスのすべてのメンバーを書き出します。
- Dynamics 365 の各オーディエンスステータスは、Mapping ID オーディエンスのスケジュール設定 手順で指定された 値に基づいて、Experience Platformの対応するオーディエンスステータスとともに更新されます。
- ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。詳しくは、ストリーミングの宛先を参照してください。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
Destinations > Catalog 内で Dynamics 365 を検索します。 または、CRM カテゴリの下に配置することもできます。
宛先に対する認証 authenticate
宛先を認証するには、「Connect to destination」を選択します。
以下の必須のフィールドに入力します。詳しくは、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 のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
- Name:今後この宛先を認識するための名前。
- Description:今後この宛先を識別するのに役立つ説明。
- Customization Prefix:
Customization prefixで作成したカスタムフィールドの Dynamics 365。 詳しくは、 ドキュメントの フィールドの作成と編集 Dynamics 365 の節を参照してください。
アラートの有効化 enable-alerts
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続への詳細の入力を終えたら「Next」を選択します。
この宛先に対してオーディエンスをアクティブ化 activate
- データをアクティブ化するには、View Destinations、Activate Destinations、View Profiles、View Segments アクセス制御権限 が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
- ID を書き出すには、View Identity Graph アクセス制御権限 が必要です。
{width="100" modal="regular"}
この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。
マッピングの考慮事項と例 mapping-considerations-example
Adobe Experience Platform から Dynamics 365 宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。マッピングは、Experience Platform アカウント内の Experience Data Model (XDM)スキーマフィールドと、ターゲット宛先から対応する同等のスキーマフィールドとの間にリンクを作成して構成されます。 XDM フィールドを Dynamics 365 宛先フィールドに正しくマッピングするには、次の手順に従います。
-
Mapping の手順で、「Add new mapping」を選択します。 画面に新しいマッピング行が表示されます。
-
Select source field ウィンドウで、Select identity namespace カテゴリを選択し、
contactidを選択します。
-
Select target field ウィンドウで、ソースフィールドにマッピングするターゲットフィールドのタイプを選択します。
-
Select identity namespace:このオプションを選択して、ソースフィールドをリストから id 名前空間にマッピングします。
のターゲットマッピングを示すExperience Platform UI のスクリーンショット
-
XDM プロファイルスキーマと Dynamics 365 インスタンスの間に次のマッピングを追加します。
table 0-row-3 1-row-3 XDM プロファイルスキーマ Dynamics 365 Instance 必須 contactidcontactid○ -
Select custom attributes:このオプションを選択して、ソースフィールドを、Attribute name フィールドに定義するカスタム属性にマッピングします。 サポートされる属性の包括的なリストについては、Dynamics 365 ドキュメントを参照してください。
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 Instance person.name.firstNamefirstnameperson.name.lastNamelastnamepersonalEmail.addressemailaddress1 -
これらのマッピングの使用例を次に示します。
-
オーディエンスの書き出しのスケジュールと例 schedule-audience-export-example
アクティベーションワークフローの Schedule audience export の手順では、Experience Platform オーディエンスを Dynamics 365 のカスタムフィールド属性に手動でマッピングする必要があります。
これを行うには、各オーディエンスを選択し、対応するカスタムフィールド属性を Dynamics 365 から Mapping ID フィールドに入力します。
次に例を示します。
データの書き出しを検証する exported-data
宛先が正しく設定されていることを検証するには、次の手順に従います。
-
Destinations/Browse を選択して、宛先のリストに移動します。
-
宛先を選択し、ステータスが「enabled」であることを確認します。
-
「Activation data」タブに切り替えて、オーディエンス名を選択します。
-
オーディエンスの概要を監視し、プロファイルの数がオーディエンス内で作成された数と一致していることを確認します。
-
Dynamics 365 web サイトににログインして、Customers / Contacts ページに移動し、オーディエンスのプロファイルが追加されたかどうかを確認します。 Dynamics 365 の各オーディエンスステータスが、Mapping ID オーディエンスのスケジュール設定 手順で指定された 値に基づいて、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.
このエラーを修正するには、Mapping ID で指定したExperience Platform オーディエンスの Dynamics 365 が有効であり、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 月 | 初回リリース | 宛先の初回リリースとドキュメントの公開。 |