文件Experience Platform目的地指南

Salesforce CRM 連線

Last update: Thu Jan 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • undefined
  • undefined

概觀 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目的地之前，您必須擁有 綱要， a 資料集、和 區段 建立於 Experience Platform.

中的必要條件 Salesforce CRM prerequisites-destination

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

您需要擁有 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 PLATFORMIP 加入允許清單。 請參閱 Salesforce 限制連線應用程式可信任的IP範圍存取權 說明檔案（若您需要其他指引）。

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

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

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

針對您從Platform啟用的每個對象，設定為 Salesforce CRM，您需要建立型別的自訂欄位 Text Area (Long) 範圍 Salesforce. 您可以根據業務需求，定義任何大小的欄位字元長度，範圍在256到131,072個字元之間。 請參閱 Salesforce 自訂欄位型別 說明檔案頁面，以取得自訂欄位型別的其他資訊。 另請參閱 Salesforce 檔案至 建立自訂欄位 若您需要欄位建立方面的協助。

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

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

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

TIP
  • 區分用於Platform受眾的自訂欄位和中的其他自訂欄位 Salesforce 建立自訂欄位時，您可以包含可辨識的前置詞或後置詞。 例如，不使用 test_segment，使用 Adobe_test_segment 或 test_segment_Adobe
  • 如果您在中已建立其他自訂欄位 Salesforce，您可以使用與平台區段相同的名稱，輕鬆識別中的對象 Salesforce.
NOTE
  • Salesforce中的物件限制在25個外部欄位，請參閱 自訂欄位屬性.
  • 此限制表示您在任何時間最多只能有25個作用中的Experience Platform對象會籍。
  • 如果您在Salesforce中達到此限制，則必須從用來針對Experience Platform中舊版對象儲存對象狀態的Salesforce中移除自訂屬性，然後再新增對象 對應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

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

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

連線到目標 connect

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

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

範圍 目的地 > 目錄 搜尋 Salesforce CRM. 或者，您可以在 CRM 類別。

驗證目標 authenticate

若要向目的地進行驗證，請填寫以下必填欄位並選取 連線到目的地. 請參閱 彙總 Salesforce CRM 認證 區段以取得任何指引。
| 認證 | 說明 | | — | — | | 使用者名稱 | 您的 Salesforce 帳戶使用者名稱。 | | 密碼 | 串連字串，由您的 Salesforce 帳戶密碼已附加您的 Salesforce 安全性Token。
串連值採用以下形式 {PASSWORD}{TOKEN}.
請注意，請勿使用任何大括弧或空格。
例如，若您的 Salesforce 密碼為 MyPa$$w0rd123 和 Salesforce 安全性權杖是 TOKEN12345....0000，即您在中使用的串連值 密碼 欄位為 MyPa$$w0rd123TOKEN12345....0000. | | 自訂網域 | 您的 Salesforce 網域前置詞。
例如，如果您的網域為 d5i000000isb4eak-dev-ed.my.salesforce.com，您必須提供 d5i000000isb4eak-dev-ed 做為值。 | | 使用者端ID | 您的 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)結構描述欄位與來自目標目的地的對應對應專案之間建立連結。

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

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

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

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

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

  3. 在 選取目標欄位 視窗，選擇 選取身分名稱空間 並選取身分或選擇 選取自訂屬性 類別並選取屬性，或使用 屬性名稱 欄位。 請參閱 Salesforce CRM 檔案 以取得支援屬性的指引。

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

    使用連絡人

    • 如果您使用的是 連絡人 在區段內，請參閱Salesforce中的「物件參考」，以瞭解 連絡人 以定義要更新欄位的對應。

    • 您可以透過搜尋字詞來識別必填欄位 必填，如上述連結的欄位說明中所述。

    • 根據您要匯出或更新之欄位，在XDM設定檔結構描述與之間新增對應 (API) Salesforce CRM： |來源欄位|目標欄位| 附註 | | — | — | — | |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| 連絡人的電子郵件地址。 |

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

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

    使用銷售機會

    • 如果您使用的是 銷售機會 在區段內，請參閱Salesforce中的「物件參考」，以瞭解 銷售機會 以定義要更新欄位的對應。

    • 您可以透過搜尋字詞來識別必填欄位 必填，如上述連結的欄位說明中所述。

    • 根據您要匯出或更新之欄位，在XDM設定檔結構描述與之間新增對應 (API) Salesforce CRM： |來源欄位|目標欄位| 附註 | | — | — | — | |IdentityMap: crmID|Identity: SalesforceId|Mandatory| |xdm: person.name.lastName|Attribute: LastName| Mandatory. 銷售機會的姓氏，最多80個字元。 |
      |xdm: b2b.companyName|Attribute: Company| Mandatory. 潛在客戶的公司。 | |xdm: personalEmail.address|Attribute: Email| 潛在客戶的電子郵件地址。 |

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

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

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

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

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

要執行此操作，請選取每個區段，然後輸入自訂欄位名稱 Salesforce 在 Salesforce CRM 對應ID 欄位。 請參閱 在中建立自訂欄位 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. 選取 目的地 > 瀏覽 以導覽至目的地清單。
    顯示瀏覽目的地的平台UI熒幕擷圖。

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

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

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

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

    使用連絡人

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

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

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

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

    使用銷售機會

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

      Salesforce CRM熒幕擷取畫面顯示「銷售機會」頁面，其中包含區段中的設定檔。

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

      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