文件Experience Platform目的地指南

Salesforce CRM個連線

Last update: Thu Jul 18 2024 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

請注意Salesforce CRM中的下列必要條件，以便從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 PlatformIP的加入允許清單。 如需其他指引，請參閱Salesforce 限制連線應用程式的受信任IP範圍存取檔案。

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

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

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

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

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

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

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

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

收集Salesforce CRM認證 gather-credentials

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

認證
說明
範例
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介面取得此值。

護欄 guardrails

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

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

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

支援的身分 supported-identities

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

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

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

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

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

連線到目標 connect

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

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

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

驗證目標 authenticate

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

認證
說明
使用者名稱
您的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。

平台UI熒幕擷圖顯示如何驗證。

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

填寫目標詳細資訊 destination-details

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

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

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

  • Salesforce ID型別：

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

顯示目的地詳細資訊的平台UI熒幕擷取畫面。

啟用警示 enable-alerts

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

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

啟動此目標的對象 activate

IMPORTANT

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

  • 若要匯出​ 身分，您需要​ 檢視身分圖表 存取控制許可權。

    選取工作流程中反白的身分名稱空間，以啟用目的地的對象。 {width="100" modal="regular"}

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

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

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

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

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

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

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

  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 連絡人的電子郵件地址。

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

      顯示目標對應的平台UI熒幕擷圖範例。

    使用銷售機會

    • 如果您正在區段內使用​ 銷售機會，請參閱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 潛在客戶的電子郵件地址。

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

      顯示目標對應的平台UI熒幕擷圖範例。

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

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

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

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

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

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

以下顯示指示Salesforce CRM 對應ID ​位置的範例：
顯示排程對象匯出的平台UI熒幕擷圖範例。

如上所示，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

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

驗證資料匯出 exported-data

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

  1. 選取​ 目的地 > 瀏覽 ​以瀏覽目的地清單。
    顯示瀏覽目的地的Platform UI熒幕擷圖。

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

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

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

  5. 最後，登入Salesforce網站並驗證對象的設定檔是否已新增或更新。

    使用連絡人

    • 如果您已在您的Platform區段中選取​ 連絡人，請瀏覽至​ Apps > Contacts ​頁面。

      Salesforce CRM熒幕擷圖顯示含有區段設定檔的「連絡人」頁面。

    • 選取​ 連絡人 ​並檢查欄位是否已更新。 您可以看到根據對象排程期間提供的​ 對應ID ​值，Salesforce CRM中的每個對象狀態已更新為來自Platform的對應對象狀態。

      Salesforce CRM熒幕擷取畫面顯示「連絡人詳細資料」頁面，其中包含更新的對象狀態。

    使用銷售機會

    • 如果您已在您的Platform區段中選取​ 銷售機會，請導覽至​ Apps > Leads ​頁面。

      Salesforce CRM熒幕擷圖顯示具有區段設定檔的「銷售機會」頁面。

    • 選取​ 銷售機會 ​並檢查欄位是否已更新。 您可以看到根據對象排程期間提供的​ 對應ID ​值，Salesforce CRM中的每個對象狀態已更新為來自Platform的對應對象狀態。

      Salesforce CRM熒幕擷圖顯示具有更新對象狀態的「銷售機會詳細資料」頁面。

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

    • 若要修正此錯誤，請確認您在啟動工作流程中提供的​ 對應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
7f4d1967-bf93-4dba-9789-bb6b505339d6