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 Specification (Flight)

The product feed is a data file which contains organised information about available flights on your site, and this information will be used to build your dynamic ads. 

In this article, you will find details about what you can include in your feed and how to format each field.

It is important to keep in mind the following points when building your product feed:

  • Product information should not contain HTML tags or style tags
  • The product IDs in the feed must match the product IDs passed in the tags.
  • To make sure Criteo can retrieve your product feed, please use one of these formats:

Format

Detail

Download

CSV/TSV

This format is based on the Comma-separated value or the Tab-separated value. The header must be declared in the first row of the file.Field names can contain spaces or underscores (e.g. image_link or image link)

 Feed example

 XML

 This format should respect the basics of the XML structure. Products are represented by a set of XML nodes. The product list must start by <?xml declaration tag. 

 Feed example

For more information regarding the protocols that can be used to import your feed check how Criteo imports your feed.

1. PRODUCT INFORMATION TO PROVIDE

1.1. MANDATORY FIELDS

id

This field is required for all products in the feed, and cannot be empty/blank.

The id is a unique flight identifier that represents one, and only one, city pair (origin-destination).

  • Character Requirements: The id must only contain ASCII characters, and must not contain quotation marks. IATA Airport codes of the Origin and Destination Airports (string).
  • Limit: 240
  • Type: String
  • Example: JFK-LHR

title

This field is required for all products in the feed, and cannot be empty/blank.

The title is the name of the destination city. This will be used as the main text descriptor in the banners for a given product.

  • Character Requirements: The name must start with a letter.
  • Limit: 150
  • Type: String
  • Example: London

description

This field is required for Facebook ads.

The description is the name of the departure city.

  • Character Requirements: The description must start with a letter.
  • Limit: 5000
  • Type: String
  • Example: New York.

link

This field is required for all products in the feed, and cannot be empty/blank.

The link is a link into calendar page for given city pair, or search results page, where the promoted price can be found. You can pass useful extra data to accelerate user inputs: number of tickets, children, etc. Please specify the protocol (http:// or https://) for all URLs.

  • Character Requirements: The link must start with the protocol (http:// or https://) followed by the full URL of the product detail page. All symbols must be encoded. Eg. $ must be replaced with %24. Including non-ASCII characters such as non-English letters.
  • Limit: 1024
  • Type: String
  • Example: http://www.travelsite.com/flight/JFK-LHR.html

image_link

This field is required for all products in the feed, and cannot be empty/blank.

The image_link 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 should be at least 800x800 pixels and weigh under 16MB. The image must have a Content-Type header specified, either image/png, image/gif or image/jpeg. If you restrict your images from being accessible via cURL, please whitelist our user-agent so we may display your images in the Criteo banners: curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

  • Character Requirements: The image_link must start with http:// or https:// followed by the full URL of the product’s image. All symbols must be encoded. Eg. $ must be replaced with %24. Including non-ASCII characters such as non-English letters.
  • Limit: 2000
  • Type: String
  • Example: http://www.travelsite.com/images/london_big.jpg

price

The price is the price of the flight.  Ideally the price should be the best available price over the next 6-8 weeks. Alternatively, it could be the price of the best flight found yesterday. The price should be in the same currency as the site. Only populate price with the numeric price using a period (.) as the decimal separator and no thousands separator.

  • Character Requirements: The decimal separator must be a period (.) with no thousands separator.
  • Limit: 14
  • Type: String
  • Example: 199.99

categoryid1

The categoryid1 indicates whether a flight is domestic/international, short haul/long haul, etc. (you may provide up to 3 category levels in your feed but only one can be used for CPC-optimization).

  • Character Requirements: The categoryid1 must start with a letter or number, and can only contain ASCII characters..
  • Limit: 500
  • Type: String
  • Example: Shorthaul

1.2. HIGHLY RECOMMENDED FIELDS

These fields are not required, but highly recommended as they will ease campaign management, help improve performance, and/or improve shopper experience.  

categoryid2

The categoryid2 can be filled with the departure city name (or the IATA code).

  • Character Requirements: The categoryid2 must start with a letter or number, and can only contain ASCII characters..
  • Limit: 500
  • Type: String
  • Example: London

categoryid3

The categoryid3 can be filled with the destination city name (or the IATA code).

  • Character Requirements: The categoryid3 must start with a letter or number, and can only contain ASCII characters.
  • Limit: 500
  • Type: String
  • Example: New York

additional_image_link

The additional_image_link is a URL that specifies a file path to a given product’s image. The additional_image_link will be used to display the product’s image in the banners. Ideally, images should be at least 800x800 pixels and weigh under 16MB. The image must have a Content-Type header specified, either image/png, image/gif or image/jpeg. If you restrict your images from being accessible via cURL, please whitelist our user-agent so we may display your images in the Criteo banners: curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

  • Character Requirements: The additional_image_link 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 additional_image_link cannot contain any symbols in the query string (any characters after the ?).
  • Limit: 2000
  • Type: String
  • Example: http://www.travelsite.com/images/london_big.jpg

1.3. RECOMMENDED FIELDS

availability

The availability indicates if the product may be purchased on the site. You may populate availability with 3 possible values: preorder (item is not currently shipping, but still may be purchased), out of stock (item is not shipping and you are not accepting orders for this item), and in stock (item is shipping and orders may be placed for this item). Items marked as out of stock will be excluded from being shown in the banners.

  • Character Requirements: The availability must be populated with one of the following three values:
    • preorder
    • out of stock
    • in stock
  • Limit: 16
  • Type: String
  • Example: in stock

brand

The brand indicates the flight’s airline.

  • 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 tags.
  • Limit: 70
  • Type: String
  • Example: British Airways

sale_price

The sale_price is the price at which the flight is available for purchase on the site, if a given flight is ‘on sale’, the sale_price would be populated with the lower price. The sale_price should be in the same currency as the site. Only populate sale_price with the numeric price using a period (.) as the decimal separator and no thousands separator.

  • Character Requirements: The decimal separator must be a period (.) with no thousands separator.
  • Type: String
  • Limit: 50
  • Example: 179.99
Was this article helpful?
0 out of 0 found this helpful
Powered by Zendesk