傳送個人資料

開發人員可以設定兩種方式，讓客戶將購物者個人資料屬性傳送給 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。

上傳購物者個人資料大量資料至 Einstein 

準備好購物者個人資料的大量資料檔案後，請將個別檔案以 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)。

Note

開始使用
設定 Einstein Profile Connector
傳送個人資料
設定個人資料
常見問題
設定 Einstein Recommendations