實作使用者事件

如要設定使用者事件，請按照下列步驟操作：

使用者資訊

visitorId 值代表專屬使用者 ID。記錄使用者事件時，這個參數為必填。記錄含有 visitorId 值的使用者事件時，系統會一併納入 (UserInfo) 和 userId 值 (如有)。

每當使用者登入網站時，您都可以使用選用的 userId 值做為使用者的永久專屬 ID，在不同裝置上識別使用者。記錄使用者的 userId 後，Vertex AI Search for commerce 就能在多部裝置 (例如行動裝置和網頁瀏覽器) 上，為同一位使用者生成更個人化的結果。

記錄使用者事件時，請務必加入事件發生時間的準確時間戳記。準確的時間戳記可確保事件以正確順序儲存。使用代碼管理工具和 JavaScript 像素收集事件時，系統會自動記錄時間戳記。匯入事件時，您必須在 eventTime 欄位中提供時間戳記，格式須符合 RFC 3339 規定。

您可以為使用者事件加入其他自訂屬性和功能。這樣一來，當您使用建議時，系統就能為使用者提供更精確的建議。如要新增自訂屬性，請在記錄使用者事件時使用 attributes。

如果您為擷取的使用者事件提供自訂屬性，請務必在與預測要求相關聯的使用者事件中一併加入這些屬性。自訂屬性的格式在匯入的事件和預測要求提供的事件中必須一致。這樣一來，您就能在訓練模型和提供預測結果時使用這些自訂屬性，進而提升建議品質。

您可以使用 text 欄位提供自訂文字值，或使用 number 欄位提供自訂數值。

舉例來說，以下顯示要求中記錄使用者事件的 attributes 區段：

"attributes": {
  "user_age": {"text": ["teen", "young adult"]},
  "user_location": {"text": ["CA"]}
}

成功記錄使用者事件是取得高品質結果的重要因素。您應監控事件記錄錯誤率，並視需要採取行動。詳情請參閱「設定資料上傳問題的快訊」。