user/preference
重要: 必要なパラメーターのみコールしてください。弊社は、多くのアプリケーションやクライアントを同時にサポートするAPIのセットを使用しています。これらのAPIは随時更新または改善される場合があります。
http://recs.richrelevance.com/rrserver/api/user/preference
注記: URLが正しく機能するためにはAPIキートパラメータが必要です。URLリスエストの例については以下を参照してください。
説明: 顧客のプリファレンスをRelevance Cloudに記録します。商品、ブランド、カテゴリー、店舗等の「好き」、「好きではない」を明示できます。またレコメンデーションに表示して欲しくない商品を明示することもできます。
パラメーター
注記: パラメーターはすべて大文字小文字を区別します。
名称 | 必須 / オプション | 説明 |
---|---|---|
actionType | 必須 | |
apiKey | Required | |
callback | Required for JSONP | |
p | Required | |
s | Required | |
targetType | Required | |
u | Required | |
vg | Optional |
リクエスト例
GET
http://recs.richrelevance.com/rrserver/api/user/preference?apiKey=showcaseparent&s=10&u=1&vg=1a477338-4fae-4185-e637-3252c78feade&p=21653692&targetType=product&actionType=like
JavaScriptのリクエスト例
function logPreference(action, target, externalId) { var prefUrl="http://recs.richrelevance.com/rrserver/api/user/preference?apiKey="+ R3_COMMON.apiKey + "&s="+ rrSessionId + "&u=" + R3_COMMON.userId +"&vg=" + RR.pq('vg') + "&p=" + externalId + "&targetType="+ target +"&actionType=" + action; jQuery.ajax(prefUrl, { dataType: "jsonp", success: function(data, status) { console.log(data); } }); } function likeBrand() { logPreference("like", "brand", R3_COMMON.brand); } function unlikeBrand() { logPreference("neutral", "brand", R3_COMMON.brand); } function likeItem() { logPreference("like", "product", R3_ITEM.id); } function unlikeItem() { logPreference("neutral", "product", R3_ITEM.id); } function retrievePreferences(target) { var prefUrl="http://recs.richrelevance.com/rrserver/api/user/preference/" + R3_COMMON.userId + "?apiKey="+ R3_COMMON.apiKey + "&u=" + R3_COMMON.userId +"&fields=pref_" + target; jQuery.ajax(prefUrl, { dataType: "jsonp", success: function(data, status) { console.log(data); } }); }
結果の例
200 OK
{ 'userId':'USER185', 'pref_product':{ 'like':[ '1234', '5678' ], 'dislike':[ 'abcd' ] }, 'pref_brand':{ 'like':[ 'Sony', 'Nabisco' ] }, 'pref_category':{ 'like':[ '8989', '8080' ] }, 'pref_store':{ 'like':[ 'ca_128' ] } }