ログイン

サポートセンター

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

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

Criteoフィード仕様(小売)

このページでは、フィードがない場合のフィードの作成方法を説明します。Googleフィードがすでにある場合は、こちらのページ参照してください。

 

商品フィードは、お客様のサイト上のすべての広告に関する情報を含むデータファイルであり、この情報はダイナミック広告の作成に利用されます。 

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

商品フィードを作成する場合には、以下の点に留意してください:

  • 商品情報には、HTMLタグやスタイルタグを含めてはいけません。
  • フィードにある商品IDは、タグで渡される商品IDに一致している必要があります。
  • Criteoが商品フィードを取得することができるように、次の形式の一つを使用してください。

フォーマット

詳細

ダウンロード

CSV/TSV

このフォーマットでは、値をカンマ区切りまたはタブ区切りで指定します。ヘッダーをファイルの最初の行に指定します。フィールド名には、スペースと下線を含めることもできます(例:image_link、image link)

 フィード例

 XML

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

 フィード例

フィードのインポートで使用可能なプロトコルに関する詳細な情報は、Criteoの商品フィードのインポート方法についてをご覧ください。 

1. 商品情報の提供

1.1. 必須フィールド

id

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

idは特定の1つの商品を表すための英数字の識別子です。idを特定の商品に割り当ててインポートした後は、同じidを別の商品に使用することも、商品のidを変更することもできません。item_group_idを指定する場合は、idに子ID/SKUを指定してください。

  • 文字の要件:idには、引用符を除くASCII文字のみを含めることができます。
  • 文字数制限:240
  • 種類:文字列
  • 入力例:abc123-black-7.5

title

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

titleは商品名で、通常商品の詳細ページに表示されます。これはバナー内に商品名を表示するために利用されます。

 

  • 文字の要件:商品名は、文字または数字で始まる必要があります。
  • 文字数制限:150
  • 種類:文字列
  • 例:作業靴(サイズ:26.0 cm)

リンク先URL

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

linkは、商品専用の詳細ページのURLです。通常、リンクは商品に対して1つですが、必ずしもその必要はありません。このURLのページにある商品情報は、お客様のフィード内の同じ商品の情報と一致している必要があります。すべてのURLには、プロトコル(http://またはhttps://)を指定してください。

これはユーザがバナーの商品をクリックした際のリダイレクト先のURLです。トラッキングコードはURLに含めるか、あるいはCriteoが後から追加することができます。モバイルサイトをお持ちの場合には、ユーザがモバイルデバイスを使用した時に商品URLがモバイルサイトの商品ページに自動的にリダイレクトされるよう、設定することをおすすめします。

  • 文字の要件:linkは(http://またはhttps://)プロトコルで始まり、続いて商品詳細ページのフルURLを指定する必要があります。すべての記号は、エンコード可能である必要があります。例えば、「$」は「%24」で置換できる必要があります。英語以外の文字など、ASCII以外の文字も含めることができます。
  • 文字数制限:1024
  • 種類:文字列
  • 入力例:http://www.example.com/product/working-boots

image_link

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

image_linkは、商品の画像ファイルのパスを指定するURLです。bigimageは、商品の画像をバナーに表示するために使用されます。画像は最低でも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

  • 文字の要件:bigimageは、「https://」または「http://」で始まり、続いて商品画像のフルURLを指定する必要があります。すべての記号は、エンコード可能である必要があります。例えば、英語以外の文字などASCII以外の文字を含め、「$」は「%24」に置き換えられる必要があります。
  • 文字数制限:2000
  • 種類:文字列
  • 例:http://www.example.com/product/image/working-boots-big.png

price

priceは、サイトで購入可能な商品の価格です。商品が「on sale」の場合、priceフィールドにはより低い価格が設定されます。priceには、サイトの通貨と同じ通貨で価格を設定してください。また、小数点以下の区切り文字にはピリオド(.)を使用し、3桁毎の区切り文字は使用しないでください。

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

categoryid1

categoryid1は、商品が属する最上位レベルのカテゴリーです(フィードには最大3つのレベルのカテゴリーを指定できますが、CPCの最適化に向けて1つのみが使用されます)。

  • 文字の要件:N/S
  • 文字数制限:N/S
  • 種類:文字列
  • :PC関連

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

このフィールドは必須ではありませんが、キャンペーンの管理を簡単にしたり、パフォーマンスや買物客のエクスペリエンスを向上させるために、設定することをおすすめします。 

description

Facebook広告には、このフィールドが必要になります。

このdescriptionはその名前に追加的に詳細な情報を記述する短いテキストです。バナーデザインに最適に表示されせるには50文字未満にdescriptionを設定することを推奨します。ただし、descriptionは全てのCriteoバナーに表示されるフィールドではありません。

  • 文字の要件:descriptionは、文字または数字で始める必要があります。style、embed、object、anchorタグなど、すべてのHTMLタグをこのフィールドから削除してください。
  • 文字数制限:5000
  • 種類:文字列
  • 入力例:毎日の利用に履きやすいです

sale_price

sale_priceは、商品のメーカーが推奨する販売価格です。商品が「on sale」の場合、priceフィールドにはより高い価格が設定されます。priceには、サイトの通貨と同じ通貨で価格を設定してください。また、小数点以下の区切り文字にはピリオド(.)を使用し、3桁毎の区切り文字は使用しないでください。

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

categoryid2

categoryid1は、商品が所属する2番目のレベルのカテゴリーです。

  • 文字の要件:N/S
  • 文字数制限:N/S
  • 種類:文字列
  • :キーボードとマウス

star

starは、商品の評価です(小数点区切り文字とする)。

  • 文字の要件:0.5刻みの1~5の数字
  • 文字数制限:N/S
  • タイプ: 数字
  • :4.5

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

categoryid3

categoryid1は、商品が所属する2番目のレベルのカテゴリーです。

  • 文字の要件:N/S
  • 文字数制限:N/S
  • 種類:文字列
  • :ワイヤレスマウス

availability

availabilityは、その製品がサイトで購入可能かどうかを示しています。availabilityは、3つの値を取ることができます:preorder(仮注文:商品は現在出荷できないが注文は可能である)、out of stock(在庫切れ:商品は出荷しておらず、注文も受け付けない)、in stock(在庫あり: 商品は出荷中で注文を受付可能な状態)。out of stockの状態にある商品は、バナーへの表示対象から除外されます。

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

additional_image_link

additional_image_linkは、商品画像のファイルパスを指定するURLです。additional_image_linkを使って、商品の画像をバナーに表示します。画像は最低でも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は、http://(https://ではありません)で始まり、続いて商品の画像のフルURLを指定する必要があります。すべての記号は、エンコード可能である必要があります。例えば、「$」は「%24」で置換できる必要があります。ただし、additional_image_linkでは、クエリ文字列に記号文字(「?」以降の文字)を含めることはできません。
  • 文字数制限:2000
  • 種類:文字列
  • : http://www.example.com/product/image/working-boots-side.png

adult

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

  • 文字の要件:値は「yes」または「no」のいずれかに指定します。
  • 種類:「boolean」(ブーリアン)
    「boolean」(ブーリアン)は、「true(真)」(トルー、トゥルー)と「false(偽)」(フォールス)という2つの値を格納する型です。
  • :no

brand

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

brandには、商品のブランド名を指定します。ブランドが明確でない商品の場合は省略可能です。

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

item_group_id

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

  • 文字の要件:item_group_idには、引用符を除くASCII文字のみを含めることができます。
  • 文字数制限:240
  • 種類:文字列
  • 入力例:abc123
この記事は役に立ちましたか?
0人中0人がこの記事が役に立ったと言っています
Powered by Zendesk