傳送個人資料

開發人員可以設定兩種方式，讓客戶將購物者個人資料屬性傳送給 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 需要這些使用者識別碼中的其中一項，來識別大量上傳中的購物者。

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

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

• 一次只可上傳一個檔案。但是，您可以一個接一個上傳多個檔案。
• 最大檔案大小為 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 客戶文件。