Criteo Feed Guide for Hotel

A guide that contains information about product feed specifically for Hotel websites based on the Criteo Product Feed specification.

Overview

Product feed is a file that contains information about all hotels/ resorts/ rooms on your site. Criteo uses this information to build your dynamic product banners.

This guide will help you to provide information on what is the minimum fields required to build a product feed for your Criteo campaign.

Supported Formats

To make sure that Criteo can retrieve your product feed, please use one of the formats below. You can download feed examples in the links provided in the table.

Feed Format Detail Example
TSV This format is based on Tab-separated value. Headers must be delcared in the first row of the file. Field names can contain spaces or underscores (e.g. image_link or image link) Feed example
CSV This format is based on Comma-separated value. Headers 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 conform 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

Required Fields

Product information should not contain HTML tags or style tags.

Field Detail Requirements Example
id
Alphanumeric identifier of the hotel/ resort		 Character Requirements: Id must only contain ASCII characters, and must not contain quotation marks

Limit: 240

Type: String		 Example:: H12896
title
Name of the City and/or hotel/ resort name		 Character Requirements: Title must start with a letter or number

Limit: 150

Type: String		 Example: Grand Hotel New York
description
Description of the hotel (string). Because of the design of the banners, shorter descriptions (under 50 characters) are more likely to fit in Criteo’s formats and layouts, however, not all formats and layouts will have a description		 Character Requirements: Description must start with a letter or number. Remove all HTML tags from this field, including style, embed, object, and anchor tags

Limit: 5000

Type: String		 Example: The Grand New York stands at the heart of a vivid action-packed metropolis.
link
Absolute URL link into hotel/resort page, or city results page.		 Character Requirements: 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

Limit: 1024

Type: String		 Example: https://gc.mysite.com//rez.aspx?Chain=12&start=availresults&hotel=ABC&locale=en-US&room=OVK
image_link
Image_link is a URL that specifies a file path to a given hotel’s image. 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: 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

Limit: 2000

Type: String		 Example: http://www.mysite.com/images/grandnewyork.jpg
price
Price of the hotel/resort before discount. 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: 99.50
sale_price
Price of hotel/ resort (without currency symbol). Ideally this price would represent the best price of a 1 night stay over the next 30 days. Only populate price with the numeric value using a period (.) as the decimal separator and no thousands separator		 Character Requirements: he decimal separator must be a period (.) with no thousands separator

Limit: 14

Type: String		 Example: 70.95
categoryid1
City-country or unique location identifier.		 Character Requirements:

Limit: 500

Type: String		 Example:
Miami, FL
categoryid2
Type of hotel (All-inclusive, B&B) or resort		 Character Requirements:

Limit: 500

Type: String		 Example:
All-inclusive
star
User’s rating of the hotel/resort (decimal point as separator).		 Character Requirements: Between 0 to 5.0

Limit: 2

Type: String		 Example:
4.5

Upload

Criteo can retrieve the product feed using one of the following protocols

  1. HTTP or HTTPS
  2. FTP (File Transfer Protocol)
  3. Criteo FTP Server
    You can upload your finalized product feed to our Criteo FTP server. To do so, please refer to the Criteo FTP guide here