ログイン

サポートセンター

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

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

Criteoの商品フィードの仕様

1 - 概要

商品フィードはサイトのすべての商品についての情報を含むファイルです。この情報を使用して動的な商品バナーを構築します。

この記事には、お客様のフィードに含めることのできる内容および各フィールドをフォーマットする方法についての詳細が書かれています。

2 - Criteoに対応するフィード形式

Criteoが商品フィードを取得することができるように、次の形式の一つを使用してください。

フィードのフォーマット

詳細

ダウンロード

TSV

この形式はタブで区切られた値に基づきます。 ヘッダーはファイルの第一行目で宣言する必要があります。 フィールドnameはスペースまたは下線(例: image_linkまたは画像リンク)を含むことができます。

 フィード例

CSV

この形式はカンマ区切りの値に基づきます。ヘッダーはファイルの第一行目で宣言する必要があります。フィールドnameはスペースまたは下線(例: image_linkまたは画像リンク)を含むことができます。

 フィード例

XML

この形式はXML構造の基本を遵守しなければなりません。 商品は一連のXMLのノードで表されます。 商品リストは<?xml declaration タグ で開始する必要があります。

 フィード例

 

 

3 - 入力すべき商品情報

すべてのフィールド名は英語で設定されている必要があります。商品情報にはHTMLタグやスタイルタグが含まれてはいけません。

3.1 - 商品を広告に掲載するための必須フィールド

3.1.1 id

このフィールドはフィードのすべての商品について必須項目であり、空白/ブランクにはできません。

IDは、1つの商品に1つのみ割り当てられる、一意の商品識別子です。特定のIDを特定の商品に割り当ててインポートした後は、このIDを別の商品に使用することはできません。また、特定の商品IDも変更することはできません。item_group_idを同時に入力する場合は、IDには子ID/SKUを追加してください。

文字の要件: このidはASCII文字のみを含むことができ、引用符を含んではなりません。

文字数制限: 240

種類: 文字列

例: abc123-black-7.5

3.1.2 title

このフィールドはフィードのすべての商品について必須項目であり、空白/ブランクにはできません

titleは通常商品の詳細ページに表示される商品nameです。 これは所定の商品用のバナー内の主要なテキスト記述子として使用されます。 

 

文字の要件: nameは文字または数字で始める必要があります。

文字数制限: 150

種類: 文字列

例: Working Boots – Size 7.5

3.1.3 description

descriptionは、その商品名の補足として詳細な情報を記述できるフィールドです。バナーのデザインの性質上、追加する情報は短め(英数字50文字未満)にした方がCriteoのフォーマットやレイアウトに適しています。ただし、descriptionはすべてのCriteoバナーに表示されるフィールドではありません。

文字の要件: descriptionは文字または数字で始める必要があります。style、embed、object、anchorタグなど全てのHTMLタグをこのフィールドから削除してください。

文字数制限: 5000 

種類: 文字列

例: Excellent for daily use.(=日常使用に優れています。)

3.1.4 google_product_category

カテゴリーレベル属性は Googleの商品分類法に従って提出される商品のカテゴリーを示します。

商品が複数のカテゴリーに紐付く場合は最も関連性の高いカテゴリのみを設定してください。

文字の要件: IDと完全なカテゴリーパスの両方が容認されます

種類: 文字列

例: 女性もの > シューズ > ワーキングブーツまたは 2271

3.1.5 link

このフィールドはフィードのすべての商品について必須項目であり、空白/ブランクにはできません

linkは商品詳細ページのURLです。通常、linkは1商品に1ページ用意されています。このURLのページにある商品情報は、お客様のフィード内の同じ商品の情報と一致していなければなりません。すべてのURLにプロトコル(http:// or https://)を指定してください。

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

文字数制限: 1024

種類: 文字列

例: http://www.example.com/product/working-boots

3.1.6 image_link

このフィールドはフィードのすべての商品について必須項目であり、空白/ブランクにはできません

image_linkは商品の画像ファイルのパスを指定するURLで、バナー内に商品の画像を表示するために使用されます。画像は最低800x800ピクセルで、サイズは16MB未満が理想的です。画像はimage/png、image/gif、またはimage/jpegのいずれかが指定されたConent-Typeヘッダーを持っている必要があります。画像がcURL経由でアクセスできないように制限する場合は、画像をCriteoバナー:curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidnで表示できるようユーザエージェントをホワイトリストに登録してください。

文字の要件: image_linkは、「https://」または「http://」で始まりそれに続いて商品画像のフルURLが入力される必要があります。すべての記号はエンコードされる必要があります。例:「$」は「%24」で置換する必要があります。 

文字数制限: 2000

種類: 文字列

例: http://www.example.com/product/image/working-boots.png

3.1.7 additional_image_link

additional_image_linkは商品の画像ファイルのパスを指定するURLで、バナー内に商品画像を表示するために使用されます。画像は最低でも800x800ピクセル以上、サイズは16MB未満が理想的です。画像はimage/png、image/gif、またはimage/jpegのいずれかが指定されたConent-Typeヘッダーを持っている必要があります。cURLからアクセス可能な画像に制限をかけたい場合は、Criteoのuser-agentをホワイトリストに追加し、お客様の画像をCriteoバナーに表示できるようにしてください:curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn

文字の要件: additional_image_linkは、(https://ではなく)「http://」で始まりそれに続いて商品画像のフルURLが入力される必要があります。すべての記号はエンコードされる必要があります。例:「$」は「%24」で置換する必要があります。ただし、additional_image_linkでは、クエリ文字列には記号を含むことができません(「?」の後のどんな文字の場合も)。

文字数制限: 2000

種類: 文字列

例: http://www.example.com/product/image/working-boots-side.png

3.1.10 sale_price

sale_priceは、商品がセール中の場合の価格で、priceの価格よりsale_priceは低めの値が設定されます。sale_priceはサイトで使われるものと同一の通貨で設定してください。sale_priceは、小数点のセパレーターにピリオド(.)を使用し千単位のセパレーターなしで数字の値のpriceのみを入力してください。

文字の要件: 小数点のセパレーターは千単位のセパレーターのないピリオド(.)にする必要があります。

 

種類: 文字列

文字数制限: 50

例:99.99

 

3.1.12  mpn 

MPNは、メーカー固有の商品IDです。

文字数制限: 70

種類: 文字列

例: 4060882

 

3.1.13 brand

 このフィールドはCriteo Sponsored Productsに必須です

brandは商品のブランド名を設定します。ブランド情報を持たない商品も中にはあります。この場合この情報は入力する必要がありません。

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

文字数制限: 70

種類: 文字列

例: Criteo

 

3.1.15 product_type

このフィールドはCriteo Sponsored Productsに必須です

product_typeは、商品が属するカテゴリー(またはカテゴリーのリスト)です。product_typeフィールドは、商品のマーチャンダイジングカテゴリー、または一連のマーチャンダイジングのカテゴリーのリストで、お客様のWebサイトのカテゴリーと一致していなければなりません。階層の各レベルは「>」で区切る必要があります。商品が複数のカテゴリーに属する場合は、一次カテゴリーを先頭にし、コンマ(,)で区切られた複数の異なるカテゴリーを送信してください。product_typeでは、大文字と小文字が区別されるため、「women’s」と「Women's」は別のカテゴリーとして認識されます。

文字の要件: product_typeは文字または数字で始まる必要があり、またASCII文字のみを含むことができます。カテゴリー間の区切り文字は「>」(XMLフィード用の&gt;)でなければなりません。 完全なカテゴリーパスにのみ対応しています。商品が複数のカテゴリーで販売される場合、一次カテゴリーを先頭にし、 コンマ(,) で区切られた様々なカテゴリーをお送りください。そのパスのカテゴリーIDは承認できません。IDはproduct_type_keyフィールドに記入する必要があります。 

文字数制限: 500

種類: 文字列

例:

  • 単体:PC関連<キーボードとマウス<マウス<ワイヤレスマウス
  • 複数:PC関連<キーボードとマウス<マウス<ワイヤレスマウス、ギフト<父の日用<マウス

3.1.16 product_type_key

このフィールドはCriteo Sponsored Productsに必須です

このフィールド はproduct_typeまたは一連のproduct_typeについての一意のIDと階層をリストします。 階層の各キーは「>」で区切る必要があります。 商品が複数のカテゴリーで販売される場合、一次カテゴリーを列の先頭にし、 コンマ(,) で区切られたものをお送りください。

文字の要件:product_type_keyはASCII文字のみを含むことができます。 カテゴリー間の区切り文字は「>」(XMLフィード用の&gt;)でなければなりません。 商品が複数のカテゴリーで販売される場合、一次カテゴリーを先頭にし、 コンマ(,) で区切られ様々なカテゴリーをお送りください。

文字数制限: 500

種類: 文字列

例:

  • 単一: XY1 &gt; YZ1 &gt; Z1
  • 複数: XY1 &gt; YZ1 &gt; Z1 , AB1 &gt; BC2 &gt; A

3.1.17 number_of_reviews

このフィールドはCriteo Sponsored Products用に推奨されます

このフィールドには、商品に関するレビューの回数が含まれています。広告にこの情報を表示するためには、number_of_reviewsフィールドを指定してください。

文字数制限: 8

種類:Integer(整数)

例: 2456

3.1.18 product_rating

このフィールドはCriteo Sponsored Products用に推奨されます

このフィールドは商品の評価結果を表します。お客様がこの情報を広告に表示したい場合には、product_ratingフィールドを指定してください。

文字の要件: 小数点のセパレーターは千単位のセパレーターのないピリオド(.)にする必要があります。

文字数制限: 8

種類: 文字列

例: 4.5

3.1.19 filters

このフィールドはCriteo Sponsored Productsに必須です

filtersは同一のカテゴリーにある商品間の違いを指定する属性です。 Filtersはname値ペアの属性をコンマ区切りで列挙したリストで提供されます。 それらはお客様のWebサイトで販売され、かつこの商品に一致するfiltersのリストに一致しなければなりません。 これはCriteo出資の商品には不可欠です。

文字の要件: Key=Value(キー=値)のペアはコンマ(,)で区切られ、複数の値はパイプ(|)で区切られます。

文字数制限: 2000

種類: 文字列

例: Color=赤|黒, Size=XL, Screen Size = 15インチ

3.1.20 adult

adultは、すべてのユーザやオーディエンスに商品を提示しても安全かどうかを示す属性です。アダルト属性に指定された商品はCriteoバナーに表示することはできず、パブリッシャーのネットワークがお客様のキャンペーンをブラックリストに登録する可能性があります。また、このフィールドを「yes」にすると、商品がレコメンデーション不可(non-recommendable)の設定となり、バナーに表示されなくなります。

 

文字の要件: 値はyes(=はい)または no(=いいえ)である必要があります

種類: ブール代数

例: no(いいえ)

3.2 - オプションのフィールド

3.2.2 mobile_link

mobile_linkは、モバイル用に最適化された商品ランディングページのURLを指定するフィールドです。URLは「link」フィールドに指定したものとは別のURLを設定します。モバイル用のURLを提供することで、ページの表示時間が短縮されるとともに、ユーザビリティの向上にもつながります。

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

文字数制限: 2000

種類: 文字列

例: http://m.example.com/product/working-boots

3.2.2 condition

conditionは、次の3つのいづれかの値で設定できます:「new(新規)」、「refurbished(改造済み)」および「used(使用済み)」。

文字の要件: 次の3つの値だけが承認されます。

  • 「new」[new]
  • 「refurbished(改造ずみ)」[refurbished]
  • 「used(使用済み)」[used]

種類: 文字列

例: 新しい

---

商品のバリエーション

3.2.3 item_group_id

item_group_idとは、ユニークな親レベルの商品識別子です。これには子商品の集まりとして識別できる一つの商品を表す英数字を含むことができます。item_group_idが商品に割り当てられインポートされれば、そのitem_group_idは別の商品には使用できず、また特定の商品のitem_group_idを変更することもできません。item_group_idはいくつかの商品で同じitem_group_idを持つことができます。

文字の要件: item_group_idはASCII文字のみを含むことができ、引用符を含んではなりません。

文字数制限: 240

種類: 文字列

例: abc123

 

3.2.4 color

詳細: この属性は商品用の主要な色を示します。

文字数制限: 100

種類: 文字列

実例: ブラック

3.2.5 gender

性別毎に変わるアイテムグループのすべての商品について必須です。

文字の要件: 次の3つの値だけが承認されます。

  • 「male(男性)」 [male]
  • 「female(女性)」[female]
  • 「unisex(ユニセックス)」[unisex]

種類: 文字列

実例: male(=男性)

3.2.6 age_group

この属性は商品に狙いを定めた年齢グループを示すために使用されます。

文字の要件: 次の5つの値だけが承認されます。

  • 「newborn(新生児)」 [newborn]
  • 「infant(幼児)」[infant]
  • 「toddler(2~4歳の幼児)」[toddler]
  • 「kids(子供)」[kids]
  • 「adult(成人)」[adult]

種類: 文字列

例: adult(=成人)

3.2.7 material

この属性は商品を構成する素材や繊維を示します。material(素材)毎に変わるアイテムグループのすべての商品について必須です。

文字数制限: 200

種類: 文字列

例: leather(=革)

3.2.8 pattern

この属性は、商品のパターンやグラフィックプリントを示します。パターンごとに変わるアイテムグループのすべての商品に必須となります。

文字数制限: 100

種類: 文字列

例: Striped(=ストライプ)

3.2.9 size

この属性は商品のサイズを示します。アイテムグループのsize(サイズ)ごとに変わるすべての商品について必須です。

文字数制限: 100

種類: 文字列

例: L

3.2.10 size_type

サイズの種類を追加することで商品のカットを指定することができます。

文字の要件: 次の5つの値だけが承認されます。

  • 「regular(レギュラー)」 [regular]
  • 「petite(小)」 [petite]
  • 「plus(プラス)」 [plus]
  • 「big and tall(大きく高い)」[big and tall]
  • 「maternity(マタニティー)」[maternity]

文字数制限: N/A(=該当なし)

種類: 文字列

例: regular(=レギュラー)

3.2.11 size_system

詳細: サイズシステムを追加することで商品に対するその国のサイズ決定システムを指定することができます。

文字の要件: 次の11の値が承認されています:US(=米国)、UK(=英国)、EU(=欧州連合)、DE(=ドイツ)、FR(=フランス)、JP(=日本)、CN(=中国)、IT(=イタリア)、BR(=ブラジル)、MEX(=メキシコ)、AU(=オーストラリア)

文字数制限: N/A(=該当なし)

種類: 文字列

例: US(=米国)

---

マーケットプレイス販売者向け

 

3.2.12 cross_sellers_product_id

お客様がマーケットプレイスであり、かつ複数の販売者へ商品を再販している場合にのみこのフィールドは必要です。

cross_sellers_product_idとは、異なる販売者によって販売される同一商品を参照する一意の商品識別子です。 ひとたびcross_sellers_product_idが商品に割り当てられインポートされれば、 cross_sellers_product_idは別の商品には使用できず、また特定の商品のcross_sellers_product_idを変更することもできません。 cross_sellers_product_idは商品の集まりを表すことができるために 、複数の商品がcross_sellers_product_idについて同一の値を持つ場合があります

文字の要件: cross_sellers_product_idは文字または数字で始まる必要があり、またASCII文字のみを含むことができます。

文字数制限: 250

種類: 文字列

例: abc123

3.2.13 seller_name

お客様がマーケットプレイスであり、かつ複数の販売者へ商品を再販している場合にのみこのフィールドは必要です。

seller_nameは販売者の表示nameを識別します。 このnameは、一般的に販売者のページもしくは購入ボックス内の特定の商品と一緒に表示されるnameです。 seller_nameとseller_idとの間には一対一の関係があることが推奨されます。

文字数制限: 200

種類: 文字列

例: My Electronics Store(=私の電子機器店)

3.2.14 seller_id

お客様がマーケットプレイスであり、かつ複数の販売者へ商品を再販している場合にのみこのフィールドは必要です。

seller_idとはお客様の小売りサイトの販売者を表す一意の識別子です。 seller_idとseller_nameとの間には一対一の関係があることが推奨されます。

文字数制限: 200

種類: 文字列

例: 3265fd

---

配送情報

3.2.15 shipping

この属性は対応する各国についての配送の詳細を指定するために使用され、価格とサービスを表示します。

種類: 文字列

例:

 <shipping>
<country>US(米国)</country>
<service>標準</service>
<price>15.5 USドル</price>
</shipping>

3.2.16 shipping_weight

「shipping_weight」は商品の重量を表します。

文字の要件: 次の単位だけが承認されています:lb(=ポンド)、oz(=オンス)、g(=グラム)、kg(=キログラム)

種類: 文字列

例: 1kg

3.2.17 shipping_height

「shipping_height」は商品の高さを表します。

3.2.18 shipping_width

「shipping_width」は商品の幅を表します。

3.2.19 shipping_length

詳細:「shipping_length」は商品の配送時間の長さを表します。

3.2.20 shipping_label

この属性は、傷みやすい、嵩張るまたは販促などお客様の選択した値を使用して特定の商品にラベルを割り当てるために使用されます。

文字数制限: 100

種類: 文字列

例:promotion(=販促)

---

商品の包装と束

3.2.21 multipack

この属性は同一の商品の1パックを指定します。

種類:Integer(整数)

例: 2

3.2.22 is_bundle

この属性は様々な商品で出来た1グループを指定します。

種類: ブール代数

例: FALSE(=偽)

3.2.23 promotion_id

詳細:この属性はプロモーションIDを指定します。

制限事項: 文字列

種類: 60

例: 123654

3.2.24 promo_text

詳細: このフィールドにはこの商品の販促用テキストが含まれます

制限事項: 文字列

種類: 60

例: 特別購入

---

追加属性

3.2.25 custom_label_0

商品に関する追加のカスタム情報を追加します。

文字の要件:5つのカスタムラベルのみが認可されています(0から4)

文字数制限: 100

種類: 文字列

 

3.2.27 adwords_redirect

Google Shoppingからのすべてのクリックを別々に追跡するためのURL。

文字数制限: 200

種類: URL

例: http://www.mywebsite.com/productpage.html

3.2.28 excluded_destination

「除外された目的地」属性はそれがお客様の商品データに表示されてもどこかの目的地に表示されるのを防止するためのものです。

 

3.2.30 unit_pricing_measure

「単価決定の測定」属性はアイテムの測定と寸法を定義します。例:25flozまたは15oz。

例: 15oz

3.2.31 unit_pricing_base_measure

「単価決定のベース測定」属性は単価の基準のお客様の基本設定を指定します。例えば、50floz(液量オンス)。

例: 50oz

3.2.32 display_ads_title

このフィールドは希望に応じて(「title」とは違う)表示広告に別のtitleを表示するために使用することができます。

短めのtitleは当社の表示バナーに適合する可能性が高いのですが、Criteo Searchのためには長めのtitleの方が効果があります。当社としては「title」中には完全な/長いtitleを、「display_ads_title」には短めのtitleを推奨します。

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

種類:文字列

3.2.33 display_ads_value

アイテムのpriceと同一の通貨にそのアイテムのマージンが含まれます。 複数のマージンは実際の商品マージンを不明にするためにも使用できますが商品全般で一貫性を持たせることが推奨されます。

値の制限 :商品priceの10倍

種類:文字列

 :299.99

3.2.34 map_price

map_priceのフィールドはある商品の「広告主price最小値」を表します。 このフィールドの値は当社広告には決して表示されず、何らかの理由が指定されなければなりません。map_priceより劣るpriceを広告に表示することはできません。 商品の現在のpriceがmap_priceより低い場合、priceは広告には表示されません。

制限事項:ドル表記などの場合で、小数点以下を表す必要がある場合は、セパレーターはピリオド(.)で設定してください。

種類:文字列

 :1299.99

3.2.34 model_number

model_numberは一連の商品の一つずつを区別するために使用されます。 model_numberは同一カテゴリーにある類似の商品を区別するためにブランド別に使用されることも多いです。 model_numberは別々のid値を持つ類似のバリエーション上に表示される時もあります。

文字数制限: 200

文字の要件: model_numberはASCII文字のみを含むことができます。

種類: 文字列

例: AXY27

 

実例カタログの構造

XMLフィードの実例

XML

<rss xmlns:g="http://base.google.com/ns/1.0"version="2.0">

    <channel>

        <title>Your Website</title>

        <link>http://www.yoursite.com/us/</link>

        <description>Your Website</description>

        <item>

            <g:id>abc123-black-7.5</g:id>

            <g:title>Working Boots Size 7.5</g:title>

            <g:description>Excellent for daily use</g:description>

            <g:google_product_category>Women’s > Shoes > Working Boots</g:google_product_category>

            <g:link>http://www.example.com/product/working-boots</g:link>

            <g:image_link>http://www.example/com/product/image/working-boots.png</g:image_link>

            <g:additional_image_link>http://www.example.com/product/image/working-boots-side.png</g:additional_image_link>

            <g:additional_image_link>http://www.example.com/product/image/working-boots-side_2.png</g:additional_image_link>

            <g:availability>in stock</g:availability>

            <g:price>1299.99</g:price>

            <g:sale_price>1199.99</g:sale_price>

            <g:gtin>0001234560012</g:gtin>

            <g:brand>Criteo</g:brand>

            <g:adult>no</g:adult>

            <g:product_type>Women’s &gt; Shoes &gt; Working Boots</g:product_type>

            <g:mobile_link>http://m.example.com/product/working-boots</g:mobile_link>

            <g:condition>new</g:condition>

            <g:availability>in stock</g:availability>

            <g:availability_date>2016-06-25T13:00-0800</g:availability_date>

            <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date>

            <g:item_group_id>abc123</g:item_group_id>

            <g:color>Black</g:color>

            <g:gender>male</g:gender>

            <g:age_group>adult</g:age_group>

            <g:material>leather</g:material>

            <g:pattern>Striped</g:pattern>

            <g:size>L</g:size>

            <g:size_type>regular</g:size_type>

            <g:size_system>US</g:size_system>

            <g:shipping>

                <g:country>US</g:country>

                <g:service>Standard</g:service>

                <g:price>5.5 USD</g:price>

            </g:shipping>

            <g:shipping_weight>1 kg</g:shipping_weight>

            <g:shipping_label>promotion</g:shipping_label>

            <g:multipack>2</g:multipack>

            <g:is_bundle>FALSE</g:is_bundle>

            <g:custom_label_0>custom data 0</g:custom_label_0>

            <g:custom_label_1>custom data 1</g:custom_label_1>

            <g:custom_label_2>custom data 2</g:custom_label_2>

            <g:custom_label_3>custom data 3</g:custom_label_3>

            <g:custom_label_4>custom data 4</g:custom_label_4>

            <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date>

            <g:adwords_redirect>http://www.mywebsite.com/productpage.html</g:adwords_redirect>

            <g:excluded_destination>Shopping</g:excluded_destination>

            <g:expiration_date>2016-07-24</g:expiration_date>

            <g:unit_pricing_measure>15oz</g:unit_pricing_measure>

            <g:unit_pricing_base_measure>50oz</g:unit_pricing_base_measure>

        </item>

    </channel>

</rss>

 



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