Dynamic Ads for Hotels Template Tags

When you create Dynamic Ads for Hotels, use these template tags in the ad creative and deep-link URLs. When Facebook displays your ad, we replace the template tags with that person's travel selections.

You should provide template tags in double curly brackets: {{....}}

Before using template tags, make sure you provide all required details through your Hotel Events.

For example, the title of your ad could be:

Complete your booking to {{hotel.city}} today!

And the template URL of your ad could deep link people straight to the hotel page they were interested in, with the right checkin and checkout date:

https://www.(...).com/hotels?id={{hotel.hotel_id}}&checkin={{trip.checkin_date date_format:Y-m-d}}&checkout={{trip.checkout_date date_format:Y-m-d}}

Full list of template tags for hotels

Template tagDescription

trip.currency_code

The ISO-4217 currency code (for example, "USD") passed by the advertiser in dynamic events (for example, pixel events) using the key currency. If no currency code has been passed for an item, we show the product's feed's default currency.

trip.checkin_date

The checkin date that Facebook has collected for the user from the advertiser. If there was no checkin date collected, this template tag will default to tomorrow. We support most of the date formats provided here.

Example:

  • {{trip.checkin_date}}
  • {{trip.checkin_date date_format:Y-m-d}}

trip.checkout_date

The checkout date that Facebook has collected for the user from the advertiser. If there was no checkout date collected, this template tag will default to the day after tomorrow. We support most of the date formats provided here.

Example:

  • {{trip.checkout_date}}
  • {{trip.checkout_date date_format:Y-m-d}}

trip.num_adults

Number of adult travelers, based on intent signals Facebook collects about the user. Currently defaults to 1, subject to change.

trip.num_children

Number of children travelers, based on intent signals Facebook collects about the user. Currently defaults to 0, subject to change.

trip.num_travelers

Sum of adult and children travelers, based on intent signals Facebook collects about the user. Currently defaults to 1, subject to change.

hotel.name

Hotel name provided in catalog.

hotel.description

Hotel description provided in catalog.

hotel.brand

Hotel brand provided in catalog.

hotel.city

City provided in catalog.

hotel.city_id

City id provided in catalog.

hotel.country

Country provided in catalog.

hotel.neighborhood

First neighborhood provided in catalog.

hotel.url

Hotel URL provided in catalog.

hotel.hotel_id

ID of the hotel provided by advertiser in catalog.

hotel.base_price

If dynamic pricing is provided, this will display the base price from room type. If advertiser has not provided dynamic pricing, this will display the base_price provided in static hotel feed.

hotel.price

If dynamic pricing is provided, this will display the average dynamic price per night with tax and fees. If advertiser has not provided dynamic pricing, this will default to base price.

hotel.sale_price

If dynamic pricing is provided, this will display the average dynamic sale price per night. If advertiser has not provided dynamic date-based sale price, this will default to sale price at the room level.

hotel.total_price

If dynamic pricing is provided, this can be used to display the total price a user has to pay for the entire stay. This price includes tax and fees.