ログイン

サポートセンター

実装と運用のサポートコンテンツをご利用いただけます。

サポートセンター. 実装と運用のサポートコンテンツをご利用いただけます。

Criteoのフィード仕様

概要

商品フィードはお客様のサイトの商品詳細をまとめたカタログのファイルです。フィードは お客様の商品詳細をバナーに表示するために使用されます。

この記事ではどの 商品情報をフィードに入れるか、またそれらのフォーマットの仕方を説明しています。

Criteoフィード内の商品情報

Criteoの商品フィードには必須項目とオプション項目の 両方が備わっています。

下記にリストされた必須項目は商品フィードをインポートするために必要となります。こちらがなければインポートは実行できません: 

  1. id
  2. name
  3. producturl
  4. bigimage
  5. smallimage

以下に リストされた は必須ではなく、推奨される商品です。この 情報はCriteoエンジンがお客様の キャンペーン実績を最適化する為に役立ちます:

  1. description
  2. price
  3. retailprice
  4. categoryid1
  5. categoryid2
  6. categoryid3

id

必須項目– これらの項目はフィード内のすべての商品に必要とされ、空欄/ブランクにしておくことはできません

このIDは各商品につくユニークな商品IDです。これには商品を表わす英数字を入れることができます。一度あるIDが取り込まれると、そのIDは別の商品に使用できず、また特定の商品のIDを変更することもできません。商品フィード内のProduct IDはCriteo V3タグに実装されるものと同一になるようにします。

文字数制限: 250

データタイプ: 改行せず、ストリングで登録。

文字の用件: IDは文字または数字のいずれかで始まる必要があり、またASCII文字だけを含むことができます。

例: abc123

 

name

必須項目–  このフィールドはフィード内のすべての商品に必要とされ、空欄/ブランクにしておくことはできません

このname項目は通常商品の詳細ページに表示されるような商品のタイトルです。これはバナー内で商品用の主要なテキストとして使用されます。バナーのデザインの関係上、(25文字未満の)短いnameはCriteoのフォーマットとレイアウトに適合する可能性が高いです。複数のオプションを持つ商品がある場合(例えば、色、サイズ、性別)このフィールドに親商品の名前だけを入力するのが最善です。

文字数制限:  500(推奨値は25です)

データタイプ: 改行せず、ストリングで登録。

文字の用件: 名前は文字または数字のいずれかで始まる必要があり、またASCII文字だけを含むことができます。styleタグを含むすべてのHTMLタグはこのフィールド内から削除してください。

例: 計量カップ6個のセット

 

producturl

必須項目–  このフィールドはフィード内のすべての商品に必要とされ、空欄/ブランクにしておくことはできません

このproducturlはその商品専用の詳細ページです。このproducturlは、必ずとは限りませんが、通常は各商品特有のものです。このURLにある商品情報はお客様のフィード内の対応する情報と一致しなければなりません。商品のURLはタグ付けされる商品ページと同一のものでなければなりません。トラッキングコードを producturl内に含めることはできますが、必須でないです。

文字数制限: 1024

データタイプ: 改行せず、ストリングで登録。

文字の要件: このproducturlはプロトコル(http:// or https://)で始まりそれに続いて商品詳細ページのURL全体が記述される必要があります。すべての記号はエンコードされる必要があります、例えば$は「%24」で置換される必要があります。

例: http://www.example.com/product/6-measuring-cups

 

bigimage

必須項目- smallimageが入力済みでない場合、このフィールドは必要です。smallimageがブランク/空欄である場合、bigimageはブランク/空欄にしておくことができません

このbigimageは商品の画像につながるファイルのパスを指定するURLです。このbigimageはバナー内に商品の画像を表示するために使用されます。画像ファイルは600から800ピクセルの間の幅で1MB未満のサイズであることが理想的です。この画像はPNGもしくはJPEGのいずれかが指定されたContent-Typeのヘッダーになっている必要があります。

文字数制限: 1024

データタイプ: 改行せず、ストリングで登録。

文字の要件: このbigimageはhttp:// (https://ではなく)で始まりそれに続いて商品の画像の完全なURLが記述されている必要があります。すべての記号はエンコードされる必要があります、例えば$は「%24」で置換される必要があります。なおbigimageには?などで始まるパラメーターを付与しないようにしてください。

例: http://www.example.com/product/image/6-measuring-cups.png

 

smallimage

必須項目- bigimageが入力済みでない場合、このフィールドは必須です。bigimageが空欄である場合、smallimageを空欄にしておくことができません。

このsmallimageは商品の画像につながるファイルのパスを指定するURLです。このsmallimage はバナー内に商品の画像を表示するために使用されます。画像ファイルは300から400ピクセルの間の幅で1MB未満のサイズであることを推奨しています。あらかじめbigimageを入力する場合、300ピクセル未満の幅の画像をsmallimage内に入力することができます。この画像はPNGもしくはJPEGのいずれかが指定されたContent-Typeのヘッダーを持つ必要があります。

文字数制限: 1024

データタイプ: 改行せず、ストリングで登録。

文字の要件: この smallimageはhttp:// (https://ではなく)で始まりそれに続いて商品の画像の完全なURLが記述されている必要があります。すべての記号はエンコードされる必要があります、例えば$は「%24」で置換される必要があります。しかしながら、このsmallimageには”?”ではじまるパラメーターなどはつけないようにしてください。

例: http://www.example.com/product/image/6-measuring-cups-small.png

  

description

このdescriptionは商品名に詳細情報を記述する短いテキストです。バナーのデザイン上(50文字未満の)短い説明はバナーにより適合します。

文字数制限:  500(推奨値は50です)

データタイプ: 改行せず、ストリングで登録。

文字の用件: 名前は文字または数字のいずれかで始まる必要があり、ASCII文字だけを含むことができます。style、embed、object、anchorタグなど全てのHTMLタグをこのフィールドから削除してください。

例: この商品をまとめるリングが付いてきます

 

price

priceはサイトで販売されている商品の価格です。商品が「セール中」の場合このpriceにはセール価格が入力されます。このpriceはサイトで使用されるものと同一の通貨であることが想定されていますので、このフィールドに通貨記号は入れないでください。小数点にはピリオド(.)を使用して数字のみで価格を入力してください。

文字数制限: 10

データタイプ: 整数

文字の要件: 通貨の記号は入れない(例えば¥)または通貨名(例えば JPY/円)。 小数点の記号は千単位のセパレーター(,)のないピリオド(.)である必要があります。

例: 1199.99

 

retailprice

このretailpriceはメーカー希望価格です。所定の商品が「セール中」の場合このretailpriceにはpriceより高い価格が入力されます。このretailpriceはサイトで使用されるものと同一の通貨であることが想定されていますので、このフィールドには通貨記号を入れないでください。千単位のセパレーター(,)なしで小数点にはピリオド(.)を使用した数字の値でのみretailpriceを入力してください。

文字数制限: 10

データタイプ: 整数

文字の要件: 通貨の記号は入れない(例えば¥)または通貨名(例えば JPY/円)。 小数点の記号は千単位のセパレーター(,)のないピリオド(.)である必要があります。

例: 1299.99

 

categoryid1

このcategoryid1は商品が属するカテゴリーです。通常は最上位カテゴリーに属します(例えば Women's(女性用))。どんなカテゴリーがここに入力されるかについて制限はありませんので、cateroryid1を使用してお客様のサイトの特定の最上位カテゴリーの設定が可能です。categorid1は大文字小文字の区別があるので、ある商品に(小文字始まりの)woman'sを使用し別の商品に(大文字始まりの)Women'sを使用した場合Criteoはこれらは二つの別々のカテゴリーだと解釈します。

文字数制限: 500

データタイプ: 改行せず、ストリングで登録。

文字の用件: categoryid1は文字または数字のいずれかで始まる必要があり、ASCII文字だけを含むことができます。

例: Women's(女性用)

 

categoryid2

categoryid2は商品が属するカテゴリーです。通常は中位カテゴリーに属します(例えばShoes(靴))。どんなカテゴリーがここに入力されるかについて制限はありませんので、cateroryid2を使用してお客様のサイトの特定の中位カテゴリーの設定が可能です。categorid2は大文字小文字の区別があるので、ある商品に(小文字始まりの)shoesを使用し別の商品に(大文字始まりの)Shoesを使用した場合Criteoはこれらは二つの別々のカテゴリーだと解釈します。

文字数制限: 500

データタイプ: 改行せず、ストリングで登録。

文字の用件: categoryid2は文字または数字のいずれかで始まる必要があり、ASCII文字だけを含むことができます。

例: Shoes(靴)

 

categoryid3

categoryid3は商品が属するカテゴリーです。通常は最下位カテゴリーに属します(例えば Working Boots(ワークブーツ))。 どんなカテゴリーがここに入力されるかについて制限はありませんので、cateroryid3を使用してお客様のサイトの特定の最下位カテゴリーの設定が可能です。categorid3は大文字小文字の区別があるので、ある商品に(小文字始まりの)working bootsを使用し別の商品に(大文字始まりの)Working Bootsを使用した場合Criteoはこれらは二つの別々のカテゴリーだと解釈します。

文字数制限: 500

データタイプ: 改行せず、ストリングで登録。

文字の用件:categoryid3は文字または数字のいずれかで始まる必要があり、またASCII文字だけを含むことができます。

例: Working Boots(ワークブーツ)

この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています