實作使用者事件

如何設定使用者事件：

使用者資訊

visitorId 值代表專屬使用者 ID。您記錄使用者事件時必須使用這項屬性。當您記錄含有 visitorId 值的使用者事件，以及 (如有) userId 值時，系統會納入 (UserInfo)。

每當使用者登入網站時，您可以使用選用的 userId 值，為使用者在各裝置上提供專屬的永久 ID。為使用者記錄 userId 後，商務用途的 Vertex AI Search 就能在多個裝置 (例如行動裝置和網頁瀏覽器) 上，為單一使用者產生更貼近個人需求的結果。

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

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

如果您為攝入的使用者事件提供自訂屬性，請務必將這些屬性納入與預測要求相關聯的使用者事件中。匯入事件和透過預測要求提供的事件之間，自訂屬性的格式必須一致。這可在訓練模型和提供預測結果時使用這些自訂屬性，有助於提升推薦品質。

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

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

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

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