Skip to content

Destination Ads - Template Tags

Updated: Apr 30, 2024

When you create destination ads, 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 Destination Events.

For example, the title of your ad could be:

Book your travel to {​{destination.city}​} today!

And the template URL of your ad could deep link people straight to the destination page they were interested in, with the right travel dates:

https://www.(...).com/destinations?id={​{destination.destination_id}​}&start={​{trip.travel_start date_format:Y-m-d}​}&end={​{trip.travel_end date_format:Y-m-d}​}

Dynamic Dates

Dynamic dates for template tags enable you to continuously update the dates that appear in your ad, without having to re-upload the data in feed. You can use these for Advantage+ catalog ads used in a particular vertical, such as for hotels, flights, destinations, automotive and so on.

Template tags for Destinations

Template tagDescription
trip.currency_codeThe 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.travel_startThe trip start date that Facebook has collected for the user from the advertiser. If there was no trip start 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.travel_endThe trip end date that Facebook has collected for the user from the advertiser. If there was no trip end date collected, this template tag will default to the day after tomorrow. We support most of the date formats provided here⁠. Example: * {​{trip.travel_end}​} * {​{trip.travel_end date_format:Y-m-d}​}
trip.num_adultsNumber of adult travelers, based on intent signals Facebook collects about the user. Currently defaults to 1, subject to change.
trip.num_childrenNumber of children travelers, based on intent signals Facebook collects about the user. Currently defaults to 0, subject to change.
trip.num_travelersSum of adult and children travelers, based on intent signals Facebook collects about the user. Currently defaults to 1, subject to change.
destination.nameDestination name provided in catalog.
destination.descriptionDestination description provided in catalog.
destination.cityCity provided in catalog.
destination.countryCountry provided in catalog.
destination.urlDestination URL provided in catalog.
destination.destination_idID of the destination provided by advertiser in catalog.
destination.pricePrice of the destination provided in catalog.

Unofficial mirror for reference/search purposes. All content originates from developers.facebook.com — see the source link at the top of each page. Machine-readable indexes: llms.txt · llms-full.txt · About