Skip to main content
RichRelevance

userInfo

重要: 必要なパラメーターのみコールしてください。弊社は、多くのアプリケーションやクライアントを同時にサポートするAPIのセットを使用しています。これらのAPIは随時更新または改善される場合があります。 

http://recs.richrelevance.com/rrserver/api/rrPlatform/userInfo

URLが正しく機能するためにはAPIキートパラメータが必要です。URLリスエストの例については以下を参照してください。

説明: ユーザーの購入および閲覧履歴に関する情報を返します。

 

パラメーター

注記: パラメーターはすべて大文字小文字を区別します。

名称 必須 / オプション 説明

apiClientKey

必須

各APIの実装に固有のキーです。レポート、パーミッション、マーチャンダイジング用の特定の実装チャネルの識別子です。このキーは弊社からクライアントに提供されます。

例: apiClientKey=b0126f995ac848159d

apiKey

必須

サイトを特定する固有のキーです。弊社のクライアントはそれぞれ固有のAPIキーをお持ちです。これによって他のクライアントのデータやトラフィックと区別します。このキーは弊社からクライアントに提供されます。

例: apiKey=4faeaf752ee40a0f

attribute

オプション

カタログ・フィードで提供されたカスタム属性を抽出します。複数の属性をリクエストする場合は、パラメーターを複数回使用しますが、その場合は各属性を「&」で区切ってください。全ての属性をリクエストする場合はパラメーター値として「*」を使用してください。

例: &attribute=COLOR&attribute=SIZE

categoryData

オプション

false(偽)に設定されている場合はカテゴリー・データ(カテゴリーID及びカテゴリー)を省略します。既定値はtrue(真)です。

例: categoryData=false

count

オプション

このレスポンスで返される商品の総数です。この値は、プレースメントに設定されたリターン数や検索および閲覧設定より優先されます。たとえば、返す商品数を30〜60とする場合、値を30に設定します。上限値は1000です。

例: count=30

注記: このパラメーターは検索および閲覧専用です。

includeSimilarUsers

オプション

true又はfalseです。類似したユーザーをレスポンスで返します。similarUsersStrategyを使用してどのストラテジーを使用するかをコントロールしてください。既定値はfalseです。

例: includeSimilarUsers=true

recentlyPurchased

オプション

現在のセッションで買物客が購入した商品です。単独または複数の商品IDです。一連の商品は履歴データと合わせて考慮されます。商品IDはパイプ「|」で区切ってください。

例: recentlyPurchased=uv2345|xt1234

recentlyViewed

オプション

現在のセッションで買物客が閲覧した一連の商品詳細ページの商品IDです。各閲覧時のタイムスタンプをミリ秒単位で記載します(UTCタイムゾーンを使用)。タイムスタンプのフィールドが必要です。復すの商品ID及びタイムスタンプがある場合はパイプ「|」で区切ってください。ある商品を複数回閲覧した場合、タイムスタンプはセミコロンで連結されます。

例: recentlyViewed=pid1:1409871261000;1409871561000|pid2:1409761261000

recentSearches

オプション

買物客が最近実行した検索です。検索を複数回実行している場合はパイプ「|」で区切ってください。検索に基づくレコメンデーションにはこのパラメータが必要です。

例: recentSearches=brown shoes|blue shoes

sessionId

オプション

買物客の一回の訪問を識別します。セッションは行動モデルで使用され(買物セッション中のユーザー・コードをスコープします)、指標をレポートします。

例: sessionId=93484

similarUsersCount

オプション

返される類似ユーザーの数です。既定値は30です。

例: similarUsersCount=50

similarUsersStrategy

オプション

includeSimilarUsersの値がtrueであれば、類似ユーザーを見つける際に使用するストラテジーを選択します。有効な値はattributeOnly又はattributeBehavioralです。既定値はattributeOnlyです。

例: similarUsersStrategy=attributeOnly

useCookie

オプション

マニュアルでのレコメンデーションと合わせてリッチレリバンスのクッキーからの最近見た商品情報をベースとして使用します。既定値はは「yes」です。

例: useCookie=yes

userAttribute

オプション

現在の買物客を表すカスタム・キー及び値です。情報はセミコロン「;」及びパイプ「|」で区切ってください。

例: userAttribute=eye_color:blue;green|hair_color:brown

userId

オプション

ユーザーIDです。各買物客(ユーザー)を特定する固有の文字列です。買物客の全ての行動は、このキーを使用して保存されます。大文字小文字を区別し、また他のリッチレリバンスの他のアプリケーションで使用されているユーザーIDと一致している必要があります。

例: userId=0982347

リクエスト例

http://integration.richrelevance.com/rrserver/api/rrPlatform/userInfo?&apiClientKey=e9c9e05289be70e6&apiKey=showcaseparent&userId=1

レスポンス例

{
    "purchasedProducts": [],
    "viewedProducts": [{
        "regionPriceDescription": "",
        "rating": 4.254000186920166,
        "numReviews": 0,
        "priceRangeCents": [79900, 79900],
        "categoryIds": ["Electronics", "Electronics.TV & Video", "Electronics.TV & Video.TVs"],
        "imageURL": "http://labs.richrelevance.com/storre/media/catalog/product/v/i/vizio-e601i-a3-60quot-1080p-120hz-class-razor-led-1.94quot-ultra-slim-smart-hdtv-quotvizio-direct-refurbishedquot-9fe3cd76f6142358157dfc008d38aff2.jpg",
        "name": "VIZIO E601i-A3 60\" 1080p 120Hz Class Razor LED (1.94\" ultra-slim) Smart HDTV, \"VIZIO Direct Refurbished\"",
        "genre": "Electronics",
        "isRecommendable": true,
        "priceCents": 79900,
        "id": "24516217",
        "categories": [{
            "hasChildren": false,
            "name": "Electronics",
            "id": "Electronics"
        }, {
            "hasChildren": false,
            "name": "TV & Video",
            "id": "Electronics.TV & Video"
        }, {
            "hasChildren": false,
            "name": "TVs",
            "id": "Electronics.TV & Video.TVs"
        }],
        "brand": "Vizio"
    }],
    "similarUsers": [],
    "viewedCategories": [{
        "hasChildren": false,
        "name": "Electronics",
        "id": "Electronics"
    }, {
        "hasChildren": false,
        "name": "TVs",
        "id": "Electronics.TV & Video.TVs"
    }, {
        "hasChildren": false,
        "name": "TV & Video",
        "id": "Electronics.TV & Video"
    }],
    "purchasedCategories": []
}
  • Was this article helpful?