文件Experience Platform目的地指南

(API) Salesforce Marketing Cloud 連線

Last update: Wed Oct 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 管理員
  • 使用者

概觀 overview

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

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

相較於更面向Salesforce Marketing Cloud Account EngagementB2B 行銷的，(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目的地之前，您必須在中建立結構描述、資料集和區段Experience Platform。

(API) Salesforce Marketing Cloud中的必要條件 prerequisites-destination

若要將資料從Experience Platform匯出至您的Salesforce Marketing Cloud帳戶，請注意下列必要條件：

您必須擁有Salesforce Marketing Cloud帳戶 prerequisites-account

必須有一個訂閱Salesforce Marketing CloudMarketing Cloud Engagement產品的帳戶才能繼續。

如果您沒有Salesforce 帳戶或帳戶缺少產品訂閱，請連絡Salesforce Marketing Cloud支援Marketing Cloud Engagement。

在Salesforce Marketing Cloud中建立屬性 prerequisites-attribute

將對象啟用至(API) Salesforce Marketing Cloud目的地時，您必須在​ Mapping ID ​對象排程​ 步驟中，為每個已啟用的對象在 ​欄位中輸入值。

Salesforce需要此值才能正確讀取和解讀來自Experience Platform的對象，並在Salesforce Marketing Cloud內更新其對象狀態。 如果您需要對象狀態的指引，請參閱對象成員資格詳細資料結構描述欄位群組的Experience Platform檔案。

對於您從Experience Platform啟動至Salesforce的每個對象，您必須在Text內將型別Email Demographics的屬性連結至Salesforce Marketing Cloud資料延伸模組。 使用Salesforce Marketing Cloud Contact Builder建立屬性。 如需建立屬性的相關指引，請參閱Salesforce Marketing Cloud檔案，以便建立屬性。

在(API) Salesforce Marketing Cloud步驟期間，Mapping​目標欄位會使用屬性欄位名稱。 您可以根據業務需求定義最多4000個字元的欄位字元。 如需屬性型別的其他資訊，請參閱Salesforce Marketing Cloud 資料延伸模組資料型別檔案頁面。

Salesforce Marketing Cloud中的資料設計工具畫面範例顯示如下，您將在其中新增屬性：
Salesforce Marketing Cloud UI資料設計工具。

Salesforce Marketing Cloud Email Data屬性群組的檢視具有對應至Email Demographics資料延伸內對象狀態的屬性，如下所示：
Salesforce Marketing Cloud UI電子郵件資料屬性群組。

(API) Salesforce Marketing Cloud目的地使用Salesforce Marketing Cloud Search Attribute-Set Definitions REST API來動態擷取Salesforce Marketing Cloud中定義的資料延伸及其連結屬性。

當您在工作流程中設定​ Target field ​對應至啟用對象到目的地時，這些會顯示在選取視窗中。

IMPORTANT
在Salesforce Marketing Cloud內，您必須針對每個已啟動的Experience Platform區段，以​ FIELD NAME ​建立與​ Mapping ID ​內所指定值完全相符的屬性。 例如，底下熒幕擷圖顯示名為salesforce_mc_segment_1的屬性。 啟用此目的地的對象時，請新增salesforce_mc_segment_1做為​ Mapping ID ​以將對象從Experience Platform填入此屬性中。

在Salesforce Marketing Cloud中建立屬性的範例顯示如下：
Salesforce Marketing Cloud UI熒幕擷圖顯示屬性。

TIP
  • 建立屬性時，請勿在欄位名稱中包含空白字元。 請改用底線(_)字元做為分隔符號。
  • 若要區分用於Experience Platform對象的屬性和Salesforce Marketing Cloud內的其他屬性，您可以包含用於Adobe區段之屬性的可辨識首碼或尾碼。 例如，使用test_segment或Adobe_test_segment代替test_segment_Adobe。
  • 如果您已在Salesforce Marketing Cloud中建立其他屬性，您可以使用與Experience Platform區段相同的名稱，輕鬆識別Salesforce Marketing Cloud中的對象。

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

由於Salesforce Marketing Cloud支援自訂角色（視您的使用案例而定），因此應指派相關角色給您的使用者，以更新Salesforce Marketing Cloud中的屬性。 指派給使用者的角色範例如下所示：
已選取使用者的Salesforce Marketing Cloud UI，顯示其指派的角色。

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

由於此目的地需要存取data extension，因此您需要允許他們。 例如，您需要允許的Email data extension如下所示：

Salesforce Marketing Cloud UI顯示具有允許許可權的電子郵件資料延伸模組。

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

如需詳細指引，請參閱Marketing Cloud Roles及Marketing 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中新增屬性之前，請先移除較舊的屬性。
      • 在Experience Platform目的地更新或移除任何已啟用的對象，這些對象使用這些較舊的屬性名稱作為​ Mapping ID ​對象排程步驟期間為提供的值。

支援的身分 supported-identities

(API) Salesforce Marketing Cloud支援下表所述的身分啟用。 深入瞭解身分。

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

支援的對象 supported-audiences

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

對象來源
支援
說明
Segmentation Service
✓
透過Experience Platform 細分服務產生的對象。
自訂上傳
X
對象從CSV檔案匯入至Experience Platform。

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

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

項目
類型
附註
匯出類型
Profile-based
  • 您正在匯出區段的所有成員，以及所需的結構描述欄位​（例如：電子郵件地址、電話號碼、姓氏） （根據您的欄位對應）。
  • 根據Salesforce Marketing Cloud對象排程​ Mapping ID ​步驟期間提供的值，中的每個區段狀態都會以Experience Platform中對應的對象狀態更新。
匯出頻率
Streaming
串流目的地是「一律開啟」的API型連線。 根據對象評估在Experience Platform中更新設定檔後，聯結器會立即將更新傳送至下游的目標平台。 深入瞭解串流目的地。

連線到目標 connect

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

若要連線到此目的地，請依照目的地組態教學課程中所述的步驟進行。 在設定目標工作流程中，填寫以下兩個區段中列出的欄位。

在​Destinations > Catalog​內，搜尋(API) Salesforce Marketing Cloud。 或者，您可以在​ Email marketing ​類別下找到它。

驗證目標 authenticate

若要驗證到目的地，請填寫以下必填欄位並選取​Connect to destination。 如需任何指引，請參閱收集 Salesforce Marketing Cloud 認證區段。

(API) Salesforce Marketing Cloud目標
Salesforce Marketing Cloud
Subdomain
您的Salesforce Marketing Cloud網域前置詞。
例如，如果您的網域是
mcq4jrssqdlyc4lph19nnqgzzs84.login.exacttarget.com，
您必須提供mcq4jrssqdlyc4lph19nnqgzzs84做為值。
Client ID
您的Salesforce Marketing Cloud Client ID。
Client Secret
您的Salesforce Marketing Cloud Client Secret。

Experience Platform UI熒幕擷圖顯示如何驗證Salesforce Marketing Cloud。

如果提供的詳細資料有效，UI會顯示帶有綠色勾號的​ Connected ​狀態，然後您可以繼續下一個步驟。

填寫目標詳細資料 destination-details

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

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

啟用警示 enable-alerts

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

當您完成提供目的地連線的詳細資訊時，請選取​Next。

啟動此目標的對象 activate

IMPORTANT
  • 若要啟用資料，您需要​View Destinations、Activate Destinations、View Profiles​和​View Segments 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。
  • 若要匯出​身分，您需要​View Identity Graph 存取控制許可權。
    選取工作流程中反白的身分名稱空間，以啟用目的地的對象。 {width="100" modal="regular"}

閱讀將設定檔和對象啟用至串流對象匯出目的地，以瞭解啟用此目的地對象的指示。

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

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

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

IMPORTANT

  • 雖然您的屬性名稱會依據您的Salesforce Marketing Cloud帳戶而定，但contactKey和personalEmail.address的對映是必要的。

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

  1. 在​ Mapping ​步驟中，選取​Add new mapping。 您會在畫面上看到新的對應列。
    新增對應之Experience Platform UI熒幕擷圖範例。

  2. 在​ Select source field ​視窗中，選擇​ Select attributes ​類別並選取XDM屬性，或選擇​ Select identity namespace ​並選取身分。

  3. 在​ Select target field ​視窗中，選擇​ Select identity namespace ​並選取身分識別，或選擇​ Select attributes ​類別並從視需要顯示的資料延伸中選取屬性。 (API) Salesforce Marketing Cloud目的地使用Salesforce Marketing Cloud Search Attribute-Set Definitions REST API來動態擷取Salesforce Marketing Cloud中定義的資料延伸及其連結屬性。 當您在​ Target field ​啟用對象工作流程中設定對應時，這些會顯示在快顯視窗中。

    • 重複這些步驟，在您的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。 -

    • 以下顯示使用這些對應的範例：
      Experience Platform UI熒幕擷圖範例顯示Target對應。

當您完成提供目的地連線的對應時，請選取​Next。

排程對象匯出和範例 schedule-segment-export-example

執行排程對象匯出步驟時，您必須手動將Experience Platform對象對應到中的屬性Salesforce Marketing Cloud。

若要這麼做，請選取每個區段，然後在Salesforce Marketing Cloud (API) Salesforce Marketing Cloud欄位中輸入來自​ Mapping ID ​之屬性的名稱。 如需在中建立屬性的相關指引和最佳實務，請參閱 Salesforce Marketing Cloud在Salesforce Marketing Cloud中建立屬性。

例如，若您的Salesforce Marketing Cloud屬性是salesforce_mc_segment_1，請在(API) Salesforce Marketing Cloud Mapping ID​中指定此值，以將對象對象從Experience Platform填入此屬性。

Salesforce Marketing Cloud的範例屬性顯示如下：
Salesforce Marketing Cloud UI熒幕擷圖顯示屬性。

以下顯示指示(API) Salesforce Marketing Cloud Mapping ID​位置的範例：

Experience Platform UI熒幕擷圖範例，顯示排程對象匯出。

如圖所示，(API) Salesforce Marketing Cloud Mapping ID​應完全符合Salesforce Marketing Cloud FIELD NAME​中指定的值。

對每個已啟動的Experience Platform區段重複此章節。

以上圖影像為基礎的典型範例可能是。

(API) Salesforce Marketing Cloud區段名稱
Salesforce Marketing Cloud FIELD NAME
(API) Salesforce Marketing Cloud Mapping 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. 選取「Destinations > Browse」以導覽至目的地清單。
    Experience Platform UI熒幕擷圖顯示瀏覽目的地。

  2. 選取目的地並驗證狀態為​enabled。
    Experience Platform UI熒幕擷圖顯示目的地資料流執行。

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

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

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

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

資料使用與控管 data-usage-governance

處理您的資料時，所有Adobe Experience Platform目的地都符合資料使用原則。 如需Adobe Experience Platform如何強制資料控管的詳細資訊，請參閱資料控管概觀。

錯誤與疑難排解 errors-and-troubleshooting

將事件推送到Salesforce Marketing Cloud時遇到未知錯誤 unknown-errors

  • 檢查資料流執行時，您可能會遇到下列錯誤訊息： Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
    Experience Platform UI熒幕擷圖顯示錯誤。

    • 若要修正此錯誤，請確認您在​ Mapping 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 Platform IP位址新增至您的Salesforce Marketing Cloud帳戶受信任的IP範圍。 如果您需要其他指引，請參閱Marketing CloudSalesforce Marketing Cloud檔案中的個允許清單的IP位址。

其他資源 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) Salesforce Marketing Cloud中的必要條件，並一般移除檔案中屬性群組的不必要參考。
  • 更新檔案以指出只應在Salesforce Marketing Cloud資料延伸內的Email Demographics中建立對象狀態的屬性。
  • 我們已更新對應考量事項和範例區段中的對應表格，Email Address資料延伸模組中Email Addresses屬性的對應標籤為必要，標示為IMPORTANT的圖說中曾提及此要求，但表格中省略。
2023 年 4 月 文件更新
  • 我們已更正​ Salesforce Marketing Cloud (API) ​中「必要條件」區段中的陳述式及參考連結，指出Salesforce Marketing Cloud Engagement是使用此目的地的必要訂閱。 區段先前錯誤地指出使用者需要訂閱Marketing Cloud 帳戶​參與才能繼續。
  • 我們已在先決條件下新增一節，以將角色和許可權指派給Salesforce使用者，讓此目的地正常運作。 (PLATIR-26299)
2023 年 2 月 文件更新 我們已更新(API) Salesforce Marketing 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