前提条件を設定する

新しいプロジェクトに小売業向け Vertex AI Search を設定するには、次の操作を行う必要があります。

  1. 新しいプロジェクトを作成するか、既存のプロジェクトを設定する
  2. 小売業向け Vertex AI Search を有効にする
  3. 商品カタログとユーザー イベントをインポートする

Google Cloud プロジェクトを作成する

  1. Google Cloud コンソールの [リソースの管理] ページで、Google Cloud プロジェクトを作成または選択します。

    [リソースの管理] ページに移動

  2. Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。

小売業向け Vertex AI Search の設定

小売業向け Vertex AI Search を使用する手順は次のとおりです。また、小売業向け Vertex AI Search を有効にしてレコメンデーションを使用する場合は、費用がクエリ数に基づくことに注意してください。小売業向け Vertex AI Search の料金の詳細については、小売業向け Vertex AI Search の料金をご覧ください。

新しいプロジェクトの場合

小売業向け Vertex AI Search の設定

  1. Google Cloud コンソールで [小売業向け Vertex AI Search] ページに移動します。

    [Search for Retail] ページに移動します

  2. [小売業向け Vertex AI Search を設定する] ページで、[API を有効にする] をクリックします。

  3. 小売業向け Vertex AI SearchRecommendations AIオン と表示されたら、[続行] をクリックします。

  4. データ使用に関する 業種別 Vertex AI Search のデータ利用規約を確認し、データ利用規約に同意した場合は、[同意する] をクリックします。検索の利用規約に同意すると、Google Cloud コンソールから確認が届きます。

  5. レコメンデーションのみでプロジェクトを使用する場合は、[開始] をクリックします。

  6. レコメンデーション機能に加えて検索機能を有効にするには、次の手順で操作します。

    1. Continue をクリックし、Turn on search (Optional) ページで Turn on をクリックします。
    2. [利用開始] をクリックします。

    Google Cloud コンソールに、有効にした小売業向け Vertex AI Search コンポーネントが表示されます。これで、プロジェクトの初期設定を構成できます。

既存のプロジェクトの場合

既存のプロジェクトで続行するには、次の手順を完了します。

  1. プロジェクトの Google Cloud コンソールで、Search for Retail ページに移動します。

    Search for Retail ページに移動します

  2. [データ利用規約] ページで、Discovery Solutions のデータ利用規約を確認し、規約に同意する場合は [同意する] をクリックします。

  3. レコメンデーションのみでプロジェクトを使用する場合は、[開始] をクリックします。

  4. レコメンデーション機能に加えて検索機能を有効にするには、次の手順で操作します。

    1. Continue をクリックし、Turn on search (Optional) ページで Turn on をクリックします。
    2. [利用開始] をクリックします。

検索結果の機能をオフにする

検索が不要になった場合は、サポート チケットを送信することでオフにできます。

チケットを正しいコンポーネントに設定するには、次のフィールドを選択します。

  • カテゴリ: ML
  • コンポーネント: 小売業向け Vertex AI Search: 検索とブラウジング
  • サブコンポーネント: アカウントの管理と請求

サポート チケットの作成の詳細については、サポートの利用をご覧ください。

小売業向け Vertex AI Search の有効化

小売業向け Vertex AI Search を無効にすることで、いつでも小売業向け Vertex AI Search をオフにできます。この操作により、レコメンデーションと検索の両方がオフになります。

小売業向け Vertex AI Search を無効にするには、次の手順を行います。

  1. Google Cloud コンソールの 小売業向け Vertex AI Search API / サービスの詳細ページに移動します。

    小売業向け Vertex AI Search API サービスの詳細ページに移動

  2. [API を無効にする] をクリックします。

  3. [小売業向け Vertex AI Search API を無効にする] ボックスで、[無効にする] をクリックします。

小売業向け Vertex AI Search を使ってみる

新しいプロジェクトに小売業向け Vertex AI Search を設定すると、Google Cloud コンソールに次の 3 つのパネルが表示され、小売業向け Vertex AI Search プロジェクトの構成に役立ちます。

  • データ > カタログ:製品カタログとカタログをインポートするためのリンクが表示されます。

  • [データ] > [イベント]: ユーザー イベントと過去のユーザー イベントをインポートするためのリンクが表示されます。

  • サービス構成: サービス構成の詳細と、新しいサービス構成を作成するためのリンクが含まれます。

これらのパネルを使用して、データをインポートし、小売業向け Vertex AI Search プロジェクトの初期構成を作成できます。

商品カタログをインポートする

商品カタログをインポートするには、データソースに対して一連の手順を行います。 商品カタログの詳細については、カタログ情報のインポートをご覧ください。

Merchant Center の同期

  1. [商品カタログのインポート] をクリックして、[データのインポート] パネルを開きます。
  2. [商品カタログ] を選択します。
  3. データソースとして [Merchant Center の同期] を選択します。
  4. Merchant Center アカウントを選択します。アカウントが表示されない場合は、[ユーザー アクセス] をオンにします。
  5. 省略可: [Merchant Center フィード フィルタ] を選択して、選択したフィードからの商品のみをインポートします。

    指定しない場合、すべてのフィード(今後のフィードを含む)から商品がインポートされます。
  6. 省略可: 特定の国または言語をターゲットとする商品のみをインポートするには、[詳細設定を表示] を展開して、フィルタする Merchant Center の販売先の国と言語を選択します。
  7. カタログのアップロード先のブランチを選択します。
  8. [インポート] をクリックします。

Cloud Storage

  1. [商品カタログのインポート] をクリックして、[データのインポート] パネルを開きます。
  2. データソースとして 商品カタログ を選択します。
  3. カタログのアップロード先のブランチを選択します。
  4. スキーマとして [Retail 商品カタログ スキーマ] を選択します。
  5. データの Cloud Storage のロケーションを入力します。
  6. 検索が有効ではない場合は、商品レベルを選択します。

    初めてカタログをインポートする場合や、またはカタログを完全に削除した後、カタログを再インポートする場合は、商品レベルを選択する必要があります。商品レベルの詳細をご覧ください。データをインポートした後に商品レベルを変更するには、かなりの手間がかかります。

    重要: バリアントとして取り込まれた商品カタログを含むプロジェクトに対して検索を有効にすることはできません。
  7. [インポート] をクリックします。

BigQuery

  1. [商品カタログのインポート] をクリックして、[データのインポート] パネルを開きます。
  2. [商品カタログ] を選択します。
  3. データソースとして BigQuery を選択します。
  4. カタログのアップロード先のブランチを選択します。
  5. 次のいずれかのスキーマを選択します。
  6. データが配置される BigQuery テーブルを入力します。
  7. 省略可: [詳細設定を表示] で、データの一時的なロケーションとして、プロジェクト内の Cloud Storage バケットのロケーションを入力します。

    指定しないと、デフォルトのロケーションが使用されます。指定する場合、BigQuery と Cloud Storage バケットは同じリージョン内に存在する必要があります。
  8. 検索が有効ではなく、Merchant Center スキーマを使用している場合は、商品レベルを選択します。

    初めてカタログをインポートする場合や、またはカタログを完全に削除した後、カタログを再インポートする場合は、商品レベルを選択する必要があります。商品レベルの詳細をご覧ください。データをインポートした後に商品レベルを変更するには、かなりの手間がかかります。

    重要: バリアントとして取り込まれた商品カタログを含むプロジェクトに対して検索を有効にすることはできません。
  9. [インポート] をクリックします。

過去のユーザー イベントをインポートする

過去のユーザー イベントをインポートするには、データソースに対して一連の手順を行います。 過去のユーザー イベントの詳細については、過去のユーザー イベントのインポートをご覧ください。

Cloud Storage

  1. [ユーザー イベントのインポート] をクリックして、[データのインポート] パネルを開きます。
  2. [User events] を選択します。
  3. データソースとして [Google Cloud Storage] を選択します。
  4. スキーマとして [Retail ユーザー イベント スキーマ] を選択します。
  5. データの Cloud Storage のロケーションを入力します。
  6. [インポート] をクリックします。

BigQuery

  1. [ユーザー イベントのインポート] をクリックして、[データのインポート] パネルを開きます。
  2. [User events] を選択します。
  3. データソースとして [BigQuery] を選択します。
  4. データスキーマを選択します。

  5. データが配置される BigQuery テーブルを入力します。
  6. 省略可: データの一時的なロケーションとして、プロジェクト内の Cloud Storage バケットのロケーションを入力します。
    指定されていない場合、デフォルトのロケーションが使用されます。指定されている場合、BigQuery と Cloud Storage バケットは同じリージョン内に存在する必要があります。
  7. 省略可: [詳細設定を表示] で、データの一時的なロケーションとして、プロジェクト内の Cloud Storage バケットのロケーションを入力します。

    指定しない場合、デフォルトのロケーションが使用されます。指定する場合、BigQuery と Cloud Storage バケットは同じリージョン内に存在する必要があります。
  8. [インポート] をクリックします。

サービス構成を作成する

サービス構成とは、検索結果またはレコメンデーション結果の生成に使用されるモデルまたは一連のコントロールに関連付けるサービス提供エンティティです。

サービス構成を作成するには、次の手順を行います。

  1. [サービス提供構成] パネルで、[サービス提供構成を作成] をクリックします。
  2. [サービス提供構成の作成] ページで、サービス提供構成を使用するプロダクトとして [検索] を選択します。
  3. サービス提供構成の名前を指定します。

    名前は 1,024 文字以下にしてください。使用できるのは、英数字、アンダースコア、ハイフン、スペースのみです。
  4. 省略可: 必要に応じて ID を更新します。

    ID は指定した名前から生成され、プロジェクト全体で一意である必要があります。50 文字以下で設定し、スペースを含めることはできません。
  5. [続行] をクリックします。
  6. このサービス提供構成で動的ファセットを有効にするかどうかを選択します。
  7. 検索を最適化するサービス提供コントロールを選択または作成します。

    コントロールの詳細については、コントロールの作成と管理をご覧ください。

リソースを管理し、アクティビティをモニタリングする

プロジェクトの初期構成が完了すると、Google Cloud コンソールのダッシュボードに小売業向け Vertex AI Search プロジェクトのシステム状態が表示されます。コンソールでは、リソースを管理し、アクティビティをモニタリングできます。

Search for Retail コンソールに移動

API キーを作成する

JavaScript ピクセルまたはタグ マネージャー タグを使用してユーザーのブラウザからイベントをキャプチャする場合は、API キーが必要です。ユーザー イベントをキャプチャする方法について詳しくは、リアルタイムのユーザー イベントを記録するをご覧ください。

userEvents.Collect メソッド呼び出し用の API キーを作成するには、次の手順を行います。

  1. Google Cloud コンソールの [認証情報] ページに移動します。

  2. Google Cloud コンソール ページの上部にあるプロジェクトのプルダウンで、プロジェクトを選択します(プロジェクトがすでに選択されている可能性もあります)。

  3. [認証情報を作成] をクリックして [API キー] を選択します。 ウェブサイトのアプリケーション制限を追加しないでください。一部のユーザーのプライバシー設定は、参照 URL を渡さないことがわかっています。

    • 生成された API キーをメモします。このキーは、ユーザー イベント ロギングを呼び出すときに使用します。
  4. セキュリティを強化するには、API キーに API 制限を追加して、https://retail.googleapis.com/* での Vertex AI Search for Retail サービスへのアクセスを制限します。

次のステップ