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 内の設定例を次に示します。
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 ドキュメント を参照してください。
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
この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。
このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。
- カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
- 類似オーディエンス,
- 連合オーディエンス,
- Adobe Journey Optimizerなどの他の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名前空間にマッピングするには、このオプションを選択します。
-
XDM プロファイルスキーマとDynamics 365 インスタンスの間に次のマッピングを追加します。
table 0-row-3 1-row-3 XDM プロファイルスキーマ Dynamics 365 インスタンス 必須 contactidcontactid○ -
Select custom attributes: ソースフィールドをAttribute name フィールドで定義したカスタム属性にマッピングするには、このオプションを選択します。 サポートされる属性の包括的なリストについては、Dynamics 365 ドキュメント を参照してください。
メールのTarget マッピングを示す
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.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 ドキュメントからのその他の役に立つ情報は次のとおりです。
変更ログ 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月 | 初回リリース | 最初の宛先リリースとドキュメントの公開。 |