Sign in

Welcome to our Support Center

Get help with integration and live campaigns

Welcome to our Support Center. Get help with integration and live campaigns

Criteo Feed Specifications

Overview

A product feed is a file that contains the complete catalog of product details for your site. We use this to display your product details within the banners.

In this article, we'll tell you which product attributes you can include in your feed and how to format them.

Product information in a Criteo feed

The Criteo product feed features both mandatory and optional fields.

The mandatory fields listed below are needed to import the product feed. Without them, we cannot carry out the import: 

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

The fields listed below are not mandatory, but strongly recommended. The information will help the Criteo engine to optimize your campaign performance:

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

id

Mandatory – this field is required for all products in the feed. It cannot be empty/blank.

The id is a unique product identifier. It can contain alphanumeric characters that represent one, and only one, product. Once an id is assigned to a product and imported, the id may not be used for a different product, nor can the id for a particular product change. Theproduct id in the product feed is the same one implemented in the Criteo OneTag.

Character limit: 250

Data type: string

Characters requirements: The id must start with either a letter or number, and can only contain ASCII characters

Example: abc123

 

name

Mandatory – This field is required for all products in the feed. It cannot be empty/blank

The name is the product’s title, typically as it is displayed on the product’s detail page. This will be used as the main text descriptor in the banners for a given product. Because of the design of the banners, shorter names (fewer than 25 characters) are more likely to fit in Criteo’s formats and layouts. If you have products with multiple options (eg. color, size, gender), it is best to only put the parent product’s name in this field.

Character limit: 500 (25 is recommended)

Data type: string

Characters requirements: The name must start with either a letter or number, and can only contain ASCII characters. Remove all HTML tags from this field, including style tags.

Example: Set of 6 Measuring Cups

 

producturl

Mandatory – This field is required for all products in the feed. It cannot be empty/blank

The producturl is the product’s dedicated detail page. The producturl is usually, although not necessarily, unique to a given product. The product information on this URL should match the corresponding information provided in your feed. The product URL should be the same as the product page that is going to be tagged. You may include tracking codes in theproducturl, but they are not required.

Character limit: 1024

Data type: string

Character requirements: The producturl must start with the protocol (http:// or https://) followed by the full URL of the product detail page. All symbols must be encoded, e.cg. $ must be replaced with %24

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

 

bigimage

Mandatory – This field is required if smallimage is not populated. If smallimage is blank/empty, bigimage must be populated

The bigimage is a URL that specifies a file path to a given product’s image. The bigimage will be used to display the product’s image in the banners. Ideally, images are between 300 and 400 pixels wide and under 1MB in size. The image must have a Content-Type header specified, either image/png or image/jpeg.

Character limit: 1024

Data type: string

Character requirements: The bigimage must start with http:// (not https://) followed by the full URL of the product’s image. All symbols must be encoded, eg. $ must be replaced with %24. However, the bigimage cannot contain any symbols in the query string (any characters after the ?)

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

 

smallimage

Mandatory - This field is required if bigimage is not populated. If bigimage is blank/empty, smallimage cannot be blank/empty

The smallimage is a URL that specifies a file path to a given product’s image. The smallimage will be used to display the product’s image in the banners. Ideally, images are between 300 and 400 pixels wide and under 1MB in size. If you are already populating bigimage, you may use images less than 300 pixels wide in smallimage. The image must have a Content-Typeheader specified, either image/png or image/jpeg. 

Character limit: 1024

Data type: string

Character requirements: The smallimage must start with http:// (not https://) followed by the full URL of the product’s image. All symbols must be encoded, eg. $ must be replaced with %24, however, the smallimage cannot contain any symbols in the query string (any characters after the ?)

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

  

description

The description is a short piece of text that gives more information about a product in addition to its name. Because of the design of the banners, shorter descriptions (under 50 characters) fits better in the banners.

Character limit: 500 (50 is recommended)

Data type: string

Character requirements: The name must start with either a letter or number, and can only contain ASCII characters. Remove all HTML tags from this field, including style, embed, object, and anchor tags.

Example: Comes with a nifty ring to hold them together.

 

price

The price is the price at which the product is available for purchase on the site. If a given product is “on sale,” the price would be populated with the sale price. The price should be in the same currency as the site, so do not include any currency symbol or indicator in this field. Only populate price with the numeric value using period (.) as the decimal separator and no thousands separator.

Character limit: 10

Data type: float

Character requirements: No currency symbol (e.g. $) or currency (eg. USD). The decimal separator must be period (.) with no thousands separator.

Example: 1199.99

 

retailprice

The retailprice is the price at which the product is recommended to be sold for by the manufacturer. If a given product is “on sale,” the retailprice would be populated with the higher price. The retailprice should be in the same currency as the site, so do not include any currency symbol or indicator in this field. Only populate retailprice with the numeric price using period (.) as the decimal separator and no thousands separator.

Character limit: 10

Data type: float

Character requirements: No currency symbol (e.g. $) or currency (e.g. USD). The decimal separator must be period (.) with no thousands separator.

Example: 1299.99

 

categoryid1

The categoryid1 is a category to which the product belongs, typically a top-level category (e.g. Women’s). There are no restrictions on what categories can be populated here, so you may use categoryid1 to map to a specific top-level category on your site. Categoryid1 is case-sensitive, so if you use women’s for one product and Women’s for another, Criteo will interpret these as two different categories.

Character limit: 500

Data type: string

Character requirements: The categoryid1 must start with either a letter or number, and can only contain ASCII characters

Example: Women’s

 

categoryid2

The categoryid2 is a category to which the product belongs, typically a mid-level category (eg. Shoes). There are no restrictions on what categories can be populated here, so you may use categoryid2 to map to a specific top-level category on your site. Categoryid2 is case-sensitive, so if you use shoes for one product and Shoes for another, Criteo will interpret these as two different categories.

Character limit: 500

Data type: string

Character requirements: The categoryid2 must start with either a letter or number, and can only contain ASCII characters

Example: Shoes

 

categoryid3

The categoryid3 is a category to which the product belongs, typically a bottom-level category (eg. Working Boots). There are no restrictions on what categories can be populated here, so you may use categoryid3 to map to a specific bottom-level category on your site. Categoryid3 is case-sensitive, so if you use working boots for one product and Working Boots for another, Criteo will interpret these as two different categories.

Character limit: 500

Data type: string

Character requirements: The categoryid3 must start with either a letter or number, and can only contain ASCII characters

Example: Working Boots

Was this article helpful?
0 out of 0 found this helpful