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中的下列必要條件,以便從Experience 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 建立或編輯欄位(屬性)檔案。
寫下您在 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欄位值 組織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
請參閱下表以取得目的地匯出型別和頻率的資訊。
- 您正在匯出對象的所有成員,以及所需的結構描述欄位(例如:電子郵件地址、電話號碼、姓氏) (根據您的欄位對應)。
- 根據Dynamics 365對象排程 Mapping ID 步驟期間提供的值,中的每個對象狀態都會根據Experience Platform以對應的對象狀態更新。
- 串流目的地是「一律開啟」的API型連線。 根據對象評估在Experience Platform中更新設定檔後,聯結器會立即將更新傳送至下游的目標平台。 深入瞭解串流目的地。
連線到目標 connect
若要連線到此目的地,請依照目的地組態教學課程中所述的步驟進行。 在設定目標工作流程中,填寫以下兩個區段中列出的欄位。
在Destinations > Catalog內搜尋Dynamics 365。 或者,您可以在 CRM 類別下找到它。
驗證目標 authenticate
若要驗證到目的地,請選取Connect to destination。
填寫以下必填欄位。 如需任何指引,請參閱收集Dynamics 365認證區段。
- Client ID:您Dynamics 365應用程式的Azure Active Directory使用者端識別碼。
- Tenant ID:您Dynamics 365應用程式的Azure Active Directory租使用者識別碼。
- 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
閱讀將設定檔和對象啟用至串流對象匯出目的地,以瞭解啟用此目的地對象的指示。
對應考量事項和範例 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:選取此選項,從清單將您的來源欄位對應到身分名稱空間。
-
在您的XDM設定檔結構描述與Dynamics 365執行個體之間新增下列對應:
table 0-row-3 1-row-3 XDM設定檔結構描述 Dynamics 365執行個體 強制 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執行個體 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網站,然後導覽至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
本節擷取此目的地聯結器的功能和重要檔案更新。