(API) Salesforce Marketing Cloud 連線

概觀 overview

(API) Salesforce Marketing Cloud (先前稱為 ExactTarget)是數位行銷套件,可讓您建置和自訂訪客和客戶的歷程,以個人化其體驗。

IMPORTANT
請注意此連線與其他連線之間的差異 Salesforce Marketing Cloud 連線 存在於電子郵件行銷目錄區段中的屬性。 另一個SalesforceMarketing Cloud連線可讓您將檔案匯出至指定的儲存位置,而此連線是以API為基礎的串流連線。

比較 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,您會將屬性新增至其中,如下所示:
SalesforceMarketing CloudUI資料設計工具。

檢視 Salesforce Marketing Cloud Email Data 屬性群組,其屬性對應至內的對象狀態 Email Demographics 資料擴充功能如下所示:
SalesforceMarketing CloudUI電子郵件資料屬性群組。

此 (API) Salesforce Marketing Cloud 目的地使用 Salesforce Marketing Cloud Search Attribute-Set Definitions REST API 以動態擷取在中定義的資料擴充功能及其連結屬性 Salesforce Marketing Cloud.

這些標籤會顯示在 目標欄位 選取視窗 對應 在工作流程中至 對目的地啟用對象.

IMPORTANT
範圍 Salesforce Marketing Cloud,您必須使用建立屬性 欄位名稱 完全符合中指定的值 對應ID 適用於每個已啟動的Platform區段。 例如,底下熒幕擷圖顯示名為的屬性 salesforce_mc_segment_1. 將對象啟用至此目的地時,新增 salesforce_mc_segment_1 作為 對應ID 將對象從Experience Platform填入此屬性中。

在中建立屬性的範例 Salesforce Marketing Cloud,如下所示:
顯示屬性的SalesforceMarketing CloudUI熒幕擷圖。

TIP
  • 建立屬性時,請勿在欄位名稱中包含空白字元。 請改用底線 (_) 分隔符號的字元。
  • 若要區分用於Platform對象的屬性以及內的其他屬性 Salesforce Marketing Cloud,您可以為用於Adobe區段的屬性包含可辨識的前置詞或後置詞。 例如,不使用 test_segment,使用 Adobe_test_segmenttest_segment_Adobe.
  • 如果您已在中建立其他屬性 Salesforce Marketing Cloud,您可以使用與平台區段相同的名稱,輕鬆識別中的對象 Salesforce Marketing Cloud.

在中指派使用者角色和許可權 Salesforce Marketing Cloud prerequisites-roles-permissions

作為 Salesforce Marketing Cloud 支援自訂角色根據您的使用案例,應指派相關角色給您的使用者,以更新您在 Salesforce Marketing Cloud. 指派給使用者的角色範例如下所示:
所選使用者的SalesforceMarketing CloudUI,其中顯示其獲指派的角色。

視您的角色而定 Salesforce Marketing Cloud 使用者已指派,您也需要指派許可權給 Salesforce Marketing Cloud 連結至您要更新之欄位的資料延伸模組。

由於此目的地需要存取 data extension,您必須允許這些事件。 例如, Email data extension 您需要允許,如下所示:

SalesforceMarketing CloudUI顯示具有允許許可權的電子郵件資料延伸模組。

若要限制存取層級,您也可以使用精細的許可權覆寫個別存取權。
SalesforceMarketing CloudUI顯示具有精細許可權的電子郵件資料延伸模組。

請參閱 Marketing Cloud RolesMarketing Cloud Roles and Permissions 詳細指引頁面。

彙總 Salesforce Marketing Cloud 認證 gather-credentials

在驗證之前,請記下以下專案 (API) Salesforce Marketing Cloud 目的地。

認證
說明
範例
子網域
另請參閱 Salesforce Marketing Cloud domain prefix 以瞭解如何從取得此值 Salesforce Marketing Cloud 介面。
若您的 Salesforce Marketing Cloud 網域為
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com
您需要提供 mcq4jrssqdlyc4lph19nnqgzzs84 做為值。
使用者端ID
請參閱 Salesforce Marketing Cloud 檔案 以瞭解如何從取得此值 Salesforce Marketing Cloud 介面。
r23kxxxxxxxx0z05xxxxxx
使用者端密碼
請參閱 Salesforce Marketing Cloud 檔案 以瞭解如何從取得此值 Salesforce Marketing Cloud 介面。
ipxxxxxxxxxxT4xxxxxxxxxx

護欄 guardrails

  • Salesforce強制特定 速率限制.

    • 請參閱 Salesforce Marketing Cloud 檔案 以解決您可能會遇到的任何限制,並減少執行期間的錯誤。
    • 請參閱 Salesforce Marketing Cloud 參與定價 頁面至 下載完整版比較表 以pdf格式顯示,詳細說明計畫所強加的限制。
    • API總覽 頁面詳細說明其他限制。
    • 參考 此處 用於整理這些詳細資料的頁面。
  • 計數 每個物件允許的自訂欄位 視您的Salesforce版本而定。

    • 請參閱 Salesforce 檔案 以取得其他指引。

    • 如果您已達到為定義的限制 每個物件允許的自訂欄位 範圍 Salesforce Marketing Cloud 您將需要

      • 在新增屬性之前移除較舊的屬性 Salesforce Marketing Cloud.
      • 在Platform目的地更新或移除任何啟用對象,這些對象會使用這些較舊的屬性名稱作為所提供的值 對應ID 期間為 對象排程 步驟。

支援的身分 supported-identities

(API) Salesforce Marketing Cloud 支援下表所述的身分啟用。 進一步瞭解 身分.

目標身分
說明
考量事項
contactKey
Salesforce Marketing Cloud 連絡人金鑰。 請參閱 Salesforce Marketing Cloud 檔案 如果您需要其他指引。
強制

支援的對象 supported-audiences

本節說明您可以將哪些型別的對象匯出至此目的地。

對象來源
支援
說明
Segmentation Service
✓ (A)
透過Experience Platform產生的對象 分段服務.
自訂上傳
X
受眾 已匯入 從CSV檔案Experience Platform為。

匯出型別和頻率 export-type-frequency

請參閱下表以取得目的地匯出型別和頻率的資訊。

項目
類型
附註
匯出型別
以設定檔為基礎
  • 您正在匯出區段的所有成員,以及所需的結構欄位 (例如:電子郵件地址、電話號碼、姓氏),根據您的欄位對應。
  • 中的每個區段狀態 Salesforce Marketing Cloud 會根據 對應ID 值期間提供 對象排程 步驟。
匯出頻率
串流
串流目的地是「一律開啟」的API型連線。 一旦根據對象評估在Experience Platform中更新了設定檔,聯結器就會將更新傳送至下游的目的地平台。 深入瞭解 串流目的地.

連線到目標 connect

IMPORTANT
若要連線到目的地,您需要 管理目的地 存取控制許可權. 閱讀 存取控制總覽 或聯絡您的產品管理員以取得必要許可權。

若要連線至此目的地,請遵循以下說明的步驟: 目的地設定教學課程. 在設定目標工作流程中,填寫以下兩個區段中列出的欄位。

範圍 目的地 > 目錄,搜尋 (API) Salesforce Marketing Cloud. 或者,您可以在 電子郵件行銷 類別。

驗證目標 authenticate

若要向目的地進行驗證,請填寫以下必填欄位並選取 連線到目的地. 請參閱 彙總 Salesforce Marketing Cloud 認證 區段以取得任何指引。

(API) Salesforce Marketing Cloud 目的地
Salesforce Marketing Cloud
子網域
您的 Salesforce Marketing Cloud 網域前置詞。
例如,如果您的網域為
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com
您需要提供 mcq4jrssqdlyc4lph19nnqgzzs84 做為值。
使用者端ID
您的 Salesforce Marketing Cloud Client ID.
使用者端密碼
您的 Salesforce Marketing Cloud Client Secret.

Platform UI熒幕擷圖顯示如何驗證SalesforceMarketing Cloud。

如果提供的詳細資料有效,UI會顯示 已連線 狀態,並顯示綠色核取記號,您就可以繼續進行下一個步驟。

填寫目標詳細資訊 destination-details

若要設定目的地的詳細資訊,請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。
顯示目的地詳細資訊的平台UI熒幕擷圖。

  • 名稱:您日後可辨識此目的地的名稱。
  • 說明:可協助您日後識別此目的地的說明。

啟用警示 enable-alerts

您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊,請參閱以下指南: 使用UI訂閱目的地警報.

當您完成提供目的地連線的詳細資訊時,請選取「 」 下一個.

啟動此目標的對象 activate

IMPORTANT
  • 若要啟用資料,您需要 檢視目的地啟用目的地檢視設定檔、和 檢視區段 存取控制許可權. 閱讀 存取控制總覽 或聯絡您的產品管理員以取得必要許可權。

  • 要匯出 身分,您需要 檢視身分圖表 存取控制許可權.

    img-md
    w-100 modal-image
    選取工作流程中反白顯示的身分名稱空間,以將對象啟用至目的地。

讀取 將設定檔和受眾啟用至串流受眾匯出目標 以取得啟用此目的地對象的指示。

對應考量事項和範例 mapping-considerations-example

若要正確將對象資料從Adobe Experience Platform傳送至 (API) Salesforce Marketing Cloud 目的地,您必須進行欄位對應步驟。 對應包括在Platform帳戶中的Experience Data Model (XDM)結構描述欄位與來自目標目的地的對應對應專案之間建立連結。

若要正確將XDM欄位對應至 (API) Salesforce Marketing Cloud 目的地欄位,請遵循下列步驟。

IMPORTANT
  • 雖然您的屬性名稱將根據 Salesforce Marketing Cloud 帳戶,兩者的對應 contactKeypersonalEmail.address 為必填欄位。

  • 與整合 Salesforce Marketing Cloud API受Experience Platform可從Salesforce擷取之屬性的分頁數限制。 這表示在 對應 步驟,目標欄位結構描述可以從您的Salesforce帳戶顯示最多2000個屬性。

  1. 對應 步驟,選取 新增對應. 您會在畫面上看到新的對應列。
    「新增對應」的平台UI熒幕擷圖範例。

  2. 選取來源欄位 視窗,選擇 選取屬性 類別並選取XDM屬性或選擇 選取身分名稱空間 並選取身分。

  3. 選取目標欄位 視窗,選擇 選取身分名稱空間 並選取身分或選擇 選取屬性 類別,並視需要從顯示的資料擴充功能中選取屬性。 此 (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 資料延伸。 -
    • 以下顯示使用這些對應的範例:

      顯示Target對應的平台UI熒幕擷取畫面範例。

當您完成提供目的地連線的對應時,請選取 下一個.

排程對象匯出和範例 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 如下所示:
顯示屬性的SalesforceMarketing CloudUI熒幕擷圖。

指示位置的 (API) Salesforce Marketing Cloud 對應ID 如下所示:
顯示排程對象匯出的平台UI熒幕擷取畫面範例。

如所示 (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

若要驗證您是否已正確設定目的地,請遵循下列步驟:

  1. 選取 目的地 > 瀏覽 以導覽至目的地清單。
    顯示瀏覽目的地的平台UI熒幕擷圖。

  2. 選取目的地並驗證狀態是否為 已啟用.
    顯示目的地資料流執行的平台UI熒幕擷取畫面。

  3. 切換至 Activation data 標籤,然後選取對象名稱。
    顯示目的地啟用資料的平台UI熒幕擷圖範例。

  4. 監控對象摘要,並確保設定檔計數對應於在區段內建立的計數。
    顯示區段的平台UI熒幕擷圖範例。

  5. 登入 Salesforce Marketing Cloud 網站。 然後導覽至 Audience Builder > Contact Builder > All contacts > Email 頁面,並檢查是否已新增對象中的設定檔。
    SalesforceMarketing CloudUI熒幕擷取畫面顯示「連絡人」頁面,其中包含區段中使用的設定檔。

  6. 若要檢查是否有任何設定檔已更新,請導覽至 電子郵件 頁面,並驗證對象的設定檔屬性值是否已更新。 如果成功,您可以在中看到每個受眾狀態 Salesforce Marketing Cloud 已根據「 」更新Platform中的對應對象狀態 對應ID 提供的值 對象排程 步驟。
    SalesforceMarketing CloudUI熒幕擷圖顯示已選取的「連絡人電子郵件」頁面,其中包含更新的對象狀態。

資料使用與控管 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.
    平台UI熒幕擷圖顯示錯誤。

    • 若要修正此錯誤,請確認 對應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...

其他資源 additional-resources

  • Salesforce Marketing Cloud API
  • Salesforce Marketing Cloud 檔案 說明如何使用指定的資訊來更新連絡人。

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 月 檔案更新
  • 我們已更新 (API) SalesforceMarketing Cloud的必要條件 區段和一般會移除檔案中屬性群組的不必要參照。
  • 更新說明檔案,指出應在中建立對象狀態的屬性 Salesforce Marketing Cloud 內部 Email Demographics 僅限資料延伸。
  • 我們已更新 對應考量事項和範例 區段,對應 Email Address 中的屬性 Email Addresses 資料延伸已標籤為強制,此要求已在標示為IMPORTANT的圖說文字中提及,但表格中省略。
2023 年 4 月 檔案更新
  • 我們已更正 (API) SalesforceMarketing Cloud的必要條件 區段以標示 Salesforce Marketing Cloud Engagement 是使用此目的地的必要訂閱。 區段先前錯誤地指出使用者需要訂閱Marketing Cloud 帳戶 參與以繼續。
  • 我們在「 」下新增了區段 必備條件角色與許可權 將指派給 Salesforce 讓此目的地正常運作的使用者。 (PLATIR-26299)
2023 年 2 月 檔案更新 我們已更新 (API) SalesforceMarketing Cloud的必要條件 區段,加入向外呼叫的參考連結 Salesforce Marketing Cloud Engagement 是使用此目的地的必要訂閱。
2023 年 2 月 功能更新 已修正目的地中不正確的設定導致將格式錯誤的JSON傳送至Salesforce的問題。 這會導致某些使用者在啟用時看到大量身分失敗。 (PLATIR-26299)
2023 年 1 月 檔案更新
  • 我們已更新 中的必要條件 Salesforce 區段來標註需要在上建立屬性 Salesforce 側。 本節現在包含如何執行此動作的詳細指示,以及命名中屬性的最佳作法 Salesforce. (PLATIR-25602)
  • 我們新增了明確指示,說明如何在中為每個已啟用的對象使用對應ID 對象排程 步驟。 (PLATIR-25602)
2022 年 10 月 首次發行 初始目的地版本和檔案發佈。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6