Salesforce CRM 連線

Last update: Tue Nov 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
目標

建立對象：

管理員
使用者

概觀 overview

Salesforce CRM是熱門的客戶關係管理(CRM)平台，並支援下列描述的個人檔案型別：

銷售機會 — 銷售機會是可能對您銷售的產品或服務感興趣（或不感興趣）的個人或公司名稱。
連絡人 — 連絡人是您的代表已建立關係且已取得潛在客戶資格的個人。

此Adobe Experience Platform 目的地利用支援上述兩種設定檔型別的Salesforce composite API。

當啟用區段時，您可以在潛在客戶或聯絡人之間選取，並將屬性和對象資料更新到Salesforce CRM中。

Salesforce CRM使用具有密碼授予的OAuth 2做為驗證機制，與Salesforce REST API通訊。 Salesforce CRM向目的地驗證區段中進一步說明如何向您的執行個體進行驗證。

使用案例 use-cases

行銷人員可以根據使用者Adobe Experience Platform設定檔中的屬性，將個人化體驗提供給使用者。您可以從您的離線資料建立受眾，並將這些受眾傳送至Salesforce CRM，以便在Adobe Experience Platform中更新受眾和設定檔後立即更新CRM會籍。

先決條件 prerequisites

Experience Platform的必要條件 prerequisites-in-experience-platform

在啟用資料至Salesforce CRM目的地之前，您必須在中建立結構描述、資料集和區段Experience Platform。

Salesforce CRM中的必要條件 prerequisites-destination

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

您必須擁有Salesforce帳戶 prerequisites-account

移至Salesforce 試用版頁面以註冊並建立Salesforce帳戶（如果尚未建立）。

在Salesforce中設定連線應用程式 prerequisites-connected-app

首先，如果您尚未設定Salesforce 帳戶中的連線應用程式Salesforce，請先設定。 Salesforce CRM將利用連線的應用程式連線至Salesforce。

接下來，為OAuth Settings for API Integration啟用Salesforce connected app。請參閱Salesforce檔案以取得指引。

此外，請確定已針對選取下列提及的範圍Salesforce connected app。

chatter_api
lightning
visualforce
content
openid
full
api
web
refresh_token
offline_access

最後，確定已在您的password帳戶中啟用Salesforce授權。若您需要指引，請參閱Salesforce OAuth 2.0特殊案例的使用者名稱密碼流程檔案。

IMPORTANT

如果您的Salesforce帳戶管理員已限制受信任IP範圍的存取權，您必須連絡他們，才能取得Experience Platform IP的加入允許清單。如需其他指引，請參閱Salesforce 限制連線應用程式的受信任IP範圍存取檔案。

在Salesforce中建立自訂欄位 prerequisites-custom-field

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

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

對於您從Experience Platform啟動到Salesforce CRM的每個對象，您需要在Text Area (Long)內建立型別Salesforce的自訂欄位。您可以根據業務需求，定義任何大小的欄位字元長度，範圍在256到131,072個字元之間。如需自訂欄位型別的其他資訊，請參閱Salesforce 自訂欄位型別檔案頁面。如果您需要欄位建立的相關協助，也請參閱Salesforce檔案以建立自訂欄位。

IMPORTANT

請勿在欄位名稱中包含空白字元。請改用底線(_)字元做為分隔符號。
在Salesforce內，您必須為每個已啟動的Experience Platform區段建立具有 Field Name 的自訂欄位，這些欄位必須與 Mapping ID 內指定的值完全相符。例如，底下熒幕擷圖顯示名為crm_2_seg的自訂欄位。啟用此目的地的對象時，請新增crm_2_seg作為Mapping ID，以將對象從Experience Platform填入此自訂欄位中。

在Salesforce，步驟1 — 選取資料型別中建立自訂欄位的範例如下所示：
Salesforce UI熒幕擷圖顯示自訂欄位建立，步驟1 — 選取資料型別。

在Salesforce，步驟2 — 輸入自訂欄位的詳細資料中建立自訂欄位的範例顯示如下：
Salesforce UI熒幕擷圖顯示自訂欄位建立，步驟2 — 輸入自訂欄位的詳細資料。

TIP

若要區分用於Experience Platform對象的自訂欄位和Salesforce內的其他自訂欄位，您可以在建立自訂欄位時包含可辨識的前置詞或後置詞。例如，使用test_segment或Adobe_test_segment代替test_segment_Adobe
如果您已在Salesforce中建立其他自訂欄位，您可以使用與Experience Platform區段相同的名稱，輕鬆識別Salesforce中的對象。

NOTE

Salesforce中的物件限製為25個外部欄位，請參閱自訂欄位屬性。
此限制表示您隨時最多只能有25個Experience Platform對象會籍處於作用中。
如果您在Salesforce中達到此限制，則必須先從Salesforce中移除用來針對Experience Platform中舊版對象儲存對象狀態的自訂屬性，才能使用新的Mapping ID。

收集Salesforce CRM認證 gather-credentials

在驗證Salesforce CRM目的地之前，請記下以下專案：

認證

說明

範例

Username

您的Salesforce帳戶使用者名稱。

Password

您的Salesforce帳戶密碼。

Security Token

您的Salesforce安全性權杖，您稍後會將其附加至Salesforce密碼的結尾，以建立串連字串，在 Password 對目的地進行驗證時用作。
請參閱Salesforce檔案以重設您的安全性權杖，瞭解如何從Salesforce介面重新產生沒有安全性權杖的權杖。

Custom Domain

您的Salesforce網域前置詞。
請參閱Salesforce 檔案以瞭解如何從Salesforce介面取得此值。

如果您的Salesforce網域是
d5i000000isb4eak-dev-ed.my.salesforce.com，
您需要d5i000000isb4eak-dev-ed做為值。

Client ID

您的Salesforce Consumer Key。
請參閱Salesforce 檔案以瞭解如何從Salesforce介面取得此值。

Client Secret

您的Salesforce Consumer Secret。
請參閱Salesforce 檔案以瞭解如何從Salesforce介面取得此值。

護欄 guardrails

Salesforce強制要求、速率和逾時限制，以平衡交易載入。如需詳細資訊，請參閱API要求限制和配置。

如果您的Salesforce帳戶管理員已強制執行IP限制，您必須將Experience Platform IP位址新增至您的Salesforce帳戶受信任的IP範圍。如需其他指引，請參閱Salesforce 限制連線應用程式的受信任IP範圍存取檔案。

IMPORTANT

當啟用區段時，您必須在 連絡人 或 潛在客戶 型別之間選取。您必須確保您的對象擁有根據所選型別的適當資料對應。

支援的身分 supported-identities

Salesforce CRM支援下表中描述的身分更新。深入瞭解身分。

目標身分

說明

考量事項

SalesforceId

您透過區段匯出或更新之連絡人或潛在客戶身分的Salesforce CRM識別碼。

強制

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

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

項目

類型

附註

匯出類型

Profile-based

您正在匯出區段的所有成員，以及所需的結構描述欄位（例如：電子郵件地址、電話號碼、姓氏） （根據您的欄位對應）。
根據Salesforce CRM對象排程 Mapping ID 步驟期間提供的值，中的每個對象狀態都會根據Experience Platform以對應的對象狀態更新。

匯出頻率

Streaming

串流目的地是「一律開啟」的API型連線。根據對象評估在Experience Platform中更新設定檔後，聯結器會立即將更新傳送至下游的目標平台。深入瞭解串流目的地。

連線到目標 connect

IMPORTANT

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

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

在Destinations > Catalog內搜尋Salesforce CRM。或者，您可以在 CRM 類別下找到它。

驗證目標 authenticate

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

認證

說明

Username

您的Salesforce帳戶使用者名稱。

Password

由您的Salesforce帳戶密碼附加您的Salesforce安全性權杖所組成的串連字串。
串連值採用{PASSWORD}{TOKEN}的形式。
注意，請勿使用任何大括弧或空格。
例如，若您的Salesforce密碼為MyPa$$w0rd123，Salesforce安全性權杖為TOKEN12345....0000，則您將在 Password 欄位中使用的串連值為MyPa$$w0rd123TOKEN12345....0000。

Custom Domain

您的Salesforce網域前置詞。
例如，如果您的網域是d5i000000isb4eak-dev-ed.my.salesforce.com，您必須提供d5i000000isb4eak-dev-ed做為值。

Client ID

您的Salesforce已連線應用程式Consumer Key。

Client Secret

您的Salesforce已連線應用程式Consumer Secret。

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

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

填寫目標詳細資料 destination-details

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

Name：您日後可辨識此目的地的名稱。
Description：可協助您日後識別此目的地的說明。
Salesforce ID Type：
- 如果您要匯出或更新之身分的型別為 Contact 連絡人，請選取。
- 如果您要匯出或更新身分的型別為 Lead 潛在客戶，請選取。

Experience Platform UI熒幕擷圖顯示目的地詳細資料。

啟用警示 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正確傳送至Salesforce CRM目的地，您必須完成欄位對應步驟。對應包括在Experience Platform帳戶中的Experience Data Model (XDM)結構描述欄位與來自目標目的地的對應對應專案之間建立連結。

在 Target field 中指定的屬性應完全依照屬性對應表格中的說明命名，因為這些屬性將構成要求內文。

Source field中指定的屬性未遵循任何此類限制。您可以視需要加以對應，但請根據Salesforce 檔案確定輸入資料的格式有效。如果輸入資料無效，對Salesforce的更新呼叫將會失敗，而且您的連絡人/潛在客戶將不會更新。

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

在 Mapping 步驟中選取Add new mapping，您會在畫面上看到新的對應列。
在 Select source field 視窗中，選擇 Select attributes 類別並選取XDM屬性，或選擇 Select identity namespace 並選取身分。

在 Select target field 視窗中，選擇 Select identity namespace 並選取身分，或選擇 Select custom attributes 類別並選取屬性，或視需要使用 Attribute name 欄位定義屬性。請參閱Salesforce CRM 檔案以取得支援屬性的指引。

重複這些步驟，在您的XDM設定檔結構描述與(API) Salesforce CRM之間新增下列對應：

使用連絡人

如果您正在使用區段中的連絡人，請參閱Salesforce中的連絡人物件參考以定義要更新的欄位對應。
您可以搜尋文字Required，以識別必填欄位，此文字在上述連結的欄位說明中有所提及。

根據您要匯出或更新欄位，在您的XDM設定檔結構描述和(API) Salesforce CRM之間新增對應：

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
來源欄位	目標欄位	附註
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory`。連絡人的姓氏，最多80個字元。
`xdm: person.name.firstName`	`Attribute: FirstName`	連絡人的名字，最多40個字元。
`xdm: personalEmail.address`	`Attribute: Email`	連絡人的電子郵件地址。

以下顯示使用這些對應的範例：

使用銷售機會

如果您正在區段內使用銷售機會，請參閱Salesforce中的銷售機會物件參考，以定義要更新欄位的對應。
您可以搜尋文字Required，以識別必填欄位，此文字在上述連結的欄位說明中有所提及。

根據您要匯出或更新欄位，在您的XDM設定檔結構描述和(API) Salesforce CRM之間新增對應：

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
來源欄位	目標欄位	附註
`IdentityMap: crmID`	`Identity: SalesforceId`	`Mandatory`
`xdm: person.name.lastName`	`Attribute: LastName`	`Mandatory`。銷售機會的姓氏，最多80個字元。
`xdm: b2b.companyName`	`Attribute: Company`	`Mandatory`。潛在客戶的公司。
`xdm: personalEmail.address`	`Attribute: Email`	潛在客戶的電子郵件地址。

以下顯示使用這些對應的範例：

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

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

執行排程對象匯出步驟時，您必須手動將從Experience Platform啟用的對象對應到Salesforce中其對應的自訂欄位。

若要這麼做，請選取每個區段，然後在Salesforce Salesforce CRM欄位中輸入來自 Mapping ID 的自訂欄位名稱。如需在中建立自訂欄位的相關指引和最佳作法，請參閱 Salesforce在Salesforce中建立自訂欄位。

例如，若您的Salesforce自訂欄位是crm_2_seg，請在Salesforce CRM Mapping ID中指定此值，以將對象從Experience Platform填入此自訂欄位。

以下顯示來自Salesforce的自訂欄位範例：
Salesforce顯示自訂欄位的UI熒幕擷圖。

以下顯示指示Salesforce CRM Mapping ID位置的範例：
Experience Platform UI熒幕擷圖範例，顯示排程對象匯出。

如上所示，Salesforce Field Name與Salesforce CRM Mapping ID中指定的值完全相符。

根據您的使用案例，所有啟用的對象都可以對應至相同的Salesforce自訂欄位或 Field Name 中的不同Salesforce CRM。以上圖影像為基礎的典型範例可能是。

Salesforce CRM區段名稱

Salesforce Field Name

Salesforce CRM Mapping ID

crm_1_seg

crm_1_seg

crm_2_seg

crm_2_seg

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

驗證資料匯出 exported-data

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

選取「Destinations > Browse」以導覽至目的地清單。
選取目的地並驗證狀態為enabled。
切換至 Activation data 標籤，然後選取對象名稱。
監控對象摘要，並確保設定檔計數對應於在區段內建立的計數。
最後，登入Salesforce網站並驗證對象的設定檔是否已更新。

使用連絡人
- 如果您已在您的Experience Platform區段中選取連絡人，請瀏覽至Apps > Contacts頁面。
- 選取 連絡人 並檢查欄位是否已更新。您可以看到根據Salesforce CRM對象排程 Mapping ID 期間提供的值，中的每個對象狀態已更新為Experience Platform中的對應對象狀態。
使用銷售機會
- 如果您已在您的Experience Platform區段中選取銷售機會，請導覽至Apps > Leads頁面。
- 選取 銷售機會 並檢查欄位是否已更新。您可以看到根據Salesforce CRM對象排程 Mapping ID 期間提供的值，中的每個對象狀態已更新為Experience Platform中的對應對象狀態。

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

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

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

將事件推播到目的地時遇到未知錯誤 unknown-errors

檢查資料流執行時，您可能會遇到下列錯誤訊息： Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
- 若要修正此錯誤，請確認您在 Mapping ID 目的地的啟用工作流程中提供的Salesforce CRM與您在Salesforce中建立的自訂欄位型別的值完全相符。請參閱在 Salesforce內建立自訂欄位區段以取得指引。
啟用區段時，您可能會收到錯誤訊息： The client's IP address is unauthorized for this account. Allowlist the client's IP address...
- 若要修正此錯誤，請連絡您的Salesforce帳戶管理員，將Experience Platform IP位址新增至您的Salesforce帳戶受信任的IP範圍。如需其他指引，請參閱Salesforce 限制連線應用程式的受信任IP範圍存取檔案。

其他資源 additional-resources

來自Salesforce開發人員入口網站的其他實用資訊如下：

快速入門
建立記錄
自訂建議對象
使用複合資源
此目的地採用Upsert Multiple Records API，而非Upsert Single Record API呼叫。

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6