The Salesforce Developers website will undergo maintenance on May 29, 2024 from 3:00 a.m. UTC to 10:00 a.m. UTC. The maintenance process may affect the availability of our documentation. Please plan accordingly.

傳送個人資料

開發人員可以設定兩種方式,讓客戶將購物者個人資料屬性傳送給 Einstein:大量上傳、即時活動追蹤。您可以使用任一種方法 (或同時使用兩種方法) 將購物者個人資料傳送給 Einstein。

向 Einstein 提交資料時,請記得下列事項:

  • 除了建議使用的指定使用者識別碼以外,Salesforce 強烈建議您不要將個人可識別資訊 (PII) 傳送給 Einstein。
  • 所有收集的資料都會在內部儲存長達一年。一年後,資料會過期並從所有 Einstein 資料庫中移除。如要繼續使用此個人資料,您必須將其重新傳送給 Einstein。
  • 當 Einstein 接收到現有購物者個人資料屬性的新值時,新值將會附加到現有的值。
  • Einstein 會使用所有提供的個人資料。新資料的價值與現有資料並無任何不同。

Salesforce 提供安全的大量上傳端點,讓客戶上傳他們收集的任何歷史購物者個人資料。

大量上傳選項適用於:

  • 任何您追蹤、收集的購物者個人資料的相關資料。
  • 任何您希望 Einstein 可以用來提升購物者個人化的可信任第三方資料。

大量上傳資料會對 Einstein 資料造成重大影響。因此,我們只允許授權使用者上傳大量資料。此外,每個上傳 API 呼叫都必須傳遞從 Account Manager 取得的必要授權標頭 (持有人) 存取權杖。

備註: 為了降低 Account Manager 伺服器上的負載,請避免在目前權杖到期之前,產生任何新的權杖。請參考 API 規範,進一步瞭解大量上傳 API 呼叫。

若要準備大量上傳資料讓 Einstein 使用,請確認以下事項:

  • 此大量檔案必須是 gzip 壓縮的定位鍵分隔值 (TSV) 檔案。
  • TSV 檔案需擁有正確格式,並以 UTF-8 字元編碼儲存。
  • 檔案的 mimetype 已正確設定,以供 gzip 應用程式使用。
  • 標頭列必須包含 login_id 識別欄位、email_address 識別欄位或兩者。
  • 您可以為每個要傳送的購物者個人資料屬性新增其他欄。
  • 值必須為字串或字串清單。對於字串清單,請務必使用直立線 (|) 分隔符號來分隔每個值。例如:orange|yellow
  • 空白欄會被忽略。當 Einstein 遇到空白欄時,會跳過該欄,並繼續處理剩餘的使用者屬性資料。

為了協助替每位購物者產生相關的產品推薦,Profile Connector API 需要這些使用者識別碼中的其中一項,來識別大量上傳中的購物者。

欄位描述
login_id購物者的登入 ID。在某些情況下,這與 email_address 值相同。
email_address購物者的完整電子郵件地址。例如:shopper1@somewhere.com

以下是使用隨機欄名的購物者個人資料大量上傳 TSV 資料的範例:

login_idemail_addressgendercolorsbrand_list
shopper1shopper1@somewhere.commaleorange|yellowbrandA|brandB
shopper2shopper2@somewhere.comfemaleblue|blackbrandD
shopper3shopper3@somewhere.comfemalered|black|violetbrandB|brandE

在執行購物者個人資料大量上傳時,請記得以下端點限制:

  • 一次只可上傳一個檔案。但是,您可以一個接一個上傳多個檔案。
  • 最大檔案大小為 2 GB。

準備好購物者個人資料的大量資料檔案後,請將個別檔案以 gzip 壓縮,並上傳至 Einstein 的購物者個人資料大量上傳端點。如需更多資訊,請參考傳送大量個人資料端點

使用活動 updateProfile 追蹤端點來呼叫、傳送即時購物者個人資料的更新和喜好設定。即時擷取購物者在您網店中提供的資訊,讓推薦能夠立即反映這些變化。

即時活動追蹤選項適用於:

  • 即時擷取購物者的喜好設定活動。
  • 即時更新購物者的個人資料。

為了協助替每位購物者產生相關的產品推薦,Profile Connector API 提供兩個使用者識別碼,來識別即時追蹤中的購物者。

  • cookieId (必填) - 匿名購物者的唯一識別碼。一般來說,cookieId 是第一方 Cookie 的值。
    • 從傳統 Commerce Cloud 網店發出 API 要求時,請傳遞 cqcid Cookie 值來符合傳統網店上的自動活動追蹤。如需更多資訊,請參閱瀏覽器型本機資料儲存
    • 使用 OCAPI 或 Salesforce Commerce API 時,請使用訪客登入回應的 visit_id 值以符合自動活動。如需更多資訊,請參閱 OCAPI 客戶文件
  • userId (建議) - 已登入購物者的唯一識別碼。此參數讓 Einstein 能夠在多個裝置上,連結相同的登入使用者。
    • 從傳統 Commerce Cloud 網店發出 API 要求時,請使用 cquid Cookie 值來符合傳統網店上的自動活動追蹤。如需更多資訊,請參閱瀏覽器型本機資料儲存
    • 使用 OCAPI 或 Salesforce Commerce API 時,請使用已註冊登入回應的 hashed_login 值以符合自動活動。如需更多資訊,請參閱 OCAPI 客戶文件

為避免潛在的惡意活動,使用者識別碼參數必須是非連續的形式。參數不應包括序列、模式、IP 位址、電子郵件地址、姓名或與特定人員相關的任何內容。所有使用者識別碼參數必須透過雜湊或其他方法,遵守《一般資料保護規則》(General Data Protection Regulation,GDPR)。