このページでは、エンティティについて説明します。エンティティは、単一の企業サイトで複数のブランドや商品に応じてさまざまなユーザー行動を把握する方法です。また、エンティティの利用方法と利用する理由についても説明します。
ほとんどのユースケースでは、Vertex AI Search for Commerce にエンティティは必要ありません。ただし、1 つの商品カタログで複数のブランドや地域にサービスを提供している小売店は、エンティティを使用するとより良い結果が得られます。
概要
プロジェクトに複数のエンティティを設定すると、異なる地域や国にいる買い物客や、企業に属する異なるブランドのサイトで買い物をする買い物客の行動や好みを考慮できます。
ユースケースの例: 2 か国
小売業者の Example Organization は、米国とカナダの両方にウェブサイトを所有しています。
たとえば、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 日間のユーザー イベントデータが必要です。
エンティティがリクエストの中にない場合、リクエストは、結果についてエンティティを想定しません。指定したエンティティの有無にかかわらず、ユーザー イベントに基づく平均的な結果が返されます。
検索とエンティティ
エンティティを考慮した検索結果または閲覧結果を取得するには:
検索ユーザー イベント（
eventType="search"）にentityフィールドを含めます。例として、検索ユーザー イベントの完全なオブジェクトの例をご覧ください。検索リクエストに
entityフィールドを追加します。検索リクエストを行う方法については、検索結果を取得するをご覧ください。
予測入力とエンティティ
エンティティを考慮したオートコンプリートの結果を取得するには:
- 自動学習データセットとエンティティでフィルタされた候補の手順に沿って操作します。
推奨事項とエンティティ
ユーザー イベントに entity フィールドを追加したら、レコメンデーション用のエンティティを利用するのにこれ以上のアクションは必要ありません。これは、エンティティ値はユーザー イベントの一部であり、predict メソッドの呼び出しに含まれるためです。