これは Recommendations AI のみに関するドキュメントです。制限付き一般提供フェーズで Retail Search と統合された Retail コンソールを試すには、Cloud 営業担当者にお問い合わせくださいRetail Search を使用する予定がない場合は、通知があるまで引き続き Recommendations コンソールを使用してください。

Recommendations AI の v1beta バージョンを使用している場合は、Retail API バージョンに移行してください。

アトリビューション トークン

このページでは、アトリビューション トークンを使用してレコメンデーションのパフォーマンスを時間の経過とともに向上させる方法について説明します。

アトリビューション トークンは、Recommendations AI によって生成され、予測リクエストごとに返される一意の ID です。これにより、Recommendations AI がユーザーの操作とレコメンデーションを相互に関連付け、収益とコンバージョン率の指標を提供できます。

ユーザー イベントへのアトリビューション トークンの追加はオプションです。アトリビューション トークンを指定しない場合、Recommendations AI は、訪問者 ID とタイムスタンプに基づいて予測レスポンスと取り込まれたユーザー イベントをレコメンデーションで調整し、アトリビューション トークンを概算します。詳細

レコメンデーション トークンの仕組み

predict メソッドから返される各レコメンデーションには、レスポンスの本文に一意の attributionToken が含まれます。例:

{
  "results": [{"id": "352"}, {"id": "456"}],
  "attribution_token": "abc123"
}

ウェブサイトで Recommendations AI によるレコメンデーションに基づいて商品を表示する際、ユーザーがおすすめの商品(ビュー、カートへの追加のクリックなど)を操作するとき、そのレコメンデーションからアトリビューション トークンを返す必要があります。このフィードバック ループを使用すると、Recommendations AI が、レコメンデーションがビジネスに与える影響に関する情報を提供できます。詳細については、Recommender のパフォーマンスの測定をご覧ください。

アトリビューション トークンを返す方法

アトリビューション トークンを返すには、ユーザーがおすすめ商品で行ったすべてのアクションを記録するユーザー イベントにアトリビューション トークンを含めます。おすすめ商品に対してユーザーが実行できるアクションは、ウェブサイトのデザインによって異なります。一般的なアクションには、商品をお気に入りリストに追加する、詳細ビューをリクエストする、ショッピング カートに追加する、1 クリックで購入をする、などがあります。

アトリビューション トークンを返すには、まずウェブサイトのレコメンデーションパネルに表示されるように商品と関連付けておく必要があります。一般的な方法としては、レコメンデーションパネルで実行できるアクションに関連付けられたすべての URL にそれを追加します。例:

https://www.example.com/54321/?rtoken=abc123

その後、ユーザーがレコメンデーション パネルで商品を操作すると(ユーザー イベントが生成されます)、アトリビューション トークンを URL リンクから解析して、その操作のためにレコメンデーション AI に送信するユーザー イベントに挿入できます。

たとえば、ユーザーへの商品の表示に関する予測をリクエストするとします。Recommendations AI は、おすすめのカタログ ID のセットと、関連するアトリビューション トークンを返します。

{
  "results": [{"id": "352"}, {"id": "456"}],
  "attribution_token": "abc123"
}

ウェブサイトのレコメンデーション パネルにはおすすめの項目が表示され、またレコメンデーション パネルの URL ごとに、その予測に対して返されたアトリビューション トークンが含まれています。ユーザーがその商品の詳細ビューを表示するためおすすめ商品の 1 つをクリックしたら、そのクリックで記録する detail-page-view ユーザーイベントにアトリビューショントークンを含めます。ユーザー イベントは次の例のようになります。

{
  "eventType" : "detail-page-view",
  "userInfo": {
    "visitorId": "visitor1",
    "userId": "user1"
   },
   "eventDetail": {
     "attributionToken": "abc123",
   },
   "productEventDetail": {
      "productDetails": [{
        "catalogItemId": "123",
        "originalPrice": 49.00,
        "displayPrice": 44.00,
        "currencyCode": "USD"
       }
     ]
   }
}

レコメンデーションに基づいて表示された商品をユーザーが操作し、その操作のユーザー イベントによるアトリビューション トークンを含めると、Recommendations AI はその情報を使用して評価を行います。

たとえば、ユーザーがレコメンデーション パネルで商品を確認し、レコメンデーションパネルを使ってその商品をほしいものリストに追加し、商品の詳細ビューも得るとします。レコメンデーション パネルから生成されるユーザー イベント(リストに追加と詳細ページビュー)の両方にアトリビューション トークンを含める必要があります。

次に、同じユーザーが詳細ビューからこの商品をカートに追加したとします。アトリビューション トークンはレコメンデーション パネルではなく、詳細ビューから取得されたため、この場合はアクションにアトリビューション トークンを含める必要はありません。同様に、ユーザーが商品を直ちに購入したものの、レコメンデーション パネルから直接購入したわけではない場合は、購入イベントとともにアトリビューション トークンを返すメリットはありません。

次のステップ