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 建立或編輯欄位(屬性)檔案。
寫下您在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 ID
ababbaba-abab-baba-acac-acacacacacac
Client Secret
abcde~abcdefghijklmnopqrstuvwxyz12345678
作為指引。Tenant ID
1234567-aaaa-12ab-ba21-1234567890
Region
請參閱Dynamics 365 檔案以取得指引。
進行驗證時,您需要在下拉式選取器中提供醒目提示的CRM欄位值 組織57771b33。
crm
.dynamics.com例如:如果您的公司已布建在北美(NAM)地區,則您的URL會是
crm.dynamics.com
,而且您必須選取crm
。 如果您的公司已布建在加拿大(CAN)地區,則您的URL會是crm3.dynamics.com
,您需要選取crm3
。Environment URL
org57771b33
.crm.dynamics.com護欄 guardrails
要求限制和配置頁面詳細說明與您的Dynamics 365授權相關的Dynamics 365 API限制。 您必須確保資料與承載皆符合這些限制。
支援的身分 supported-identities
Dynamics 365支援下表中描述的身分更新。 深入瞭解身分。
支援的對象 supported-audiences
本節說明您可以匯出至此目的地的所有對象。
此目的地支援啟用所有透過Experience Platform 細分服務產生的對象。
匯出型別和頻率 export-type-frequency
請參閱下表以取得目的地匯出型別和頻率的資訊。
- 您正在匯出對象的所有成員,以及所需的結構描述欄位 (例如:電子郵件地址、電話號碼、姓氏) (根據您的欄位對應)。
- 根據對象排程步驟期間提供的 對應ID 值,Dynamics 365中的每個對象狀態都會以來自Experience Platform的對應對象狀態更新。
連線到目標 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目的地,您必須完成欄位對應步驟。 對應包括在Experience Platform帳戶中的Experience Data Model (XDM)結構描述欄位與來自目標目的地的對應對應專案之間建立連結。 若要將您的XDM欄位正確對應到Dynamics 365目的地欄位,請遵循下列步驟:
-
在 對應 步驟中,選取 新增對應。 您會在畫面上看到新的對應列。
-
在 選取來源欄位 視窗中,選擇 選取身分名稱空間 類別並選取
contactid
。
-
在 選取目標欄位 視窗中,選取您要將來源欄位對應到的目標欄位型別。
-
選取身分名稱空間:選取此選項可將您的來源欄位從清單對應至身分名稱空間。
-
在您的XDM設定檔結構描述與Dynamics 365執行個體之間新增下列對應:
table 0-row-3 1-row-3 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執行個體之間新增下列對應:
table 0-row-2 1-row-2 2-row-2 3-row-2 XDM設定檔結構描述 Dynamics 365執行個體 person.name.firstName
firstname
person.name.lastName
lastname
personalEmail.address
emailaddress1
-
以下顯示使用這些對應的範例:
-
排程對象匯出和範例 schedule-audience-export-example
在啟動工作流程的排程對象匯出步驟中,您必須手動將Experience Platform對象對應到Dynamics 365中的自訂欄位屬性。
若要這麼做,請選取每個對象,然後在 對應ID 欄位中,從Dynamics 365輸入對應的自訂欄位屬性。
範例如下:
驗證資料匯出 exported-data
若要驗證您是否已正確設定目的地,請遵循下列步驟:
-
選取 目的地 > 瀏覽 以瀏覽目的地清單。
-
選取目的地並驗證狀態為 已啟用。
-
切換至 Activation data 標籤,然後選取對象名稱。
-
監控對象摘要,並確保設定檔計數對應於在對象內建立的計數。
-
登入Dynamics 365網站,然後導覽至Customers > Contacts頁面,並檢查是否已新增對象的設定檔。 您可以看到根據對象排程步驟期間提供的 對應ID 值,Dynamics 365中的每個對象狀態已更新為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.
若要修正此錯誤,請確認您在Dynamics 365中為Experience Platform對象提供的 對應ID 有效且存在於Dynamics 365中。
其他資源 additional-resources
Dynamics 365 檔案的其他實用資訊如下:
Changelog
本節擷取此目的地聯結器的功能和重要檔案更新。