このページでは、Vertex AI Search for Retail のインタラクティブなチュートリアルのセットを紹介します。これらのチュートリアルには、Google Cloud Shell Editor で実行できるアクションが含まれています。このツールを使用すると、クラウド ネイティブ アプリケーションの作成、ビルド、テスト、実行、デバッグをブラウザから直接行うことができます。
概要
学習したい内容に応じてさまざまなチュートリアルをお試しください。
プロジェクトを開始する場合は、カタログ情報をインポートするのチュートリアルをお試しください。ここでは、商品をカタログにインポートする方法を学習します。たとえば、さまざまな検索機能を試すことができます。次に、過去のユーザー イベントのインポートのチュートリアルをご覧ください。Vertex AI Search for Retail は、ユーザー イベントを使用して最初のおすすめ情報と検索結果を生成します。その後、リアルタイムのユーザー イベントを記録するチュートリアルを試します。リアルタイムのユーザー イベントは、高品質で目的に合った結果を提供します。
検索の一般的な仕組みについては、検索のチュートリアルをご覧ください。
サービス構成と制御を使用して検索を構成する方法については、次のチュートリアルをご覧ください。
カタログ情報を更新する必要がある場合は、カタログ情報を管理するチュートリアルをご覧ください。
在庫を更新する方法については、検索の在庫を更新するチュートリアルをご覧ください。
リアルタイムのユーザー イベントを記録、表示、削除する方法については、リアルタイムのユーザー イベントを記録するチュートリアルをご覧ください。
レコメンデーションの使用を計画している場合は、カタログとユーザー イベントのインポートと管理に関するチュートリアルをご覧ください。
カタログ情報をインポートする
このチュートリアルでは、カタログ情報をインポートして最新の状態に保つ方法について説明します。
BigQuery からカタログデータをインポート
このチュートリアルでは、BigQuery テーブルを使用して、大量のカタログデータを無制限にインポートする方法を説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
Cloud Storage からカタログデータをインポートする
このチュートリアルでは、多数のアイテムをカタログにインポートする方法について説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
インラインでカタログデータをインポートする
このチュートリアルでは、商品をインラインでカタログにインポートする方法について説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
カタログ情報を管理する
このチュートリアルでは、カタログをインポートした後に商品情報を管理する方法について説明します。カタログ内の商品の読み取り、書き込み、削除を行うことができます。
選択した言語で API を呼び出す方法を学びます。
商品の作成、取得、更新、削除のチュートリアル
このチュートリアルでは、API メソッドの使用方法について説明します。このメソッドでは次の処理を行います。
- 商品を作成する
- 商品を入手する
- 商品を更新する
- 商品を削除
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
商品作成のチュートリアル
このチュートリアルでは、単一の商品を作成する方法について説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
商品取得のチュートリアル
このチュートリアルでは、商品アイテムを取得する方法について説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
商品更新のチュートリアル
このチュートリアルでは、カタログ内の商品を更新する方法について説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
商品削除のチュートリアル
このチュートリアルでは、カタログから商品を削除する方法について説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
過去のユーザー イベントをインポートする
このチュートリアルでは、過去のイベントからユーザー イベントデータを一括インポートする方法について説明します。モデルでは、トレーニングにユーザー イベント データが必要です。
Cloud Storage チュートリアルからイベントをインポートする
このチュートリアルでは、Cloud Storage からユーザー イベントをインポートする方法を説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
BigQuery チュートリアルからイベントをインポートする
このチュートリアルでは、BigQuery からユーザー イベントをインポートする方法を説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
イベントのインライン チュートリアルをインポートする
このチュートリアルでは、インラインでユーザー イベント データをインポートする方法を説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
リアルタイムのユーザー イベントを記録する
このチュートリアルでは、リアルタイムのユーザー イベントを記録、表示、削除する方法について説明します。Vertex AI Search for Retail は、リアルタイムのユーザー イベントを使用しておすすめ情報と検索結果を生成します。有効な商品情報を使用してできるだけ多くの種類のユーザー イベントを記録することで、結果の品質が向上します。
ユーザー イベント作成のチュートリアル
このチュートリアルでは、userEvents.write メソッドを使用してユーザー イベントを記録する方法を説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
ユーザー イベントの再結合のチュートリアル
このチュートリアルでは、POST リクエストを userEvents:rejoin エンドポイントに送信してユーザー イベントを再結合する方法について説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
ユーザー イベント チュートリアルを削除する
このチュートリアルでは、ユーザー イベントを完全に削除する方法を説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
チュートリアルを検索
search() メソッドは、検索クエリや filter、facet、order_by などのパラメータに従ってカタログの検索に使用されます。
デフォルトでは、検索レスポンスには、関連性の高い順に並べられた妥当な数の検索結果が含まれます。
クエリのチュートリアル
このチュートリアルでは、シンプルな検索クエリを送信してそのレスポンスを分析する方法について説明します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
ページ分けのチュートリアル
このチュートリアルでは、検索リクエストでページネーションを制御する方法を示します。買い物客が店内の商品を検索する際に、検索結果でナビゲーションを向上させることができます。たとえば、ページサイズ機能を使用して検索レスポンス内のアイテム数を制限したり、オフセット機能を使用して目的のページにジャンプしたりできます。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
クエリ拡張のチュートリアル
このチュートリアルでは、クエリ拡張機能を有効にする方法について説明します。買い物客があいまいなまたは複数の単語からなる検索フレーズを使用すると、空のレスポンスが返される場合があります。クエリ拡張を有効にすると、リクエストが分析され、解析された検索クエリに基づいて商品の拡張リストが返されます。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
フィルタリングのチュートリアル
このチュートリアルでは、フィルタリング機能について説明します。ご自身やお客様のニーズに応じて、検索リクエストを細かく調整できます。 単一または複数のフィールドでフィルタしたり、テキスト フィールドまたは数値フィールド、またはその両方でフィルタすることもできます。式言語を使用すると、フィールドごとに述語を作成したり、論理演算子を使用してさまざまな式を結合したりできます。たとえば、靴を探している買い物客はフィルタを使用して、目的のブランドや色に検索結果を絞り込めます。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
並べ替えのチュートリアル
このチュートリアルでは、検索レスポンス内のアイテムを並べ替える方法について説明します。買い物客がサイトで商品を検索する際に、複数のフィールドで並べ替えられた結果を表示できます。たとえば、買い物客が価格と割引が最高のドレスを探しているとします。ここでは価格と割引のフィールドが複数あります。買い物客には価格順の洋服が表示され、同じ価格の洋服については割引順に表示されます。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
ブーストのチュートリアル
このチュートリアルでは、検索結果における商品ブーストの例をいくつか紹介します。ブースティングでは、商品にブーストを適用して、検索結果でその商品に優先順位を付けることができます。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
リダイレクト制御のチュートリアル
このチュートリアルでは、リダイレクト制御の使用方法について説明します。リダイレクト制御を使用すると、ユーザーが特定の検索クエリを使用するときにリダイレクトできる URL を指定できます。たとえば、ユーザーが「サステナブルな製品」をリクエストした場合は、作業中の環境ブランドを含むページにリダイレクトできます。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
検索対象の在庫を更新する
Product の作成、読み取り、更新、削除（CRUD）メソッドは Product の属性の広範な変更に使用されますが、在庫に固有のフィールドをさまざまな粒度で更新するために使用する一連の Product メソッドもあります。次の Product フィールドが広告枠フィールドとみなされます。
Product.price_infoProduct.availabilityProduct.available_quantityProduct.fulfillment_info
フルフィルメント追加のチュートリアル
このチュートリアルでは、AddFulfillmentPlaces メソッドを使用して商品のフルフィルメント情報を更新する方法について説明します。このようにして、検索は商品が入手可能で注文が納品可能な場所の最新情報を表示できます。たとえば、買い物客が店で青いジーンズを探しているが、在庫切れになっているとします。このショップや他のショップにジーンズが再入荷した時点で、買い物客は更新情報を確認して、注文を続行することができます。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
フルフィルメント削除のチュートリアル
このチュートリアルでは、RemoveFulfillmentPlaces メソッドを使用して商品のフルフィルメント情報を更新する方法について説明します。このようにして、検索は商品が入手不可能で注文が納品不可能な場所の最新情報を表示できます。たとえば、買い物客が店で青いジーンズを探しているとします。ジーンズがこの店舗で在庫切れになった場合、買い物客はこれを見ると注文を続行できません。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。
在庫設定のチュートリアル
このチュートリアルでは、商品全体を更新する代わりに、SetInventory メソッドを使用して在庫の更新を push する方法を示します。
このタスクを Cloud Shell エディタで直接行う際の順を追ったガイダンスについては、[ガイドを表示] をクリックしてください。