本頁面將介紹實體，以及如何根據單一企業網站上的多個品牌或產品，擷取各種使用者行為，並說明實體的使用方式和用途。
在多數情況下，Vertex AI Search for Commerce 不需要實體。不過，如果零售商透過單一產品目錄服務多個品牌或區域，使用實體可獲得更出色的成效。
總覽
在專案中設定多個實體，可考量不同地區/國家/地區的購物者，或在屬於您企業的不同品牌網站購物的購物者，其行為和偏好設定。
用途範例：兩個國家/地區
零售商「Example Organization」在美國和加拿大都有網路據點。
舉例來說，Example Organization 希望放送的瀏覽和搜尋結果，以及自動完成建議，都能考量到兩個國家/地區購物者的差異。因此，Example Organization 指定了兩個實體：org_us 和 org_ca。
系統會根據購物者造訪的網站 (.com 或 ca)，為使用者事件加上實體值標記。購物者提出搜尋要求時，要求中會包含實體值。
這兩個國家/地區在 7 月都有重要節慶，但日期不同。設定實體後，當購物者在 Example Organization 網站搜尋 July 時，系統會優先向美國購物者顯示美國國慶日主題商品，向加拿大購物者顯示加拿大國慶日主題商品。
同樣地，向加拿大購物者顯示的建議，也比較可能是加拿大國慶日商品，而非美國國慶日商品。
使用案例範例：收購
企業範例機構最近收購了新創範例機構。 目錄已合併，但 Startup 品牌和網站會保留，因為有忠實追隨者。
企業會建立實體 startup，用來標記源自新創公司網站的使用者事件。這樣一來，系統向 Startup 網站提供的搜尋、瀏覽、自動完成和建議，就會考量 Startup 網站購物者的偏好。
多個專案或多個實體？
設定商家適用的 Vertex AI Search 時，您可以在同一個專案中使用不同的專案或實體，為不同的購物者族群取得不同的建議。
部分應用程式需要個別專案。如果是其他應用程式，設定實體是較好的解決方案。
如有下列情況，請使用 entities：
實體之間完全或部分共用的目錄
原因如下：
同一國家/地區或語言區域內有多個品牌，例如原始品牌和收購品牌
google_home和nest。同一國家/地區內的多個區域，例如
enterprise_east和enterprise_west。同一品牌，但位於多個國家/地區，且使用相同語言，例如
brand_us和brand_ca。
如有下列情況，請使用個別專案，而非實體：
無法合併的目錄，或合併後幾乎沒有重疊的目錄。
需要不同語言的實體。 每個專案只能使用一種語言。
使用者事件和實體
如要使用實體功能，請在使用者事件中新增實體欄位。
搜尋和自動完成：在
search類型的使用者事件中加入entity欄位。在其他使用者事件類型中加入實體欄位有助於排解問題，但不會影響搜尋或自動完成回應的品質。
如要取得建議：盡可能在多種使用者事件類型中加入實體欄位。
通常需要 30 到 90 天的使用者事件資料，實體功能才會傳回最佳建議。
如果要求中缺少實體，要求不會對結果中的實體做出任何假設。系統會根據指定實體和未指定實體的使用者事件，提供平均結果。
搜尋和實體
如要取得考量實體的搜尋或瀏覽結果，請按照下列步驟操作：
在搜尋使用者事件 (
eventType="search") 時，請加入entity欄位。如需範例，請參閱「搜尋」使用者事件的完整物件範例。在搜尋要求中新增
entity欄位。如要瞭解如何提出搜尋要求，請參閱「取得搜尋結果」。
自動完成和實體
如要取得將實體納入考量的自動完成結果，請按照下列步驟操作：
建議和實體
將 entity 欄位新增至使用者事件後，即可利用實體取得建議，不需採取任何進一步動作。這是因為實體值是使用者事件的一部分，而使用者事件會納入對 predict 方法的呼叫。