Marketing API Version

Dynamic Ads for Flights Template Tags

When you create Dynamic Ads for Flights, 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 Flight Events.

For example, the title of your ad could be:

Complete your booking to {{flight.destination_city}} today!

And the template URL of your ad could deep link people straight to the flight they were interested in, with the right departure and return date:

https://www.(...).com/flights?from={{flight.origin_airport}}&to={{flight.destination_airport}}&departure={{trip.departing_departure_date date_format:Y-m-d}}&return={{trip.returning_departure_date date_format:Y-m-d}}&num={{trip.num_travelers}}

Full list of template tags for flights

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.departing_departure_date

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

Example:

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

trip.returning_departure_date

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

Example:

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

trip.num_adults

Number of adult travelers, based on intent signals Facebook collects about a 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_infants

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

trip.num_travelers

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

flight.destination_airport

The IATA code for the destination, such as SFO.

flight.destination_city

Destination city name from flight feed, if provided. If not, city name associated with destination airport in English, such as San Francisco.

flight.origin_airport

The IATA code for the destination, such as JFK.

flight.origin_city

Origin city name from flight feed, if provided. If not, city name associated with destination airport in English, such as New York.

flight.description

Flight description provided in catalog.

flight.price

Price of the flight. To show a price from feed, use source:feed type as the option: {{flight.price source:feed type:one_way}}.

flight.price source

One-way price of the flight. For this option, you must provide a source of prices. To show a price from feed, use source:feed as the option: {{flight.price source:feed}}.

flight.url

Flight URL provided in catalog.