エンティティ

このページでは、エンティティの概要、使用方法、使用理由について説明します。

ほとんどのユースケースでは、小売業向け Vertex AI Search でエンティティは必要ありません。ただし、1 つの商品カタログから複数のブランドや地域にサービスを提供している小売店は、エンティティを使用するとより良い結果を得ることができます。

概要

プロジェクトに複数のエンティティを設定すると、異なる地域や国に居住している買い物客や、企業に属する異なるブランドのサイトで買い物をする買い物客のさまざまな行動や好みを考慮できます。

ユースケースの例: 2 か国

小売業者の Example Organization は、米国とカナダの両方でウェブサイトを運営しています。

たとえば、ある組織が 2 つの国における買い物客の違いを考慮したブラウジング結果、検索結果、自動入力候補を表示したいとします。したがって、Example Organization は org_us と org_ca の 2 つのエンティティを指定します。

ユーザー イベントには、買い物客がアクセスしたウェブサイト（.com または ca）に応じてエンティティ値がタグ付けされます。買い物客が検索リクエストを行うと、エンティティ値がリクエストに含まれます。

7 月には両国にとって大事な祝日がありますが、祝う内容は異なります。エンティティを設定すると、買い物客が Example Organization のサイトで July を検索すると、アメリカの買い物客には最初に 7 月 4 日にテーマ化されたアイテムが提供され、カナダの買い物客はカナダの日をテーマとするアイテムを受け取ります。

同様に、カナダの買い物客へのおすすめには、7 月 4 日の商品よりもカナダの日の商品が表示される傾向があります。

ユースケースの例: 買収

Enterprise Example Organization は最近、Startup Example Organization を買収しました。カタログは結合されていますが、Startup のブランドとウェブサイトはロイヤリティが高いため、維持されています。

Startup サイトから抽出されたユーザー イベントにエンティティ startup が作成されます。これにより、Startup サイトに表示される検索、参照、予測入力、レコメンデーションの候補で、Startup サイトの買い物客の好みが考慮されます。

複数のプロジェクトと複数のエンティティ

小売業向け Vertex AI Search を設定するときに、異なるプロジェクトまたは同じプロジェクト内の異なるエンティティを使用して、さまざまな買い物客のグループに異なる候補を取得できます。

アプリケーションによっては、個別のプロジェクトが必要になる場合があります。他のアプリケーションの場合は、エンティティを設定する方が適切なソリューションです。

エンティティは、次のような場合に使用します。

  • エンティティ間の完全共有または一部共有カタログ

  • 次のいずれか 1 つ以上に該当する場合:

    • 同じ国または言語エリアに複数のブランドがある場合。たとえば、元のブランドと買収したブランド（google_home と nest）がある場合。

    • 同じ国の複数のリージョン（例: enterprise_east、enterprise_west）。

    • ブランドは 1 つで、同じ言語を使用する複数の国（例: brand_us、brand_ca）。

次の場合は、エンティティではなく個別のプロジェクトを使用します。

  • 統合できないカタログ、または統合しても重複がほとんどないカタログ。

  • 異なる言語を必要とするエンティティ。プロジェクトごとに使用できる言語は 1 つだけです。

ユーザー イベントとエンティティ

エンティティ機能を利用するには、ユーザー イベントにエンティティ フィールドを追加します。

  • 検索と自動入力の場合: search タイプのユーザー イベントに entity フィールドを含めます。

    エンティティ フィールドを他のユーザー イベント タイプに含めるとトラブルシューティングに役立ちますが、検索や自動入力のレスポンスの品質には影響しません。

  • おすすめコンテンツの場合: できるだけ多くの種類のユーザー イベントにエンティティ フィールドを含めます。

通常、エンティティ機能が最適な候補を返すまでに、30 ～ 90 日間のユーザー イベントデータが必要です。

エンティティがリクエストの中にない場合、リクエストは、結果についてエンティティを想定しません。指定したエンティティの有無にかかわらず、ユーザー イベントに基づく平均的な結果が返されます。

検索とエンティティ

エンティティを考慮した検索結果またはブラウジング結果を取得するには:

  1. 検索ユーザー イベント（ eventType="search" ）にentity フィールドを含めます。例として、検索ユーザー イベントの完全なオブジェクトの例をご覧ください。

  2. 検索リクエストに entity フィールドを追加します。検索リクエストを行う方法については、検索結果を取得するをご覧ください。

自動入力とエンティティ

エンティティを考慮したオートコンプリートの結果を取得するには:

推奨事項とエンティティ

ユーザー イベントに entity フィールドを追加したら、レコメンデーション用のエンティティを利用するのにこれ以上のアクションは必要ありません。これは、エンティティ値はユーザー イベントの一部であり、predict メソッドの呼び出しに含まれるためです。