ログイン

サポートセンター

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

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

Criteoフィード仕様

CriteoはGoogle Feedの仕様に対応しています。 

このページでは、お客様のフィードに含めることのできる内容およびGoogleの仕様に基づき各フィールドをフォーマットする方法についての詳細を説明しています。

1. 商品情報の提供

1.1. 必須フィールド

id

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

Googleに必要なフィールド

  • 文字の要件: このidはASCII文字のみを含むことができ、引用符を含んではなりません。
  • 文字数制限: 240
  • 種類: 文字列
  • 例: abc123-black-7.5

title

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

Googleに必要なフィールド

Google Shoppingフィードを拒絶する予定の場合は、最も長いタイトルを「title」に、また、表示するのにより適した短めのタイトルを「display_ads_title」に入力することが推奨されます。

  • 文字の要件: nameは文字または数字で始める必要があります。
  • 文字数制限: 150
  • 種類: 文字列
  • 例: Working Boots – Size 7.5

リンク先URL

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

Googleに必要なフィールド

  • 文字の要件: linkは、プロトコル(http:// or https://)で始まりそれに続いて商品詳細ページのフルURLが入力される必要があります。すべての記号はエンコードされる必要があります。例:「$」は「%24」で置換する必要があります。
  • 文字数制限: 1024
  • 種類: 文字列
  • 例: http://www.example.com/product/working-boots

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で表示できるようユーザエージェントをホワイトリストに登録してください。

Googleに必要なフィールド

  • 文字の要件: image_linkは、「https://」または「http://」で始まりそれに続いて商品画像のフルURLが入力される必要があります。すべての記号はエンコードされる必要があります。例:「$」は「%24」で置換する必要があります。 
  • 文字数制限: 2000
  • 種類: 文字列
  • 例: http://www.example.com/product/image/working-boots.png

1.2. 特に指定が推奨されるフィールド

price

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

Googleに必要なフィールド

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

description

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

  • 文字の要件: descriptionは文字または数字で始める必要があります。style、embed、object、anchorタグなど全てのHTMLタグをこのフィールドから削除してください。
  • 文字数制限: 5000 
  • 種類: 文字列
  • 例: Excellent for daily use.(=日常使用に優れています。)

item_group_id

item_group_idは、固有の親レベルの商品識別子です。これには英数字が使用可能で、子商品の集合を1つの商品名として表現します。item_group_idを特定の商品に割り当てインポートした後は、このitem_group_idを別の商品に使用することも、商品のitem_group_idを変更することもできません。item_group_idは、商品の集合を表すものであるため、複数の商品が同じitem_group_idを持つことができます。

Googleに必要なフィールド(国に依存します)

  • 文字の要件: item_group_idはASCII文字のみを含むことができ、引用符を含んではなりません。
  • 文字数制限: 240
  • 種類: 文字列
  • 例: abc123

フィードをインポートする際は、フィード内のitem_group_idフィールドに基づいて「親商品」と呼ばれる新しい商品をカタログインポートツールが作成し、すべての子商品(同じitem_group_idの商品)はこの商品に関連付けられます。親商品の情報はフィードに存在しないため、フィード内の(レコメンド可能な商品の中で)最低価格の子商品から取得されることになります。

GTIN (UPC, EAN) / MPN

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

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

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桁の数字です。

Googleに必要なフィールド

  • 文字の要件: その値は、8、12、13または14桁のデジタル数字である必要があります(UPC、EAN、JANまたはISBN)。
  • 文字数制限:MPN に対して 50 / 70
  • 種類: 文字列
  • 例: 0001234560012

google_product_category

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

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

Googleに必要なフィールド

  • 文字の要件: IDと完全なカテゴリーパスの両方が容認されます
  • 種類: 文字列
  • 例: 女性もの > シューズ > ワーキングブーツまたは 2271

1.3. 指定が推奨されるフィールド

product_type

product_typeは商品が属するカテゴリー(またはカテゴリーのリスト)です。 product_typeフィールドは、商品のマーチャンダイジングカテゴリーまたは一連のマーチャンダイジングのカテゴリーをリストします。 それはお客様のWebサイトのカテゴリーに一致する必要があります。 階層の各レベルは「>」で区切る必要があります。 商品が複数のカテゴリーで販売される場合、一次カテゴリーを先頭にし、 コンマ(,) で区切られた様々なカテゴリーをお送りください。 product_typeは大文字小文字の区別があるので、ある商品に(小文字始まりの)woman'sを使用し別の商品に(大文字始まりの)Women'sを使用した場合Criteoはこれらは二つの別々のカテゴリーだと解釈します。

  • 文字の要件: product_typeは文字または数字で始まる必要があり、またASCII文字のみを含むことができます。カテゴリー間の区切り文字は「>」(XMLフィード用の>)でなければなりません。 完全なカテゴリーパスにのみ対応しています。商品が複数のカテゴリーで販売される場合、一次カテゴリーを先頭にし、 コンマ(,) で区切られた様々なカテゴリーをお送りください。そのパスのカテゴリーIDは承認できません。IDはproduct_type_keyフィールドに記入する必要があります。 
  • 文字数制限: 500
  • 種類: 文字列
  • 例:
    • 単一: コンピューター > キーボードとマウス > マウス > ワイヤレスマウス
    • 複数: コンピューター > キーボードとマウス > マウス > ワイヤレスマウス、ギフト > お父さん用 > マウス

availability

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

Googleに必要なフィールド

  • 文字列の要件: availabilityは次の3つの値のいずれかで入力する必要があります。
    • 仮注文
    • 在庫切れ
    • 在庫状況
  • 文字数制限:16
  • 種類: 文字列
  • 例: in stock(=在庫あり)

adult

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

Googleに必要なフィールド(国に依存します)

  • 文字の要件: 値はyes(=はい)または no(=いいえ)である必要があります
  • 種類: ブール代数
  • 例: no(いいえ)

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

sale_price

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

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

brand

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

Googleに必要なフィールド

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

1.4. オプションフィールド

display_ads_title

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

タイトルは短い方がCriteoの表示バナーに入りやすいですが、Criteo Searchには長いタイトルの方が効果的と言えます。Criteoでは、「title」には完全なタイトルや長いタイトルを、「display_ads_title」には短めのタイトルを推奨しています。

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

display_ads_value

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

  • 値の制限 :商品priceの10倍
  • 種類:文字列
  •  :299.99

custom_label_0

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

  • 文字の要件:5つのカスタムラベルのみが認可されています(0から4)
  • 文字数制限: 100
  • 種類: 文字列
この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています
Powered by Zendesk