Recommendations ダウンロード API の使用

recommendations ダウンロード API を使用して、スプレッドシートまたはテキストエディターで表示できる .CSV ファイルでレコメンデーションをダウンロードします。.CSV ファイルには、商品キーごとにすべてのレコメンデーションがリストされます。

recommendations の結果をダウンロードするたびに、最後にアルゴリズムを実行した時点から結果をダウンロードした時点までの間に変更されたデータだけでなく、すべてのデータが更新されます。

レコメンデーションはアルゴリズムサーバーにより 2 ~ 6 時間ごとに更新されます。変更はダウンロード API の結果に即座に反映されます。

木曜日の午後 8 時以降(太平洋時間)に行われる定期メンテナンスの時間枠以外であれば、この API は常に使用できます。

API の構造

ダウンロード API では REST 呼び出しにシンプルな構造を採用しています。次に例を示します。

http://recommendations.omniture.com/rest?action=downloadRecommendations
&id=43&clientKey=24be79b2-d631-4207-a435-c6d5dd11059a
&client=clientcodehere

要素の説明:

Id はアプリケーションで表示されるレコメンデーション ID です。レコメンデーションの編集ページの URL を見ると ID が分かります。groupId 値ではなく、id=XXX 値を使用します。

clientKey は、recommendations アプリケーションの設定ページで表示したり変更したりできる API トークンです。

clientcode は、設定ページのクライアント API トークンの下に表示されます。

無効なクライアントキーまたはレコメンデーション ID を指定すると、「クライアントキーまたはレコメンデーション ID が無効です」というエラーが返されます。