Salesforce CRM 連線

概觀 overview

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

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

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

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

Salesforce CRM支援兩種驗證機制以與Salesforce REST API通訊: OAuth 2密碼​和​OAuth 2使用者端認證。 向目的地驗證區段中進一步說明如何向您的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

請注意Salesforce CRM中的下列先決條件,要將資料從Experience Platform匯出至您的Salesforce帳戶:

您必須擁有Salesforce帳戶 prerequisites-account

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

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

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

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

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

  • chatter_api
  • lightning
  • visualforce
  • content
  • openid
  • full
  • api
  • web
  • refresh_token
  • offline_access

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

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

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

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

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

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

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

在Salesforce,步驟1 — 選取資料型別中建立自訂欄位的範例如下所示:
Salesforce UI熒幕擷圖顯示自訂欄位建立,步驟1 — 選取資料型別。 {modal="regular"}

在Salesforce,步驟2 — 輸入自訂欄位的詳細資料中建立自訂欄位的範例顯示如下:
Salesforce UI熒幕擷圖顯示自訂欄位建立,步驟2 — 輸入自訂欄位的詳細資料。 {modal="regular"}

TIP
  • 若要區分用於Experience Platform對象的自訂欄位和Salesforce內的其他自訂欄位,您可以在建立自訂欄位時包含可辨識的前置詞或後置詞。 例如,使用Adobe_test_segment或test_segment_Adobe代替test_segment
  • 如果您已在Salesforce中建立其他自訂欄位,您可以使用與Experience Platform區段相同的名稱,輕鬆識別Salesforce中的對象。
NOTE
  • Salesforce中的物件限製為25個外部欄位,請參閱自訂欄位屬性。
  • 此限制表示您隨時最多只能有25個Experience Platform對象會籍處於作用中。
  • 如果您在Salesforce中達到此限制,則必須先從Salesforce中移除用來針對Experience Platform中舊版對象儲存對象狀態的自訂屬性,才能使用新的​對應ID。

收集Salesforce CRM認證 gather-credentials

在驗證Salesforce CRM目的地之前,請記下以下專案。 您需要的認證取決於您在對目的地進行驗證時選取的​驗證型別。

OAuth 2密碼

如果您選取​ OAuth 2密碼 ​作為驗證型別,請收集下列認證。

認證
說明
範例
Username
您的Salesforce帳戶使用者名稱。
Password
您的Salesforce帳戶密碼。
Security Token
您的Salesforce安全性權杖,您稍後會將其附加至Salesforce密碼的結尾,以建立串連字串,在對目的地進行驗證時,用作​密碼。
請參閱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介面取得此值。

OAuth 2使用者端認證

如果您選取​ OAuth 2使用者端認證 ​做為驗證型別,請收集下列認證。 此選項可讓您在不使用Salesforce使用者名稱、密碼或安全性權杖的情況下,使用服務帳戶進行驗證。

認證
說明
範例
Subdomain
您的Salesforce網域前置詞。
請參閱Salesforce 檔案以瞭解如何從Salesforce介面取得此值。
如果您的Salesforce網域是
sampleorg.login.my.salesforce.com,
您需要提供sampleorg作為值。
Client ID
您的Salesforce Client ID。
請參閱Salesforce 檔案以瞭解如何從Salesforce介面取得此值。
Client Secret
您的Salesforce Client Secret。
請參閱Salesforce 檔案以瞭解如何從Salesforce介面取得此值。

護欄 guardrails

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

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

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

支援的身分 supported-identities

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

目標身分
說明
考量事項
SalesforceId
您透過區段匯出或更新之連絡人或潛在客戶身分的Salesforce CRM識別碼。
強制

支援的對象 supported-audiences

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

對象來源
支援
說明
Segmentation Service
是
透過Experience Platform 細分服務產生的對象。
所有其他受眾來源
否

此類別包含透過Segmentation Service產生的對象以外的所有對象來源。 閱讀各種對象來源。 部分範例包括:

  • 自訂上傳對象從CSV檔案匯入至Experience Platform,
  • 相似受眾,
  • 同盟對象,
  • 其他Experience Platform應用程式中產生的對象,例如Adobe Journey Optimizer、
  • 及更多內容。

依受眾資料型別支援的受眾:

對象資料型別
支援
說明
使用案例
人員對象
是
根據客戶設定檔,可讓您針對行銷活動的特定人群進行定位。
經常購買者、購物車放棄者
帳戶對象
否
針對帳戶型行銷策略,鎖定特定組織內的個人。
B2B行銷
潛在客戶對象
否
將目標定位為尚未成為客戶但與目標受眾具有相同特性的個人。
使用第三方資料進行勘探
資料集匯出
否
儲存在Adobe Experience Platform資料湖中的結構化資料集合。
報告、資料科學工作流程

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

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

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

連線到目標 connect

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

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

在​目的地 > 目錄​內,搜尋Salesforce CRM。 或者,您可以在​ CRM ​類別下找到它。

驗證目標 authenticate

若要驗證到目的地,請選取​驗證型別,填寫下面的必填欄位,然後選取​連線到目的地。 如需任何指引,請參閱收集 Salesforce CRM 認證區段。

OAuth 2密碼

如果您選取​ OAuth 2密碼 ​作為驗證型別,請填寫下列欄位。

認證
說明
帳戶名稱
可協助您在Experience Platform中識別此目的地連線的名稱。 如果您有多個連線連至同一目的地,這個做法尤其實用。
描述 (選擇性)
協助您或您的團隊在Experience Platform內識別此目的地連線的詳細資料,例如連線的目的或相關的業務內容。
使用者名稱
您的Salesforce帳戶使用者名稱。
密碼
由您的Salesforce帳戶密碼附加您的Salesforce安全性權杖所組成的串連字串。
串連值採用{PASSWORD}{TOKEN}的形式。
請注意,請勿使用任何大括弧或空格。
例如,若您的Salesforce密碼為MyPa$$w0rd123,Salesforce安全性權杖為TOKEN12345....0000,則您將在​ 密碼 ​欄位中使用的串連值為MyPa$$w0rd123TOKEN12345....0000。
自訂網域
您的Salesforce網域前置詞。
例如,如果您的網域是​d5i000000isb4eak-dev-ed.my.salesforce.com,您必須提供d5i000000isb4eak-dev-ed做為值。
使用者端識別碼
您的Salesforce已連線應用程式Consumer Key。
使用者端密碼
您的Salesforce已連線應用程式Consumer Secret。

Experience Platform UI熒幕擷圖顯示如何使用OAuth 2密碼進行驗證。 {modal="regular"}

OAuth 2使用者端認證

如果您選取​ OAuth 2使用者端認證 ​作為驗證型別,請填寫下列欄位。

認證
說明
帳戶名稱
可協助您在Experience Platform中識別此目的地連線的名稱。 如果您有多個連線連至同一目的地,這個做法尤其實用。
描述 (選擇性)
協助您或您的團隊在Experience Platform內識別此目的地連線的詳細資料,例如連線的目的或相關的業務內容。
子網域
您的Salesforce網域前置詞。
例如,如果您的網域是​sampleorg.login.my.salesforce.com,您必須提供sampleorg做為值。
使用者端識別碼
您的Salesforce Client ID。
使用者端密碼
您的Salesforce Client Secret。

Experience Platform UI熒幕擷圖顯示如何使用OAuth 2使用者端憑證進行驗證。 {modal="regular"}

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

填寫目標詳細資訊 destination-details

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

  • 名稱:您日後可辨識此目的地的名稱。

  • 描述:可協助您日後識別此目的地的描述。

  • Salesforce ID型別:

    • 如果您要匯出或更新身分的型別為​連絡人,請選取​連絡人。
    • 如果您要匯出或更新身分的型別為​銷售機會,請選取​銷售機會。

Experience Platform UI熒幕擷圖顯示目的地詳細資料。 {modal="regular"}

啟用警示 enable-alerts

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

當您完成提供目的地連線的詳細資訊後,請選取​下一步。

啟動此目標的對象 activate

IMPORTANT
  • 若要啟用資料,您需要​檢視目的地、啟用目的地、檢視設定檔​和​檢視區段 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。
  • 若要匯出​身分,您需要​檢視身分圖表 存取控制許可權。
    選取工作流程中反白的身分名稱空間,以啟用目的地的對象。 {width="100" modal="regular"}

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

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

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

在​ 目標欄位 ​中指定的屬性應完全依照屬性對應表格中的說明命名,因為這些屬性將構成要求內文。

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

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

  1. 在​ 對應 ​步驟中,選取​新增對應,您會在畫面上看到新的對應列。
    新增對應之Experience Platform UI熒幕擷圖範例。 {modal="regular"}

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

  3. 在​ 選取目標欄位 ​視窗中,選擇​ 選取識別名稱空間 ​並選取識別,或選擇​ 選取自訂屬性 ​類別並選取屬性,或視需要使用​ 屬性名稱 ​欄位定義屬性。 請參閱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 連絡人的電子郵件地址。
    • 以下顯示使用這些對應的範例:
      Experience Platform UI熒幕擷圖範例顯示Target對應。 {modal="regular"}

    使用銷售機會

    • 如果您正在區段內使用​銷售機會,請參閱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 潛在客戶的電子郵件地址。
    • 以下顯示使用這些對應的範例:
      Experience Platform UI熒幕擷圖範例顯示Target對應。 {modal="regular"}

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

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

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

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

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

以下顯示來自Salesforce的自訂欄位範例:
顯示自訂欄位的 Salesforce UI熒幕擷圖。 {modal="regular"}

以下顯示指示Salesforce CRM 對應ID​位置的範例:
Experience Platform UI熒幕擷圖範例,顯示排程對象匯出。 {modal="regular"}

如上所示,Salesforce 欄位名稱​與Salesforce CRM 對應ID​中指定的值完全相符。

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

Salesforce CRM區段名稱
Salesforce 欄位名稱
Salesforce CRM 對應ID
crm_1_seg
crm_1_seg
crm_1_seg
crm_2_seg
crm_2_seg
crm_2_seg

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

驗證資料匯出 exported-data

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

  1. 選取「目的地」>「瀏覽」以瀏覽目的地清單,然後選取目的地並驗證狀態為「已啟用」。
    Experience Platform UI熒幕擷圖顯示具有目的地狀態的瀏覽目的地。 {modal="regular"}

  2. 切換至​ 啟用資料 ​標籤,然後選取對象名稱。
    顯示目的地啟用資料的Experience Platform UI熒幕擷圖範例。 {modal="regular"}

  3. 監控對象摘要,並確保設定檔計數對應於在區段內建立的計數。
    Experience Platform UI熒幕擷圖範例,顯示區段。 {modal="regular"}

  4. 最後,前往Salesforce網站並驗證對象的設定檔是否已更新。

    使用連絡人

    • 如果您已在您的Experience Platform區段中選取​連絡人,請瀏覽至​Apps > Contacts​頁面。
      Salesforce CRM熒幕擷圖顯示含有區段設定檔的「連絡人」頁面。 {modal="regular"}

    • 選取​ 連絡人 ​並檢查欄位是否已更新。 您可以看到根據對象排程期間提供的​ 對應ID ​值,Salesforce CRM中的每個對象狀態已更新為Experience Platform中的對應對象狀態。
      Salesforce CRM熒幕擷取畫面顯示「連絡人詳細資料」頁面,且對象狀態已更新。 {modal="regular"}

    使用銷售機會

    • 如果您已在您的Experience Platform區段中選取​銷售機會,請導覽至​Apps > Leads​頁面。
      Salesforce CRM熒幕擷圖顯示具有區段設定檔的「銷售機會」頁面。 {modal="regular"}

    • 選取​ 銷售機會 ​並檢查欄位是否已更新。 您可以看到根據對象排程期間提供的​ 對應ID ​值,Salesforce CRM中的每個對象狀態已更新為Experience Platform中的對應對象狀態。
      Salesforce CRM熒幕擷圖顯示具有更新對象狀態的「銷售機會詳細資訊」頁面。 {modal="regular"}

資料使用與控管 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.
    Experience Platform UI熒幕擷圖顯示錯誤。 {modal="regular"}

    • 若要修正此錯誤,請確認您在啟動工作流程中提供的​ 對應ID ​與Salesforce CRM目的地完全符合您在Salesforce中建立的自訂欄位型別的值。 請參閱在 Salesforce內建立自訂欄位區段以取得指引。
  • 啟用區段時,您可能會收到錯誤訊息: The client's IP address is unauthorized for this account. Allowlist the client's IP address...

其他資源 additional-resources

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

recommendation-more-help
experience-platform-help-destinations