設定必要條件

為新專案設定 Vertex AI Search for Commerce 前，請務必完成下列事項：

1. 建立新專案或設定現有專案
2. 啟用 Vertex AI Search for Commerce
3. 匯入產品目錄和使用者事件

建立 Google Cloud 專案

1. 在 Google Cloud 控制台的「管理資源」頁面中，選取或建立 Google Cloud 專案。

   前往「管理資源」頁面

2. 確認 Cloud 專案已啟用計費功能。瞭解如何檢查專案是否已啟用計費功能。

設定 Vertex AI Search 電子商務套件

如要使用 Vertex AI Search for Commerce，請按照下列步驟操作。此外，如果您啟用商家適用的 Vertex AI Search 並使用建議功能，請注意費用是根據查詢次數計算。如要進一步瞭解 Vertex AI Search 電子商務套件的定價，請參閱「Vertex AI Search 電子商務套件費用」。

重要事項： 如要使用 Vertex AI Search for Commerce，您必須為每個專案接受 Vertex AI Search for Industry 條款。

新專案

如要設定 Vertex AI Search for Commerce，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Vertex AI Search for commerce」頁面。

   前往「Search for commerce」(搜尋電子商務) 頁面

2. 在「設定 Vertex AI Search for Commerce」頁面中，按一下「啟用 API」。

3. 當「商家適用的 Vertex AI Search」和「Recommendations AI」顯示為「開啟」時，請按一下「繼續」。

4. 請詳閱資料使用適用的 Vertex AI Search for Industry 條款，並點選「接受」，表示同意資料使用條款。接受搜尋條款後，您會收到 Google Cloud 控制台的確認訊息。

5. 如要使用僅含建議的專案，請按一下「開始使用」。

6. 如要啟用搜尋功能，並繼續接收建議，請按照下列步驟操作：

   1. 依序點選「繼續」和「開啟」，然後前往「開啟搜尋功能 (選用)」頁面。
   2. 點選「開始使用」。

   Google Cloud 控制台會顯示您已啟用的商家適用的 Vertex AI Search 元件。您現在可以設定專案的初始設定。

現有專案

如要繼續處理現有專案，請完成下列步驟：

1. 前往專案的 Google Cloud 控制台，然後前往「Search for commerce」(搜尋電子商務) 頁面。

   前往「Search for commerce」(搜尋電子商務) 頁面

2. 在「資料使用條款」頁面中，詳閱 Discovery Solutions 資料使用條款，然後按一下「接受」。

3. 如要只使用建議專案，請按一下「開始使用」。

4. 如要開啟搜尋功能 (除了建議)，請按照下列步驟操作：

   1. 依序點選「繼續」和「開啟」，然後前往「開啟搜尋功能 (選用)」頁面。
   2. 點選「開始使用」。

重要事項： 接受資料使用條款前，請確認您擁有專案的零售管理員或擁有者角色。

關閉搜尋功能

如果不想再使用搜尋功能，可以提交支援單來停用。

如要將支援單設定為正確的元件，請選取下列欄位：

• 類別：機器學習
• 元件：Vertex AI Search 電子商務套件：搜尋與瀏覽
• 子元件：帳戶管理與帳單

如要進一步瞭解如何建立支援單，請參閱「取得支援」一文。

關閉 Vertex AI Search for Commerce

你隨時可以停用 Vertex AI Search for Commerce。 這樣一來，系統就會關閉推薦內容和搜尋功能。

如要關閉 Vertex AI Search 電子商務套件，請完成下列步驟：

1. 前往Google Cloud 控制台的「Vertex AI Search for Retail API/Service Details」(Vertex AI Search for Retail API/服務詳細資料) 頁面。

   前往 Vertex AI Search for Commerce API 服務詳細資料頁面

2. 點選「停用 API」。

3. 在「要停用 Vertex AI Search for Commerce API 嗎？」方塊中，按一下「停用」。

注意： 停用 Vertex AI Search for Commerce API 後，專案需要幾小時才能停用 Vertex AI Search for Industry 資料使用條款。

開始使用 Vertex AI Search for Commerce

為新專案設定商家適用的 Vertex AI Search 時，Google Cloud 控制台會顯示下列三個面板，協助您設定商家適用的 Vertex AI Search 專案：

• 資料 >「目錄」：顯示產品目錄和匯入目錄的連結。

• 「資料」 >「事件」：顯示使用者事件和匯入過往使用者事件的連結。

• 供應設定：包含供應設定的詳細資料，以及建立新供應設定的連結。

您可以使用這些面板匯入資料，並為商家適用的 Vertex AI Search 專案建立初始設定。

匯入產品目錄

如要匯入產品目錄，請完成資料來源的一系列步驟。 如要進一步瞭解產品目錄，請參閱匯入目錄資訊。

已淘汰： Merchant Center 連接器已淘汰，僅供現有使用者使用。新使用者必須使用目錄 API 或 BigQuery 匯入目錄。

Merchant Center 同步處理作業

1. 按一下「匯入產品目錄」，開啟「匯入資料」面板。
2. 選擇「產品目錄」。
3. 選取「Merchant Center 同步」做為資料來源。
4. 選取 Merchant Center 帳戶。如果沒有看到帳戶，請檢查「使用者存取權」。
5. 選用：選取「Merchant Center 動態饋給篩選器」，只匯入所選動態饋給的商品。
   
   如未指定，系統會匯入所有動態饋給的商品 (包括日後新增的動態饋給)。
6. 選用：如要只匯入指定國家/地區或語言的商品，請展開「顯示進階選項」，然後選取要篩選的 Merchant Center 銷售國家/地區和語言。
7. 選取要上傳目錄的分支版本。
8. 按一下「匯入」。

Cloud Storage

1. 按一下「匯入產品目錄」，開啟「匯入資料」面板。
2. 選擇「產品目錄」做為資料來源。
3. 選取要上傳目錄的分支版本。
4. 選擇「零售產品目錄結構定義」做為結構定義。
5. 輸入資料的 Cloud Storage 位置。
6. 如果未啟用搜尋功能，請選取產品層級。
   
   如果這是你第一次匯入目錄，或是清除目錄後重新匯入，則必須選取產品層級。進一步瞭解產品等級。匯入任何資料後，變更產品層級需要付出大量心力。
   
   重要事項：如果產品目錄是以子類的形式擷取，就無法為專案啟用搜尋功能。
7. 按一下「匯入」。

BigQuery

1. 按一下「匯入產品目錄」，開啟「匯入資料」面板。
2. 選擇「產品目錄」。
3. 選取「BigQuery」BigQuery做為資料來源。
4. 選取要上傳目錄的分支版本。
5. 選擇下列其中一個結構定義：
   • 零售產品目錄結構定義：Vertex AI Search for Commerce 的產品結構定義
   • Merchant Center：用於從 Merchant Center 大量匯入的結構定義
6. 輸入資料所在的 BigQuery 資料表。
7. 選用：在「顯示進階選項」下方，輸入專案中 Cloud Storage bucket 的位置，做為資料的暫時位置。
   
   如未指定，系統會使用預設位置。您指定的 BigQuery 和 Cloud Storage 值區必須位於同一區域。
8. 如果未啟用搜尋功能，且使用 Merchant Center 結構定義，請選取產品層級。
   
   如果這是你第一次匯入目錄，或是清除目錄後重新匯入，就必須選取產品層級。進一步瞭解產品等級。匯入任何資料後，變更產品層級需要付出大量心力。
   
   重要事項：如果產品目錄是以子類的形式擷取，就無法為專案啟用搜尋功能。
9. 按一下「匯入」。

匯入歷來的使用者事件

如要匯入歷來的使用者事件，請完成資料來源的一系列步驟。 如要進一步瞭解歷來的使用者事件，請參閱「匯入歷來的使用者事件」。

注意： 您也可以記錄即時使用者事件，藉此生成推薦內容和搜尋結果。詳情請參閱「記錄即時使用者事件」。

Cloud Storage

1. 按一下「匯入使用者事件」，開啟「匯入資料」面板。
2. 選擇「使用者事件」。
3. 選取「Google Cloud Storage」做為資料來源。
4. 選擇「零售使用者事件結構定義」做為結構定義。
5. 輸入資料的 Cloud Storage 位置。
6. 按一下「匯入」。

BigQuery

1. 按一下「匯入使用者事件」，開啟「匯入資料」面板。
2. 選擇「使用者事件」。
3. 選取「BigQuery」BigQuery做為資料來源。

4. 選取資料架構。

   • Google Analytics 4：用於 Google Analytics 4 事件。
   • Google Analytics 360：用於 Google Analytics 360 事件，除非您只從 Google Analytics 360 匯入事件 (僅限首頁瀏覽)，否則請使用這個選項 (在這種情況下，請使用零售業使用者事件結構定義)。
   • 零售業使用者事件結構定義：用於從 Google Analytics 以外的來源匯入事件，以及僅從 Google Analytics 360 匯入首頁瀏覽事件。
5. 輸入資料所在的 BigQuery 資料表。
6. 選用：在專案中輸入 Cloud Storage bucket 的位置，做為資料的暫時位置。
   如未指定，系統會使用預設位置。您指定的 BigQuery 和 Cloud Storage 值區必須位於同一區域。
7. 選用：在「顯示進階選項」下方，輸入專案中 Cloud Storage bucket 的位置，做為資料的暫時位置。
   
   如未指定，系統會使用預設位置。您指定的 BigQuery 和 Cloud Storage 值區必須位於同一區域。
8. 按一下「匯入」。

建立供應設定

供應設定是供應實體，可與模型或一組控制項建立關聯，用於產生搜尋或建議結果。

注意： Vertex AI Search for Commerce 會建立預設的服務設定，因此如要建立自訂服務設定，這個程序為選用步驟。

如要建立放送設定，請完成下列步驟：

1. 在「供應設定」面板中，按一下「建立供應設定」。
2. 在「建立供應設定」頁面中，選擇「搜尋」做為供應設定的適用產品。
3. 為放送設定命名。
   
   名稱長度不得超過 1024 個字元，且只能包含英數字元、底線、連字號和空格。
4. 選用：視需要更新 ID。
   
   ID 是根據您提供的名稱產生，且在整個專案中不得重複。長度不得超過 50 個字元，且不得包含空格。
5. 按一下「繼續」。
6. 選擇是否要為這項供應設定啟用動態切面。
7. 選擇或建立放送控制項，以利搜尋最佳化。
   
   如要進一步瞭解控制項，請參閱建立及管理控制項。

管理資源及監控活動

完成專案的初始設定後，Google Cloud 控制台資訊主頁會顯示商家適用的 Vertex AI Search 專案系統狀態。您可以在控制台資訊主頁管理資源及監控活動。

前往 Search for commerce 控制台

建立 API 金鑰

如果您使用 JavaScript 像素或代碼管理工具代碼，從使用者瀏覽器擷取使用者事件，則必須提供 API 金鑰。如要進一步瞭解如何擷取使用者事件，請參閱「記錄即時使用者事件」。

如要建立 API 金鑰來呼叫 userEvents.Collect 方法，請完成下列步驟：

1. 前往控制台的「憑證」頁面。 Google Cloud

2. 在 Google Cloud 控制台頁面頂端的專案下拉式選單中，選取專案 (專案可能已選取)。

3. 按一下「建立憑證」，然後選取「API 金鑰」。 請勿新增任何網站應用程式限制。已知部分使用者隱私權設定不會傳遞參照網址。

   • 請記下產生的 API 金鑰，呼叫使用者事件記錄時會用到。

4. 為提高安全性，請在 API 金鑰中新增 API 限制，限制對 https://retail.googleapis.com/* 的 Vertex AI Search for Commerce 服務存取權。

注意： API 金鑰僅用於驗證 userEvents.Collect 方法。 其他 API 方法則需要透過服務帳戶或使用者帳戶使用 OAuth 2.0。

後續步驟

• 限制 API 金鑰
• 向 Vertex AI Search 電子商務套件進行驗證
• 身分與存取權管理 (IAM)
• 導入商家適用的 Vertex AI Search