下記の方法で、過去X時間内のトレンドアイテムのクエリを送ることができます。
$p('register', {
max: 100, // あらゆるアイテムが見れるように大量のリクエストを送信しました
widget: 'default-widget', // ウィジェット名
opts: {
"rankingKey": "click",
"hoursBehind": 24
},
callback: function(resp) {
console.log(JSON.stringify(resp, null, 2));
console.log("// TEST.");
}
}
);
[rankingKey]と[hoursBehind]が、optsに設定されました。[hoursBehind]をXに指定することで、 過去X時間内のトレンドアイテムを返します。
このエンドポイント特有の、[opt]に設定できるパラメータは下記のとおりです:
- `[rankingKey]は、アイテムを降順でランク付けするためのキーです。"click"、"visible"、"show"、"click:visible"、"click:show"、"visible:show"の値をrankingKeyに使用できます。値の中に":"が含まれているものは比率に換算されるため、分子から分母に対する比率の降順にランク付けされます。この値が指定されていない場合は、上位のアイテムがランダムに送信されます。
[lookupKey]は、"popular"または"click"の2つの値を持つキーです。"popular"キーを指定すると多く閲覧されたアイテム、"click"キーを指定すると多くクリックされたアイテムのリストを取得します。この[lookupKey]のデフォルト値は"click"です。ot of clicks. The default value of
lookupKey` is "click".- `[hoursBehind]は、この処理対象に含める時間長を示します。この値を24に設定すると、過去24時間の[rankingKey]および[lookupKey]に応じた上位アイテムを送信します。
REST APIでの使用
REST APIを使用してトレンドアイテムのリコメンデーションの機能を使用する場合は、[opts]のオブジェクトにネスト(入れ子)するのではなく、上記の[opts]のキーの値の組み合わせを、JSONに指定してください。詳細はREST API modelエンドポイントのドキュメントを参照してください。