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 (Hotel & Accommodation)

The product feed is a data file which contains organised information about all the rooms/accommodations on your site. 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 alphanumeric identifier that represents one, and only one, hotel or resort.

  • Character Requirements: The id must only contain ASCII characters, and must not contain quotation marks.
  • Limit: 240
  • Type: String
  • Example: H12896

title

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

The title is the name of the city and/or the name of the hotel/resort. 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: Grand Hotel 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 hotel, or search results page, where the promoted price can be found. You can pass useful extra data to accelerate user inputs: number of adults, 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/hotels/london.html

image_link

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

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 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.mysite.com/images/grandnewyork_b.jpg

price

The price is the price of a one-night stay in the hotel over the next 30 days. It can also be the price of a holiday package. 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 can be filled with a COS-based category if using COS optimizer (otherwise, it can be CRO-based). For instance, a city-country pair or a unique location identifier can be used.

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

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.  

star

User’s rating of the hotel/resort (decimal point as separator).

  • Character Requirements: number from 1 to 5 in steps of 0.5.
  • Limit: N/A
  • Type: number.
  • Example: 4.5

sale_price

The sale_price is the price of the hotel / resort before the discount. If a given hotel / resort is “on sale”, the price field would be populated with the higher price. The price should be in the same currency as the site. Only populate price with the numeric value 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: 129.99

description

This field is required for running Facebook ads.

The description is the name of the hotel / resort.

  • Character Requirements: The description must start with a letter.
  • Limit: 5000
  • Type: String
  • Example: The Grand New York stands at the heart of a vivid action-packed metropolis.

categoryid2

The categoryid2 can be filled with a unique location identified, such as the sub-area or region of the resort/hotel/flight.

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

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 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.mysite.com/images/grandnewyork_s.jpg

1.3. RECOMMENDED FIELDS

categoryid3

The categoryid3 can be filled with the theme (family, sports, nature, etc) or the type of holidays..

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

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
Was this article helpful?
0 out of 0 found this helpful
Powered by Zendesk