Microsoft Dynamics 365個連線
概觀 overview
Microsoft Dynamics 365是以雲端為基礎的業務應用程式平台，結合企業資源規劃(ERP)、客戶關係管理(CRM)以及生產力應用程式和AI工具，讓端對端的作業更順暢、控制更嚴密、增長潛力更大、成本更低。
此Adobe Experience Platform 目的地利用Contact Entity Reference API，可讓您將對象中的身分識別更新為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
請注意Dynamics 365中的下列必要條件，以便從Platform匯出資料至您的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 建立或編輯欄位（屬性）檔案。
寫下您在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欄位值 組織57771b33。
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限制。 您必須確保資料與承載皆符合這些限制。
支援的身分 supported-identities
Dynamics 365支援下表中描述的身分更新。 深入瞭解身分。
支援的對象 supported-audiences
本節說明您可以匯出至此目的地的所有對象。
此目的地支援啟動所有透過Experience Platform細分服務產生的對象。
匯出型別和頻率 export-type-frequency
請參閱下表以取得目的地匯出型別和頻率的資訊。
- 您正在匯出對象的所有成員，以及所需的結構描述欄位 （例如：電子郵件地址、電話號碼、姓氏） （根據您的欄位對應）。
- 根據對象排程步驟期間提供的 對應ID 值，Dynamics 365中的每個對象狀態都會以來自平台的對應對象狀態更新。
連線到目標 connect
若要連線到此目的地，請依照目的地組態教學課程中所述的步驟進行。 在設定目標工作流程中，填寫以下兩個區段中列出的欄位。
在 目的地 > 目錄 內，搜尋Dynamics 365。 或者，您可以在 CRM 類別下找到它。
驗證目標 authenticate
若要驗證到目的地，請選取 連線到目的地。
填寫以下必填欄位。 如需任何指引，請參閱收集Dynamics 365認證區段。
- 使用者端識別碼： Azure Active Directory應用程式的Dynamics 365使用者端識別碼。
- 租使用者識別碼：您Azure Active Directory應用程式的Dynamics 365租使用者識別碼。
- 使用者端密碼：您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中欄位旁的星號表示該欄位為必填欄位。
- 名稱：您日後可辨識此目的地的名稱。
- 描述：可協助您日後識別此目的地的描述。
- 自訂字首：您在Dynamics 365中建立的自訂欄位
Customization prefix。 如需詳細資訊，請參閱Dynamics 365檔案的建立及編輯欄位區段。
啟用警示 enable-alerts
您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊，請參閱使用UI訂閱目的地警示的指南。
當您完成提供目的地連線的詳細資訊後，請選取 下一步。
啟動此目標的對象 activate
閱讀將設定檔和對象啟用至串流對象匯出目的地，以瞭解啟用此目的地對象的指示。
對應考量事項和範例 mapping-considerations-example
若要將對象資料從Adobe Experience Platform正確傳送至Dynamics 365目的地，您必須完成欄位對應步驟。 對應包括在Platform帳戶中的Experience Data Model (XDM)結構描述欄位與來自目標目的地的對應對應專案之間建立連結。 若要將您的XDM欄位正確對應到Dynamics 365目的地欄位，請遵循下列步驟：
-
在 對應 步驟中，選取 新增對應。 您會在畫面上看到新的對應列。
-
在 選取來源欄位 視窗中，選擇 選取身分名稱空間 類別並選取
contactid。
-
在 選取目標欄位 視窗中，選取您要將來源欄位對應到的目標欄位型別。
-
選取身分名稱空間：選取此選項可將您的來源欄位從清單對應至身分名稱空間。
-
在您的XDM設定檔結構描述與Dynamics 365執行個體之間新增下列對應：
|XDM設定檔結構描述|Dynamics 365執行個體| 必填|
|—|—|—|
|contactid|contactid| 是 | -
選取自訂屬性：選取此選項可將您的來源欄位對應到您在 屬性名稱 欄位中定義的自訂屬性。 如需支援屬性的完整清單，請參閱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執行個體之間新增下列對應：
|XDM設定檔結構描述|Dynamics 365執行個體|
|—|—|
|person.name.firstName|firstname|
|person.name.lastName|lastname|
|personalEmail.address|emailaddress1| -
以下顯示使用這些對應的範例：
-
排程對象匯出和範例 schedule-audience-export-example
在啟動工作流程的排程對象匯出步驟中，您必須手動將Platform對象對應到Dynamics 365中的自訂欄位屬性。
若要這麼做，請選取每個對象，然後在 對應ID 欄位中，從Dynamics 365輸入對應的自訂欄位屬性。
範例如下：
驗證資料匯出 exported-data
若要驗證您是否已正確設定目的地，請遵循下列步驟：
-
選取 目的地 > 瀏覽 以瀏覽目的地清單。
-
選取目的地並驗證狀態為 已啟用。
-
切換至 Activation data 標籤，然後選取對象名稱。
-
監控對象摘要，並確保設定檔計數對應於在對象內建立的計數。
-
登入Dynamics 365網站，然後導覽至Customers > Contacts頁面，並檢查是否已新增對象的設定檔。 您可以看到根據對象排程步驟期間提供的 對應ID 值，Dynamics 365中的每個對象狀態已更新為來自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.
若要修正此錯誤，請確認您在Dynamics 365中為您的Platform對象提供的 對應ID 有效且存在於Dynamics 365內。
其他資源 additional-resources
Dynamics 365 檔案的其他實用資訊如下：
Changelog
本節擷取此目的地聯結器的功能和重要檔案更新。