前提条件を設定する

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

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

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

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

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

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

AI Commerce Search を設定する

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

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

AI Commerce Search を設定するには:

  1. コンソールで [AI Commerce Search] ページに移動します。 Google Cloud

    Gemini Enterprise for Customer Experience の [AI Commerce Search] ページに移動

  2. [AI Commerce Search を設定する] ページで、[API を有効にする] をクリックします。

  3. [AI Commerce Search] と [Recommendations AI] が [オン] と表示されたら、 [続行] をクリックします。

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

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

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

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

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

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

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

  1. プロジェクトの Google Cloud コンソールで、[Gemini Enterprise for Customer Experience の AI Commerce Search] ページに移動します。

    Gemini Enterprise for Customer Experience の [AI Commerce Search] ページに移動

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

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

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

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

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

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

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

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

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

AI Commerce Search をオフにする

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

AI Commerce Search をオフにするには、次の手順を行います。

  1. [AI Commerce Search API /サービスの詳細] ページに移動します。 Google Cloud コンソール。

    AI Commerce Search API サービスの詳細ページに移動

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

  3. [AI Commerce Search API を無効にする] ボックスで、[無効にする] をクリックします。

AI Commerce Search を使ってみる

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

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

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

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

これらのパネルを使用して、データをインポートし、AI Commerce 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 コンソール ダッシュボードに AI Commerce Search プロジェクトのシステム状態が表示されます。コンソール ダッシュボードでは、リソースを管理し、アクティビティをモニタリングできます。

Gemini Enterprise for Customer Experience コンソールの AI Commerce Search に移動

API キーを作成する

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

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

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

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

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

    • 生成された API キーをメモします。このキーは、ユーザー イベント ロギングを呼び出すときに使用します。

  4. セキュリティを強化するには、API キーに API 制限 を追加して、AI Commerce Search サービス へのアクセスをhttps://retail.googleapis.com/*で制限します。

次のステップ