商品レコメンデーションの取得
おすすめ
商品レコメンデーションの取得
レコメンダーコードを使用して、Kameleoon Product Recommendation API からパーソナライズされた商品レコメンデーションを取得します。
GET
商品レコメンデーションの取得
このエンドポイントは商品レコメンデーションを取得します。
リクエスト
クエリパラメーター
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
did | String | True | デバイス ID。KameleoonProducts_device_id クッキーからこの ID を取得します。このエンドポイントを呼び出す前に、バックエンドから取得してください。“Recently Viewed” や “Recommended for You” など、過去のデバイスデータに依存するフィルターまたはアルゴリズムを使用する場合にのみ did を提供します。 |
shop_id | String | True | ストアキー。Kameleoon アプリの Recommendations > Settings > Store settings で確認できます。必要に応じてカスタマーサクセスマネージャーにキーをお問い合わせください。 |
sid | String | True | 一時的なユーザーセッション ID。KameleoonProducts_session_code クッキーからこの ID を取得します。このエンドポイントを呼び出す前に、バックエンドから取得してください。“Recently Viewed” や “Recommended for You” など、過去のユーザーデータに依存するフィルターまたはアルゴリズムを使用する場合にのみ sid を提供します。 |
recommender_code | String | True | 商品レコメンデーションブロックの ID。recommender_code はブロック管理 UI で確認できます。 |
resize_image | Integer | Optional | リサイズ用の画像サイズ(px)。サポートされる値: 120、140、160、180、200、220。 |
extended | Integer or empty | Optional | 推奨商品の拡張情報を追加します。1 の場合、API はすべての商品情報を返します。空の場合、API は商品 ID のみを返します。 |
with_locations | Boolean | False | true で、かつ extended パラメーターも true の場合、レスポンスにはすべての在庫場所の location_ids が含まれます。extended が指定されていないか false の場合、API は with_locations を無視し、デフォルトで false になります。 |
レスポンス
| 名前 | 型 | 説明 |
|---|---|---|
html | string | 商品ブロックの HTML コード。Kameleoon の個人アカウントで HTML テンプレートをカスタマイズします。 |
title | string | ブロックのタイトル。ブロックルールの “Action” 要素の値と一致します。 |
recommends | array | 商品 ID のリスト。 |
id | number | 一意のブロック識別子。Kameleoon の個人アカウントのブロック ID と一致します。 |