(API) Salesforce Marketing Cloud 連線
概觀 overview
(API) Salesforce Marketing Cloud (先前稱為 ExactTarget)是數位行銷套件,可讓您建置和自訂訪客和客戶的歷程,以個人化其體驗。
比較 Salesforce Marketing Cloud Account Engagement 更傾向於 B2B 行銷, (API) Salesforce Marketing Cloud 目的地適合 B2C 具有較短異動決策週期的使用案例。 您可以合併代表目標受眾行為的較大資料集,以調整及改善行銷活動,方法是優先順序並劃分聯絡人(尤其是來自外部資料集的聯絡人) Salesforce. 請注意,Experience Platform也有 Salesforce Marketing Cloud Account Engagement.
這個 Adobe Experience Platform 目的地 使用 Salesforce Marketing Cloud 更新連絡人 API,可讓您 新增聯絡人並更新聯絡人資料 在新的網站中啟用後,即可滿足您的業務需求 Salesforce Marketing Cloud 區段。
Salesforce Marketing Cloud 使用具有使用者端憑證的OAuth 2作為驗證機制,與 Salesforce Marketing Cloud API。 向您的驗證指示 Salesforce Marketing Cloud 執行個體的詳細資訊如下: 驗證到目的地 區段。
使用案例 use-cases
為了協助您更清楚瞭解您應如何及何時使用 (API) Salesforce Marketing Cloud 目的地,以下是Adobe Experience Platform客戶可以使用此目的地解決的範例使用案例。
傳送電子郵件給行銷活動的連絡人 use-case-send-emails
家用出租平台的銷售部門想要廣播行銷電子郵件給目標客戶對象。 平台的行銷團隊可以新增聯絡人/更新現有的聯絡人 (及其電子郵件地址) 透過Adobe Experience Platform,從對象的離線資料建立對象,並將這些對象傳送至 Salesforce Marketing Cloud,然後可用於傳送行銷活動電子郵件。
先決條件 prerequisites
Experience Platform的必要條件 prerequisites-in-experience-platform
在將資料啟用至 (API) Salesforce Marketing Cloud 目的地,您必須擁有 綱要, a 資料集、和 區段 建立於 Experience Platform.
中的必要條件 (API) Salesforce Marketing Cloud prerequisites-destination
若要將資料從Platform匯出至您的 Salesforce Marketing Cloud 帳戶:
您需要擁有 Salesforce Marketing Cloud 帳戶 prerequisites-account
A Salesforce Marketing Cloud 訂閱的帳戶 Marketing Cloud Engagement 產品必須執行才能繼續。
請聯絡 Salesforce 支援 如果您沒有 Salesforce Marketing Cloud 帳戶或您的帳戶缺少 Marketing Cloud Engagement 產品訂閱。
在中建立屬性 Salesforce Marketing Cloud prerequisites-attribute
將對象啟用至 (API) Salesforce Marketing Cloud 目的地,您必須在 對應ID 欄位中針對每個已啟用的對象, 對象排程 步驟。
Salesforce 需要此值才能正確讀取和解讀來自Experience Platform的受眾,並在中更新其受眾狀態 Salesforce Marketing Cloud. 請參閱Experience Platform檔案以瞭解 對象成員資格詳細資料結構欄位群組 如果您需要對象狀態的指引。
針對您從Platform啟用的每個對象,設定為 Salesforce,您必須擁有型別的屬性 Text
連結至 Email Demographics 中的資料延伸模組 Salesforce Marketing Cloud. 使用 Salesforce Marketing Cloud Contact Builder 以建立屬性。 請參閱 Salesforce Marketing Cloud 檔案至 建立屬性 如果您需要有關建立屬性的指引。
屬性欄位名稱用於 (API) Salesforce Marketing Cloud 期間的目標欄位 對應 步驟。 您可以根據業務需求定義最多4000個字元的欄位字元。 請參閱 Salesforce Marketing Cloud 資料擴充功能資料型別 檔案頁面,以取得屬性型別的詳細資訊。
中的資料設計工具畫面範例 Salesforce Marketing Cloud,您會將屬性新增至其中,如下所示:
檢視 Salesforce Marketing Cloud Email Data 屬性群組,其屬性對應至內的對象狀態 Email Demographics 資料擴充功能如下所示:
此 (API) Salesforce Marketing Cloud 目的地使用 Salesforce Marketing Cloud Search Attribute-Set Definitions REST API 以動態擷取在中定義的資料擴充功能及其連結屬性 Salesforce Marketing Cloud.
這些標籤會顯示在 目標欄位 選取視窗 對應 在工作流程中至 對目的地啟用對象.
salesforce_mc_segment_1
. 將對象啟用至此目的地時,新增 salesforce_mc_segment_1
作為 對應ID 將對象從Experience Platform填入此屬性中。在中建立屬性的範例 Salesforce Marketing Cloud,如下所示:
- 建立屬性時,請勿在欄位名稱中包含空白字元。 請改用底線
(_)
分隔符號的字元。 - 若要區分用於Platform對象的屬性以及內的其他屬性 Salesforce Marketing Cloud,您可以為用於Adobe區段的屬性包含可辨識的前置詞或後置詞。 例如,不使用
test_segment
,使用Adobe_test_segment
或test_segment_Adobe
. - 如果您已在中建立其他屬性 Salesforce Marketing Cloud,您可以使用與平台區段相同的名稱,輕鬆識別中的對象 Salesforce Marketing Cloud.
在中指派使用者角色和許可權 Salesforce Marketing Cloud prerequisites-roles-permissions
作為 Salesforce Marketing Cloud 支援自訂角色根據您的使用案例,應指派相關角色給您的使用者,以更新您在 Salesforce Marketing Cloud. 指派給使用者的角色範例如下所示:
視您的角色而定 Salesforce Marketing Cloud 使用者已指派,您也需要指派許可權給 Salesforce Marketing Cloud 連結至您要更新之欄位的資料延伸模組。
由於此目的地需要存取 data extension
,您必須允許這些事件。 例如, Email
data extension 您需要允許,如下所示:
若要限制存取層級,您也可以使用精細的許可權覆寫個別存取權。
請參閱 Marketing Cloud Roles 和 Marketing Cloud Roles and Permissions 詳細指引頁面。
彙總 Salesforce Marketing Cloud 認證 gather-credentials
在驗證之前,請記下以下專案 (API) Salesforce Marketing Cloud 目的地。
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,您需要提供
mcq4jrssqdlyc4lph19nnqgzzs84
做為值。護欄 guardrails
-
Salesforce強制特定 速率限制.
- 請參閱 Salesforce Marketing Cloud 檔案 以解決您可能會遇到的任何限制,並減少執行期間的錯誤。
- 請參閱 Salesforce Marketing Cloud 參與定價 頁面至 下載完整版比較表 以pdf格式顯示,詳細說明計畫所強加的限制。
- 此 API總覽 頁面詳細說明其他限制。
- 參考 此處 用於整理這些詳細資料的頁面。
-
計數 每個物件允許的自訂欄位 視您的Salesforce版本而定。
支援的身分 supported-identities
(API) Salesforce Marketing Cloud 支援下表所述的身分啟用。 進一步瞭解 身分.
支援的對象 supported-audiences
本節說明您可以將哪些型別的對象匯出至此目的地。
匯出型別和頻率 export-type-frequency
請參閱下表以取得目的地匯出型別和頻率的資訊。
- 您正在匯出區段的所有成員,以及所需的結構欄位 (例如:電子郵件地址、電話號碼、姓氏),根據您的欄位對應。
- 中的每個區段狀態 Salesforce Marketing Cloud 會根據 對應ID 值期間提供 對象排程 步驟。
連線到目標 connect
若要連線至此目的地,請遵循以下說明的步驟: 目的地設定教學課程. 在設定目標工作流程中,填寫以下兩個區段中列出的欄位。
範圍 目的地 > 目錄,搜尋 (API) Salesforce Marketing Cloud. 或者,您可以在 電子郵件行銷 類別。
驗證目標 authenticate
若要向目的地進行驗證,請填寫以下必填欄位並選取 連線到目的地. 請參閱 彙總 Salesforce Marketing Cloud 認證 區段以取得任何指引。
例如,如果您的網域為
mcq4jrssqdlyc4lph19nnqgzzs84
.login.exacttarget.com,您需要提供
mcq4jrssqdlyc4lph19nnqgzzs84
做為值。Client ID
.Client Secret
.
如果提供的詳細資料有效,UI會顯示 已連線 狀態,並顯示綠色核取記號,您就可以繼續進行下一個步驟。
填寫目標詳細資訊 destination-details
若要設定目的地的詳細資訊,請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。
- 名稱:您日後可辨識此目的地的名稱。
- 說明:可協助您日後識別此目的地的說明。
啟用警示 enable-alerts
您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊,請參閱以下指南: 使用UI訂閱目的地警報.
當您完成提供目的地連線的詳細資訊時,請選取「 」 下一個.
啟動此目標的對象 activate
讀取 將設定檔和受眾啟用至串流受眾匯出目標 以取得啟用此目的地對象的指示。
對應考量事項和範例 mapping-considerations-example
若要正確將對象資料從Adobe Experience Platform傳送至 (API) Salesforce Marketing Cloud 目的地,您必須進行欄位對應步驟。 對應包括在Platform帳戶中的Experience Data Model (XDM)結構描述欄位與來自目標目的地的對應對應專案之間建立連結。
若要正確將XDM欄位對應至 (API) Salesforce Marketing Cloud 目的地欄位,請遵循下列步驟。
-
雖然您的屬性名稱將根據 Salesforce Marketing Cloud 帳戶,兩者的對應
contactKey
和personalEmail.address
為必填欄位。 -
與整合 Salesforce Marketing Cloud API受Experience Platform可從Salesforce擷取之屬性的分頁數限制。 這表示在 對應 步驟,目標欄位結構描述可以從您的Salesforce帳戶顯示最多2000個屬性。
-
在 對應 步驟,選取 新增對應. 您會在畫面上看到新的對應列。
-
在 選取來源欄位 視窗,選擇 選取屬性 類別並選取XDM屬性或選擇 選取身分名稱空間 並選取身分。
-
在 選取目標欄位 視窗,選擇 選取身分名稱空間 並選取身分或選擇 選取屬性 類別,並視需要從顯示的資料擴充功能中選取屬性。 此 (API) Salesforce Marketing Cloud 目的地使用 Salesforce Marketing Cloud Search Attribute-Set Definitions REST API 以動態擷取在中定義的資料擴充功能及其連結屬性 Salesforce Marketing Cloud. 這些標籤會顯示在 目標欄位 當您設定 對應 在 啟用受眾工作流程.
-
重複這些步驟,在您的XDM設定檔結構描述之間新增下列對應,並 (API) Salesforce Marketing Cloud:
table 0-row-3 1-row-3 2-row-3 3-row-3 來源欄位 目標欄位 強制 IdentityMap: contactKey
Identity: salesforceContactKey
Mandatory
xdm: personalEmail.address
Attribute: Email Address
從 Salesforce Marketing Cloud Email Addresses 資料延伸。Mandatory
,新增連絡人時。xdm: person.name.firstName
Attribute: First Name
從所需 Salesforce Marketing Cloud 資料延伸。- -
以下顯示使用這些對應的範例:
-
當您完成提供目的地連線的對應時,請選取 下一個.
排程對象匯出和範例 schedule-segment-export-example
執行 排程對象匯出 步驟,您必須手動將平台對象對應至 屬性 在 Salesforce Marketing Cloud.
若要這麼做,請選取每個區段,然後輸入屬性名稱,從 Salesforce Marketing Cloud 在 (API) Salesforce Marketing Cloud 對應ID 欄位。 請參閱 在中建立屬性 Salesforce Marketing Cloud 區段,瞭解在中建立屬性的相關指引和最佳作法 Salesforce Marketing Cloud.
例如,如果您的 Salesforce Marketing Cloud 屬性為 salesforce_mc_segment_1
,請在 (API) Salesforce Marketing Cloud 對應ID 將對象從Experience Platform填入此屬性中。
範例屬性來自 Salesforce Marketing Cloud 如下所示:
指示位置的 (API) Salesforce Marketing Cloud 對應ID 如下所示:
如所示 (API) Salesforce Marketing Cloud 對應ID 應該完全符合中指定的值 Salesforce Marketing Cloud 欄位名稱.
對每個已啟動的Platform區段重複此章節。
以上圖影像為基礎的典型範例可能是。
| (API) Salesforce Marketing Cloud 區段名稱 | Salesforce Marketing Cloud 欄位名稱 | (API) Salesforce Marketing Cloud 對應ID | | — | — | — | | salesforce mc audience 1 | salesforce_mc_segment_1
| salesforce_mc_segment_1
| | salesforce mc audience 2 | salesforce_mc_segment_2
| salesforce_mc_segment_2
|
驗證資料匯出 exported-data
若要驗證您是否已正確設定目的地,請遵循下列步驟:
-
選取 目的地 > 瀏覽 以導覽至目的地清單。
-
選取目的地並驗證狀態是否為 已啟用.
-
切換至 Activation data 標籤,然後選取對象名稱。
-
監控對象摘要,並確保設定檔計數對應於在區段內建立的計數。
-
登入 Salesforce Marketing Cloud 網站。 然後導覽至 Audience Builder > Contact Builder > All contacts > Email 頁面,並檢查是否已新增對象中的設定檔。
-
若要檢查是否有任何設定檔已更新,請導覽至 電子郵件 頁面,並驗證對象的設定檔屬性值是否已更新。 如果成功,您可以在中看到每個受眾狀態 Salesforce Marketing Cloud 已根據「 」更新Platform中的對應對象狀態 對應ID 提供的值 對象排程 步驟。
資料使用與控管 data-usage-governance
全部 Adobe Experience Platform 處理您的資料時,目的地符合資料使用原則。 如需如何操作的詳細資訊 Adobe Experience Platform 強制執行資料控管,請參閱 資料控管概觀.
錯誤與疑難排解 errors-and-troubleshooting
將事件推送到SalesforceMarketing Cloud時遇到未知錯誤 unknown-errors
-
檢查資料流執行時,您可能會遇到下列錯誤訊息:
Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
- 若要修正此錯誤,請確認 對應ID 您在啟動工作流程中提供的資料給 (API) Salesforce Marketing Cloud 目的地與您在中建立的屬性名稱完全相符 Salesforce Marketing Cloud. 請參閱 在中建立屬性 Salesforce Marketing Cloud 區段以取得指引。
-
啟用區段時,您可能會收到錯誤訊息:
The client's IP address is unauthorized for this account. Allowlist the client's IP address...
- 若要修正此錯誤,請連絡您的 Salesforce Marketing Cloud 要新增的帳戶管理員 Experience PlatformIP位址 至您的 Salesforce Marketing Cloud 帳戶的受信任IP範圍。 請參閱 Salesforce Marketing Cloud 要包含在Marketing Cloud允許清單中的IP位址 說明檔案(若您需要其他指引)。
其他資源 additional-resources
Changelog changelog
本節擷取此目的地聯結器的功能和重要檔案更新。
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto | ||
---|---|---|
發行月份 | 更新型別 | 說明 |
2023 年 10 月 | 檔案更新 |
|
2023 年 4 月 | 檔案更新 |
|
2023 年 2 月 | 檔案更新 | 我們已更新 (API) SalesforceMarketing Cloud的必要條件 區段,加入向外呼叫的參考連結 Salesforce Marketing Cloud Engagement 是使用此目的地的必要訂閱。 |
2023 年 2 月 | 功能更新 | 已修正目的地中不正確的設定導致將格式錯誤的JSON傳送至Salesforce的問題。 這會導致某些使用者在啟用時看到大量身分失敗。 (PLATIR-26299) |
2023 年 1 月 | 檔案更新 |
|
2022 年 10 月 | 首次發行 | 初始目的地版本和檔案發佈。 |