このページでは、エンティティの概要と、エンティティを使用する方法、および使用する理由について説明します。
ほとんどのユースケースでは、Vertex AI Search for Retail にエンティティは必要ありません。ただし、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 for Retail を設定する際は、同じプロジェクト内の異なるプロジェクトやエンティティを使用して、さまざまな購入者集団に対して異なる候補を取得できます。
アプリケーションによっては、個別のプロジェクトが必要です。他のアプリケーションの場合は、エンティティの設定が適しています。
エンティティは、次の場合に使用します。
エンティティ間の完全共有または一部共有カタログ
次のいずれか 1 つ以上に該当する場合:
同じ国または言語地域に複数のブランドがある場合。たとえば、元のブランドと買収したブランド（
google_homeやnest）がある場合です。同じ国の複数のリージョン（例:
enterprise_east、enterprise_west）。ブランドは 1 つで、同じ言語を使用する複数の国（例:
brand_us、brand_ca）。
次の場合は、エンティティの代わりに個別のプロジェクトを使用します。
統合できないカタログ、または組み合わせたカタログに重複がほとんどまたはまったくないカタログ。
異なる言語を必要とするエンティティ。プロジェクトごとに 1 つの言語のみを使用できます。
ユーザー イベントとエンティティ
エンティティ機能を活用するには、エンティティ フィールドをユーザー イベントに追加します。
検索とオートコンプリートの場合:
searchタイプのユーザー イベントにentityフィールドを追加します。他のユーザー イベントタイプにエンティティ フィールドを含めると、トラブルシューティングに役立ちますが、検索やオートコンプリート レスポンスの品質には影響しません。
レコメンデーションの場合: できるだけ多くの種類のユーザー イベントにエンティティ フィールドを含めます。
通常、エンティティ特徴が最適な候補を返すまでに 30 ～ 90 日かかります。
エンティティがリクエストの中にない場合、リクエストは、結果についてエンティティを想定しません。指定したエンティティの有無にかかわらず、ユーザー イベントに基づく平均的な結果が返されます。
検索とエンティティ
エンティティを考慮した検索結果を取得または参照するには:
検索ユーザー イベント（
eventType="search"）にentityフィールドを含めます。例として、検索ユーザー イベントの完全なオブジェクトの例をご覧ください。検索リクエストに
entityフィールドを追加します。検索リクエストを行う方法については、検索結果の取得をご覧ください。
オートコンプリートとエンティティ
エンティティを考慮したオートコンプリートの結果を取得するには:
- 自動学習データセットとエンティティでフィルタされた候補の指示に従います。
レコメンデーションとエンティティ
ユーザー イベントに entity フィールドを追加したら、レコメンデーション用のエンティティを利用するのにこれ以上のアクションは必要ありません。これは、エンティティ値はユーザー イベントの一部であり、predict メソッドの呼び出しに含まれるためです。