アトリビューション トークンは、小売業向け Vertex AI Search によって生成され、検索リクエストごとに返される一意の ID です。これにより、小売業向け Vertex AI Search は検索リクエストを一致する検索イベントに関連付けることができ、再ランク付けモデルによって検索レスポンスの品質を向上させることができます。正確なレポートを作成するには、検索イベントでもアトリビューション トークンが必要です。
小売業向け Vertex AI Search によって配信されるすべての検索イベントに検索アトリビューション トークンを含めるには、ティア 3 とティア 4 のモデル トレーニングが必要です。
アトリビューション トークンの仕組み
Vertex AI Search メソッドから返される各レスポンスには、検索レスポンスの本文の末尾に一意の attributionToken が含まれます。次に例を示します。
{ "results": [ { "id": "727121", "product": { … } ], "totalSize": 19600, "attributionToken": "dfB0CgwIgKrltAYQ8afX4AIQARokNjZjMGEwYjEtMDAwMC0yNjAyLTk0Y2UtNTgyNDI5Y2JkMzUwKgUxMjM0NTIkxcvzF6OAlyLo5KotmNa3LY6-nRW3t4wtwvCeFdSynRWb1rctOg5kZWZhdWx0X3NlYXJjaGgB", "nextPageToken": "AM1MDZiNWOyQjM4UTLlNGN50iMwYjMtADMwATLwIGMhBzY2YDJaIw-bCbxQYAt1PJgIwgExEgC" …
このトークンは、後続の検索イベントに含める必要があります。
{ "eventType": "search", "searchQuery":"red t-shirt", "productDetails":[ {"product":{"id":"727121"}}, {"product":{"id": … } ] , "visitorId":"GA1.1.1383176924.1721324981", "attributionToken":"dfB0CgwIgKrltAYQ8afX4AIQARokNjZjMGEwYjEtMDAwMC0yNjAyLTk0Y2UtNTgyNDI5Y2JkMzUwKgUxMjM0NTIkxcvzF6OAlyLo5KotmNa3LY6-nRW3t4wtwvCeFdSynRWb1rctOg5kZWZhdWx0X3NlYXJjaGgB" }
小売業向け Vertex AI Search は、イベントデータを使用してモデルをトレーニングします。アトリビューション トークンを使用すると、イベントをリクエストにリンクし、リクエストされたフィルタ、ファセット、レスポンスの商品 ID を使用して検索リクエストとレスポンスをすべてエンコードできます。検索イベントにトークンが含まれていない場合、それらのイベントは Google の Vertex AI Search によるものではないと見なされ、検索イベントが別の検索プロバイダによるものとして誤って使用される可能性があります。A/B テスト中に、別の検索プロバイダから提供されるトークンのない検索イベントがあっても問題ありません（想定内です）。ただし、通常は、Search API のリクエストとトークンを含む検索イベントの間に 1:1 のマッピングが必要です。
アトリビューション トークンのデータ品質
アトリビューション トークンが含まれるイベントの割合が 95% 未満の場合、小売向け検索のデータ品質ダッシュボードに、[重大] または [ブロック] の非コンプライアンス エラーのステータスが表示されます。違反していない場合は、[ステータス] が [準拠] と表示されます。
収益最適化モデルであるティア 3 のデータ品質は、十分なアトリビューション イベントがないと通常はトレーニングされません。ティア 3 または ティア 4 で結果を提供する以外は、小売業向け Vertex AI Search を本番環境にデプロイすることはおすすめしません。
レコメンデーションのアトリビューション トークン
レコメンデーションのイベントはないため、predict レスポンスから取得したアトリビューション トークンをイベントに含める必要はありません。
予測レスポンスからのアトリビューション トークンは、後続のイベント（通常は detail-page-view または add-to-cart）で送信できますが、必須ではありません。実装するには、URL パラメータでおすすめ商品のアトリビューション トークンを商品ページ URL に渡し、そのパラメータを使用して detail-page-view イベントの attributionToken フィールドにデータを入力する必要があります。
Vertex AI Search のレコメンデーションでは、predict リクエストに起因するイベントの合成トークンが自動的に作成されます。トークンを明示的に追加すると、分析レポートの精度が若干向上します。ただし、これは必須ではなく、レコメンデーション モデルにはほとんど影響しません。