ログイン

サポートセンター

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

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

Criteoの商品フィードの仕様

1.概要

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

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

2 - Criteoフィードの形式

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

フィードのフォーマット 詳細 ダウンロード

TSV

タブ区切り形式となります。ヘッダー情報はファイルの第一行目で設定する必要があります。フィールド名の中にスペースが含まれる場合は削除してください。

フィードの例

CSV

カンマ区切りの形式です。ヘッダー情報はファイルの第1行目で設定してください。フィールド名の中にスペースが含まれる場合は削除してください。

フィードの例

XML

この形式はXML構造の基本を守らなければなりません。商品は一連のXMLのノードによって表されます。商品のリストは「<?xml」の宣言タグで始めなければなりません。

フィードの例

3 - 入力すべき商品情報

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

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

3.1.1 id

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

この ID はユニークな商品を識別する値です。これは英数字で構成され、一つ一つの商品に対して割り当てられるものです。あるIDが商品に割り当てられインポートされれば、そのIDは別の商品には使用できず、また特定の商品のIDを変更することもできません。item_group_idも入力した場合には、IDには子ID/SKUを入力してください。

制限事項:IDは文字または数字で始まる必要があり、ASCII文字だけを含むことができます。

文字数制限:250

種類:文字列

入力例:abc123-black-7.5

3.1.2 title

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

titleは通常商品の詳細ページに表示される商品名です。これはバナー内に商品名を表示する為に利用されます。バナーデザインに最適に表示されせるには25文字未満にtitleを設定することを推奨します。

制限事項:titleは文字または数字で始まる必要があり、またASCII文字だけを含むことができます。

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

種類:文字列

入力例:ワーキングブーツ – サイズ 27.5

3.1.3 description

description はその商品名の補足として詳細な情報を記述できるフィールドです。バナーデザインに最適に表示されせるには50文字未満にdescriptionを設定することを推奨します。ただし、descriptionは全てのCriteoバナーに表示されるフィールドではありません。

制限事項:descriptionは文字または数字で始まる必要があり、またASCII文字だけを含むことができます。style、embed、object、anchorタグなど全てのHTMLタグをこのフィールドには含めないでください。

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

種類:文字列

入力例:毎日の利用に履きやすいです

3.1.4 google_product_category

カテゴリーレベルの属性はGoogleの商品分類法に従って設定される商品カテゴリーです。

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

制限事項:カテゴリーのフルパスだけに対応します。カテゴリーIDのパスは対応できません。

種類:文字列

入力例:女性 > シューズ > ワーキングブーツ

3.1.5 link

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

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

制限事項:linkは(http://またはhttps://の)プロトコルで始まりそれに続いて商品詳細ページのフルURLを記述する必要があります。すべての記号はエンコードされる必要があります。例:「$」は「%24」で置換する必要があります。

文字数制限:1024

種類:文字列

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

3.1.6 image_link

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

image_linkは、商品画像を取得できるファイルのパスを指定するURLです。image_linkはバナー内の商品画像を表示するために使用されます。画像は幅が300から400ピクセルの間で、サイズが1MB未満であることを推奨しています。この画像はimage/pngもしくはimage/jpegのいずれかで指定された Content-Type をヘッダー情報で設定されている必要があります。画像がcURL経由でアクセスできないように制限されている場合は、「curl/7.15+(x64-criteo) libcurl/7.15+ OpenSSL zlib libidn」のuser-agentからのアクセスを許可するように設定してください。

制限事項:image_linkはhttp://もしくは https:// で始まり、それに続いて商品画像のフルURL を記述する必要があります。すべての記号はエンコードされる必要があります。例:「$」は「%24」で置換する必要があります。image_linkでは、「?」で始まるクエリ文字列には記号を含むことができません。

文字数制限:2000

種類:文字列

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

3.1.7 additional_image_link

additional_image_linkは、image_linkに記載されたものとは違う商品画像を指すファイルのパスを指定するURLです。additional_image_linkは、バナー内に商品画像を表示するために使用されます。画像ファイルは300から400ピクセルの間の幅で1MB未満のサイズであることを推奨しています。この画像はimage/pngもしくはimage/jpegのいずれかで指定された Content-Type をヘッダー情報で設定されている必要があります。画像がcURL経由でアクセスできないように制限されている場合は、「curl/7.15+(x64-criteo) libcurl/7.15+ OpenSSL zlib libidn」のuser-agentからのアクセスを許可するように設定してください。

制限事項:additional_image_linkはhttp://もしくはhttps://で始まり、それに続いて商品画像のフルURLを記述する必要があります。すべての記号はエンコードされる必要があります。例:「$」は「%24」で置換する必要があります。additional_image_linkでは、「?」で始まるクエリ文字列には記号を含むことができません。

文字数制限:1024

種類:文字列

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

3.1.8 availability

availabilityはその商品がサイトで購入できるかどうかを示します。availabilityに入力できる値は次の3つです:preorder(仮注文)(アイテムは現在はまだ配送はできませんが、購入することができます)、out of stock(在庫切れ)(アイテムは配送できず、このアイテムの注文は受け付けられません)、in stock(在庫あり)(アイテムは配送可能で、このアイテムの注文が可能です)。out of stock(在庫切れ)と設定されたアイテムはバナーで表示されません。

制限事項:availabilityは次の3つの値のいずれかで入力する必要があります:

· preorder

· out of stock

· in stock

文字数制限:25

種類:文字列

入力例:in stock(在庫あり)

3.1.9 price

priceは、商品の販売価格です。商品がセール中の場合、priceのフィールドには元の価格を設定します。priceはサイトで表示される通貨と同じ価格を設定してください。ピリオド(.)を小数点のセパレーターとして使用し千単位のセパレーターがない数字のみでpriceを入力してください。

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

文字数制限:14

種類:文字列

入力例:1299.99

3.1.10 sale_price

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

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

文字数制限:14

種類:文字列

入力例: 1199.99

3.1.11 gtinまたはmpn

グローバルトレードアイテムナンバー(GTIN)とは、世界中の商品、サービスまたはアイテムを識別するために使用されるユニークな商品識別子です。

GTINには次のものがあります。

  • GTIN-12 (UPC-A):主に北米で使用される12桁の数字です。
  • GTIN-8 (EAN/UCC-8):主に北米以外で使用される8桁の数字です。
  • GTIN-13 (EAN/UCC-13):主に北米以外で使用される13桁の数字です。
  • GTIN-14 (EAN/UCC-14または ITF-14):様々な包装レベルの取引アイテムを識別するために使用される14桁の数字です。

制限事項:各値は、8、12、13または14桁のデジタル数字である必要があります(UPC、EAN、 JANまたはISBN)。

MPNはメーカーのものであることをユニークに識別する商品番号です

文字数制限:50

種類:文字列

入力例:0001234560012

3.1.12 brand

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

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

文字数制限:70

種類:文字列

入力例:Criteo

3.1.13 adult

adult属性はその商品がすべてのユーザーとすべての客層に表示されても安全であるかどうかを示します。adult商品はCriteoのバナーには表示できません、また特定の広告配信ネットワークではお客様のキャンペーン(アカウント)がブラックリスト化されてしまうことにつながる場合があります。この商品をバナーに掲載しないようにするにはフィールドに「yes」の値を設定します。

制限事項:値はyes もしくはno である必要があります

種類:

boolean(yesもしくはno)

実例:no

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

3.2.1 基本の商品情報

名前:product_type

product_typeは商品が属するカテゴリー(またはカテゴリーのリスト)です。どんなカテゴリーがここに入力されるかについて制限はありませんので、product_typeを使用してお客様のサイトの特定のトップカテゴリーへマッピングできます。product_typeは大文字小文字の区別があるので、ある商品に(小文字始まりの)woman'sを使用し別の商品に(大文字始まりの)Women'sを使用した場合Criteoはこれらは二つの別々のカテゴリーだと解釈します。

制限事項:product_typeは文字または数字で始まる必要があり、ASCII文字だけを含むことができます。カテゴリー間の区切り文字は「>」でなければなりません。

文字数制限:500

種類:文字列

入力例:Women’s &gt; Shoes &gt; Working Boots

3.2.2 mobile_link

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

制限事項:linkは(http://またはhttps://の)プロトコルで始まりそれに続いて商品詳細ページのフルURLを記述する必要があります。すべての記号はエンコードされる必要があります。例:「$」は「%24」で置換する必要があります。

文字数制限:2000

種類:文字列

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

3.2.3 condition(状態)

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

制限事項:次の3つの値だけが利用可能:

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

種類:文字列

入力例:new

---

商品のバリエーション

3.2.6 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文字だけを含むことができます。

文字数制限:250

種類:文字列

入力例:abc123

3.2.7 color(色)

詳細:この属性は商品のカラーを示します。

文字数制限:100

種類:文字列

入力例:ブラック

3.2.8 gender(性別)

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

制限事項:次の3つの値のいづれかを設定します:

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

種類:文字列

入力例:male(男性)

3.2.9 age_group

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

制限事項:次の5つの値のいづれかを設定します:

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

種類:文字列

入力例:adult

3.2.10 material(素材)

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

文字数制限:200

種類:文字列

入力例:leather(皮)

3.2.11 pattern(パターン)

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

文字数制限:100

種類:文字列

入力例:Striped(ストライプ)

3.2.12 size(サイズ)

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

文字数制限:100

種類:文字列

入力例: L

3.2.13 size_type

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

制限事項:次の5つの値のいづれかを設定します:

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

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

種類:文字列

入力例:regular(レギュラー)

3.2.13 size_system

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

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

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

種類:文字列

入力例:US(米国)

---

配送情報

3.2.14 shipping(配送)

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

種類:文字列

例:

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

3.2.15 shipping_weight

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

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

種類:文字列

入力例: 1 kg

3.2.16 shipping_height

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

3.2.17 shipping_width

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

3.2.18 shipping_length

詳細:shipping_lengthは商品の長さを表します。

3.2.19 shipping_label

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

文字数制限:100

種類:文字列

入力例:promotion(販促)

---

商品の包装と束

3.2.20 multipack(マルチ包装)

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

種類:Integer(整数)

実例: 2

3.2.21 is_bundle

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

種類:「boolean」(ブーリアン)
「boolean」(ブーリアン)は、「true(真)」(トルー、トゥルー)と「false(偽)」(フォールス)という2つの値を格納する型です。

実例:FALSE(偽)

3.2.22 promotion_id

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

制限事項:文字列

文字数制限:60

入力例:123654

---

追加属性

3.2.23 custom_label_0

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

制限事項:level0~4の5つのカスタムラベルのみが設定可能です。

文字数制限:100

種類:文字列

3.2.24 sale_price_effective_date

この属性は「sale_price」と共に使用されて販売価格の有効期限の日付の範囲を指定します。

制限事項:前方スラッシュ(/)で区切られた開始日付と終了日付。開始日付の形式はYYYY-MM-DDで指定された日付に「T」の文字が続き、販売が開始される日の時間をISO 8601標準で定義された時間帯での記述方式に従ってください。終了日付も開始日付と同一の形式でなければなりません。

文字数制限:51

入力例: 2016-03-01T13:00-0800/2016-03-11T15:30-0800

3.2.25 adwords_redirect

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

文字数制限:200

種類:URL

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

3.2.26 excluded_destination

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

3.2.27 expiration_date

その商品がそれ以降は推奨されなくなる日付。

文字数制限:10

種類: ISO 8601形式

実例:2016-07-24

3.2.28 unit_pricing_measure

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

実例:15oz

3.2.29 unit_pricing_base_measure

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

実例:50oz

実例カタログの構造

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>誤</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