Flight Ads - Events
Updated: Feb 4, 2026
Flight Ads uses four events. Every event has a set of parameters, see event parameter details. Use the Meta Pixel on your website, and mobile app events in your Android app and iOS app.
| Event | When to Fire | Code Sample |
|---|---|---|
Search | On the flight search results page | |
ViewContent | When the user has selected the flight(s) | |
InitiateCheckout | When the user enters the payment screen | |
Purchase | On the booking confirmed page |
Meta Pixel for Websites
This guide assumes you already have a Meta Pixel installed. If not, see Using Marketing API with the Meta Pixel.
Make sure the pixel base code is already loaded when you fire an event. If you use a tag manager, make sure you include the tag that contains the pixel code on every page. The tag should appear before the tag that contains the pixel event code. Use the Meta Pixel Helper to validate your pixel implementation.
Search Pixel Event
// This sample assumes the Facebook pixel base code is already loaded
fbq('track', 'Search', {
// Fire the 'Search' event on the search results page
// IF YOU DO NOT TO USE A RECOMMENDED PARAM, THEN REMOVE, DON'T LEAVE EMPTY
// RECOMMENDED: set to 'flight'
content_type: 'flight',
// HIGHLY RECOMMENDED: departure date
// Allows you to target people based on their travel dates, using a booking window
// Improves the landing experience with travel dates filled in using template tags
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
departing_departure_date: '2018-12-12',
// HIGHLY RECOMMENDED: return date, in case of round trip, remove otherwise
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
returning_departure_date: '2018-12-19',
// REQUIRED: use official IATA code of departure airport
origin_airport: 'SFO',
// REQUIRED: use official IATA code of destination airport
destination_airport: 'JFK',
// RECOMMENDED: arrival date of departure flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
departing_arrival_date: '2018-12-12',
// RECOMMENDED: arrival date of return flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
returning_arrival_date: '2018-12-20',
// RECOMMENDED: number of adults on flight
num_adults: 1,
// RECOMMENDED: number of children on flight
num_children: 0,
// RECOMMENDED: number of infants
num_infants: 0,
// RECOMMENDED: travel class
// must be 'economy', 'premium', 'business' or 'first'
travel_class : 'economy',
// RECOMMENDED: price for the flight
// Use lowest price if you show multiple options on this page
// Should not include cost of extras, such as seat selection, extra luggage
price : 100,
// RECOMMENDED: currency of the flight price
// Must match currency of catalog
currency: 'USD'
});
ViewContent Pixel Event
// This sample assumes the FB Pixel base code is already loaded
fbq('track', 'ViewContent', {
// Fire the 'ViewContent' event when the user has selected the flight(s)
// IF YOU DO NOT TO USE A RECOMMENDED PARAM, REMOVE IT, DON'T LEAVE EMPTY
// RECOMMENDED: set to 'flight'
content_type: 'flight',
// HIGHLY RECOMMENDED: departure date
// Allows you to target people based on their travel dates, using a booking window
// Improves the landing experience with travel dates filled in, using template tags
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
departing_departure_date: '2018-12-12',
// HIGHLY RECOMMENDED: return date, in case of round trip, remove otherwise
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
returning_departure_date: '2018-12-19',
// REQUIRED: use official IATA code of departure airport
origin_airport: 'SFO',
// REQUIRED: use official IATA code of destination airport
destination_airport: 'JFK',
// RECOMMENDED: arrival date of departure flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
departing_arrival_date: '2018-12-12',
// RECOMMENDED: arrival date of return flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
returning_arrival_date: '2018-12-20',
// RECOMMENDED: number of adults on flight
num_adults: 1,
// RECOMMENDED: number of children on flight
num_children: 0,
// RECOMMENDED: number of infants
num_infants: 0,
// RECOMMENDED: travel class
// must be 'economy', 'premium', 'business' or 'first'
travel_class : 'economy'
});
InitiateCheckout Event
// Assumes FB Pixel base code already loaded
fbq('track', 'InitiateCheckout', {
// Fire the 'InitiateCheckout' event when the user enters the payment screen
// IF YOU DO NOT TO USE A RECOMMENDED PARAM, THEN REMOVE, DON'T LEAVE IT EMPTY
// RECOMMENDED: set to 'flight'
content_type: 'flight',
// HIGHLY RECOMMENDED: departure date
// Allows you to target people based on their travel dates, using a booking window
// Improves the landing experience with travel dates filled in, using template tags
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
departing_departure_date: '2018-12-12',
// HIGHLY RECOMMENDED: return date, in case of round trip, remove otherwise
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
returning_departure_date: '2018-12-19',
// REQUIRED: use official IATA code of departure airport
origin_airport: 'SFO',
// REQUIRED: use official IATA code of destination airport
destination_airport: 'JFK',
// RECOMMENDED: arrival date of departure flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
departing_arrival_date: '2018-12-12',
// RECOMMENDED: arrival date of return flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
returning_arrival_date: '2018-12-20',
// RECOMMENDED: number of adults on flight
num_adults: 1,
// RECOMMENDED: number of children on flight
num_children: 0,
// RECOMMENDED: number of infants
num_infants: 0,
// RECOMMENDED: travel class
// must be 'economy', 'premium', 'business' or 'first'
travel_class : 'economy'
});
Purchase Event
// Assumes FB Pixel base code already loaded
fbq('track', 'Purchase', {
// Fire the 'Purchase' event on the booking confirmed page
// IF YOU DO NOT TO USE A RECOMMENDED PARAM, REMOVE IT, DON'T LEAVE EMPTY
// RECOMMENDED: set to 'flight'
content_type: 'flight',
// HIGHLY RECOMMENDED: departure date
// Allows you to target people based on their travel dates, using a booking window
// Improves the landing experience with travel dates filled in, using template tags
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
departing_departure_date: '2018-12-12',
// HIGHLY RECOMMENDED: return date, in case of round trip, remove otherwise
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
returning_departure_date: '2018-12-19',
// REQUIRED: use official IATA code of departure airport
origin_airport: 'SFO',
// REQUIRED: use official IATA code of destination airport
destination_airport: 'JFK',
// RECOMMENDED: arrival date of departure flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
departing_arrival_date: '2018-12-12',
// RECOMMENDED: arrival date of return flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
returning_arrival_date: '2018-12-20',
// RECOMMENDED: number of adults on flight
num_adults: 1,
// RECOMMENDED: number of children on flight
num_children: 0,
// RECOMMENDED: number of infants
num_infants: 0,
// RECOMMENDED: travel class
// must be 'economy', 'premium', 'business' or 'first'
travel_class : 'economy',
// REQUIRED: Currency of payment
// Must match currency of catalog
currency: 'USD',
// Total payment amount: flight price + extras + payment charges etc
value: 150
});
Mobile App Events for Android
This guide assumes you have the Facebook SDK implemented in your Android mobile app. If not, see the Android SDK. If you use a measurement partner, make sure they pass required events to Meta.
Search Android Event
Bundle parameters = new Bundle();
// IF YOU DO NOT USE A RECOMMENDED PARAM, REMOVE IT, DON'T LEAVE IT EMPTY
// RECOMMENDED: set to 'flight'
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "flight");
// HIGHLY RECOMMENDED: departure date
// Allows you to target people based on their travel dates, using a booking window
// Improves the landing experience with travel dates filled in, using template tags
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_departing_departure_date", "2018-12-12");
// HIGHLY RECOMMENDED: return date, in case of round trip, remove otherwise
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_returning_departure_date", "2018-12-19");
// REQUIRED: use official IATA code of departure airport
parameters.putString("fb_origin_airport", "SFO");
// REQUIRED: use official IATA code of destination airport
parameters.putString("fb_destination_airport", "JFK");
// RECOMMENDED: arrival date of departure flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_departing_arrival_date", "2018-12-12");
// RECOMMENDED: arrival date of return flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_returning_arrival_date", "2018-12-20");
// RECOMMENDED: number of adults on flight
parameters.putInt("fb_num_adults", 1);
// RECOMMENDED: number of children on flight
parameters.putInt("fb_num_children", 0);
// RECOMMENDED: number of infants
parameters.putInt("fb_num_infants", 0);
// RECOMMENDED: travel class
// must be 'economy', 'premium', 'business' or 'first'
parameters.putString("fb_travel_class", "economy");
// RECOMMENDED: price for the flight
// Use lowest price if you show multiple options on this page
// Should not include cost of extras (seat selection, extra luggage etc)
parameters.putFloat("fb_price", 100.00);
// RECOMMENDED: currency of the flight price
// Must match currency of catalog
parameters.putString("fb_currency", "USD");
// Fire the 'Search' event on the search results page
logger.logEvent(
AppEventsConstants.EVENT_NAME_SEARCHED,
parameters
);
ViewContent Android Event
Bundle parameters = new Bundle();
// IF YOU DO NOT USE A RECOMMENDED PARAM, REMOVE IT, DON'T LEAVE EMPTY
// RECOMMENDED: set to 'flight'
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "flight");
// HIGHLY RECOMMENDED: departure date
// Allows you to target people based on their travel dates, using a booking window
// Improves the landing experience with travel dates filled in, using template tags
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_departing_departure_date", "2018-12-12");
// HIGHLY RECOMMENDED: return date, in case of round trip, remove otherwise
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_returning_departure_date", "2018-12-19");
// REQUIRED: use official IATA code of departure airport
parameters.putString("fb_origin_airport", "SFO");
// REQUIRED: use official IATA code of destination airport
parameters.putString("fb_destination_airport", "JFK");
// RECOMMENDED: arrival date of departure flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_departing_arrival_date", "2018-12-12");
// RECOMMENDED: arrival date of return flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_returning_arrival_date", "2018-12-20");
// RECOMMENDED: number of adults on flight
parameters.putInt("fb_num_adults", 1);
// RECOMMENDED: number of children on flight
parameters.putInt("fb_num_children", 0);
// RECOMMENDED: number of infants
parameters.putInt("fb_num_infants", 0);
// RECOMMENDED: travel class
// must be 'economy', 'premium', 'business' or 'first'
parameters.putString("fb_travel_class", "economy");
// Fire the 'ViewContent' event when the user has selected the flight
logger.logEvent(
AppEventsConstants.EVENT_NAME_VIEWED_CONTENT,
parameters
);
InitiateCheckout Android Event
Bundle parameters = new Bundle();
// IF YOU DO NOT USE A RECOMMENDED PARAM, REMOVE IT, DON'T LEAVE EMPTY
// RECOMMENDED: set to 'flight'
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "flight");
// HIGHLY RECOMMENDED: departure date
// Allows you to target people based on their travel dates, using a booking window
// Improves the landing experience with travel dates filled in (using template tags)
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_departing_departure_date", "2018-12-12");
// HIGHLY RECOMMENDED: return date, in case of round trip, remove otherwise
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_returning_departure_date", "2018-12-19");
// REQUIRED: use official IATA code of departure airport
parameters.putString("fb_origin_airport", "SFO");
// REQUIRED: use official IATA code of destination airport
parameters.putString("fb_destination_airport", "JFK");
// RECOMMENDED: arrival date of departure flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_departing_arrival_date", "2018-12-12");
// RECOMMENDED: arrival date of return flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_returning_arrival_date", "2018-12-20");
// RECOMMENDED: number of adults on flight
parameters.putInt("fb_num_adults", 1);
// RECOMMENDED: number of children on flight
parameters.putInt("fb_num_children", 0);
// RECOMMENDED: number of infants
parameters.putInt("fb_num_infants", 0);
// RECOMMENDED: travel class
// must be 'economy', 'premium', 'business' or 'first'
parameters.putString("fb_travel_class", "economy");
// Fire the 'InitiateCheckout' event when the user enters the payment screen
logger.logEvent(
AppEventsConstants.EVENT_NAME_INITIATED_CHECKOUT,
parameters
);
Purchase Android Event
// REQUIRED: total value of booking
BigDecimal purchaseAmount = BigDecimal.valueOf(1200);
// REQUIRED: currency of booking
Currency currency = Currency.getInstance("USD");
Bundle parameters = new Bundle();
// IF YOU DO NOT USE A RECOMMENDED PARAM, REMOVE IT, DON'T LEAVE IT EMPTY
// RECOMMENDED: set to 'flight'
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "flight");
// HIGHLY RECOMMENDED: departure date
// Allows you to target people based on their travel dates, using a booking window
// Improves the landing experience with travel dates filled in, using template tags
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_departing_departure_date", "2018-12-12");
// HIGHLY RECOMMENDED: return date, in case of round trip, remove otherwise
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_returning_departure_date", "2018-12-19");
// REQUIRED: use official IATA code of departure airport
parameters.putString("fb_origin_airport", "SFO");
// REQUIRED: use official IATA code of destination airport
parameters.putString("fb_destination_airport", "JFK");
// RECOMMENDED: arrival date of departure flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_departing_arrival_date", "2018-12-12");
// RECOMMENDED: arrival date of return flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
parameters.putString("fb_returning_arrival_date", "2018-12-20");
// RECOMMENDED: number of adults on flight
parameters.putInt("fb_num_adults", 1);
// RECOMMENDED: number of children on flight
parameters.putInt("fb_num_children", 0);
// RECOMMENDED: number of infants
parameters.putInt("fb_num_infants", 0);
// RECOMMENDED: travel class
// must be 'economy', 'premium', 'business' or 'first'
parameters.putString("fb_travel_class", "economy");
// Use the built-in SDK method when the booking is confirmed
logger.logPurchase(
purchaseAmount,
currency,
parameters
);
Mobile App Events for iOS
This guide assumes you already have the Facebook SDK implemented in your iOS mobile app. If not, see iOS SDK. If you use a measurement partner, make sure they pass the required events to Meta.
Search iOS Event
// Fire the 'Search' event on the search results page
[[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameSearched
// IF YOU DO NOT USE A RECOMMENDED PARAM, REMOVE IT, DON'T LEAVE EMPTY
parameters:@{
// REQUIRED: DO NOT change this, must be set to 'flight'
FBSDKAppEventParameterNameContentType : @"flight",
// HIGHLY RECOMMENDED: departure date
// Allows you to target people based on their travel dates, using a booking window
// Improves the landing experience with travel dates filled in, using template tags
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_departing_departure_date" : @"2018-12-12",
// HIGHLY RECOMMENDED: return date, in case of round trip, remove otherwise
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_returning_departure_date" : @"2018-12-19",
// REQUIRED: use official IATA code of departure airport
@"fb_origin_airport" : @"SFO",
// REQUIRED: use official IATA code of destination airport
@"fb_destination_airport" : @"JFK",
// RECOMMENDED: arrival date of departure flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_departing_arrival_date" : @"2018-12-12",
// RECOMMENDED: arrival date of return flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_returning_arrival_date" : @"2018-12-20",
// RECOMMENDED: number of adults on flight
@"fb_num_adults" : @1,
// RECOMMENDED: number of children on flight
@"fb_num_children" : @0,
// RECOMMENDED: number of infants
@"fb_num_infants" : @0,
// RECOMMENDED: travel class
// must be 'economy', 'premium', 'business' or 'first'
@"fb_travel_class" : @"economy",
// RECOMMENDED: price for the flight
// Use lowest price if you show multiple options on this page
// Should not include cost of extras: seat selection, extra luggage etc
@"fb_price" : @100.00,
// RECOMMENDED: currency of the flight price
// Must match currency of catalog
@"fb_currency" : @"USD"
}
];
ViewContent iOS Event
// Fire 'ViewContent' event when the user selects the flight
[[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameViewedContent
// IF YOU DO NOT USE A RECOMMENDED PARAM, REMOVE IT, DON'T LEAVE EMPTY
parameters:@{
// DO NOT change this, must be set to 'flight'
FBSDKAppEventParameterNameContentType : @"flight",
// HIGHLY RECOMMENDED: departure date
// Allows you to target people based on their travel dates (using a booking window)
// Improves the landing experience with travel dates filled in, using template tags
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_departing_departure_date" : @"2018-12-12",
// HIGHLY RECOMMENDED: return date, in case of round trip, remove otherwise
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_returning_departure_date" : @"2018-12-19",
// REQUIRED: use official IATA code of departure airport
@"fb_origin_airport" : @"SFO",
// REQUIRED: use official IATA code of destination airport
@"fb_destination_airport" : @"JFK",
// RECOMMENDED: arrival date of departure flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_departing_arrival_date" : @"2018-12-12",
// RECOMMENDED: arrival date of return flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_returning_arrival_date" : @"2018-12-20",
// RECOMMENDED: number of adults on flight
@"fb_num_adults" : @1,
// RECOMMENDED: number of children on flight
@"fb_num_children" : @0,
// RECOMMENDED: number of infants
@"fb_num_infants" : @0,
// RECOMMENDED: travel class
// must be 'economy', 'premium', 'business' or 'first'
@"fb_travel_class" : @"economy"
}
];
InitiateCheckout iOS Event
// Fire 'InitiateCheckout' event when user reaches payment screen
[[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameInitiatedCheckout
// IF YOU DO NOT USE A RECOMMENDED PARAM, REMOVE IT, DON'T LEAVE EMPTY
parameters:@{
// REQUIRED: DO NOT change this, must be set to 'flight'
FBSDKAppEventParameterNameContentType : @"flight",
// HIGHLY RECOMMENDED: departure date
// Allows you to target people based on their travel dates, using a booking window
// Improves the landing experience with travel dates filled in, using template tags
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_departing_departure_date" : @"2018-12-12",
// HIGHLY RECOMMENDED: return date, in case of round trip, remove otherwise
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_returning_departure_date" : @"2018-12-19",
// REQUIRED: use official IATA code of departure airport
@"fb_origin_airport" : @"SFO",
// REQUIRED: use official IATA code of destination airport
@"fb_destination_airport" : @"JFK",
// RECOMMENDED: arrival date of departure flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_departing_arrival_date" : @"2018-12-12",
// RECOMMENDED: arrival date of return flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_returning_arrival_date" : @"2018-12-20",
// RECOMMENDED: number of adults on flight
@"fb_num_adults" : @1,
// RECOMMENDED: number of children on flight
@"fb_num_children" : @0,
// RECOMMENDED: number of infants
@"fb_num_infants" : @0,
// RECOMMENDED: travel class
// must be 'economy', 'premium', 'business' or 'first'
@"fb_travel_class" : @"economy"
}
];
Purchase iOS Event
// Fire 'Purchase' event when the booking confirmed
// REQUIRED: total value of booking
[[FBSDKAppEvents shared] logPurchase:150
// REQUIRED: currency of booking
currency:@"USD"
// IF YOU DO NOT USE A RECOMMENDED PARAM, REMOVE IT, DON'T LEAVE EMPTY
parameters:@{
// REQUIRED: DO NOT change this, must be set to 'flight'
FBSDKAppEventParameterNameContentType : @"flight",
// HIGHLY RECOMMENDED: departure date
// Target people based on their travel dates, using a booking window
// Improves the landing experience with travel dates filled in, using template tags
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_departing_departure_date" : @"2018-12-12",
// HIGHLY RECOMMENDED: return date, in case of round trip, remove otherwise
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_returning_departure_date" : @"2018-12-19",
// REQUIRED: use official IATA code of departure airport
@"fb_origin_airport" : @"SFO",
// REQUIRED: use official IATA code of destination airport
@"fb_destination_airport" : @"JFK",
// RECOMMENDED: arrival date of departure flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_departing_arrival_date" : @"2018-12-12",
// RECOMMENDED: arrival date of return flight
// use YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD or YYYY-MM-DDThh:mm:ssTZD
@"fb_returning_arrival_date" : @"2018-12-20",
// RECOMMENDED: number of adults on flight
@"fb_num_adults" : @1,
// RECOMMENDED: number of children on flight
@"fb_num_children" : @0,
// RECOMMENDED: number of infants
@"fb_num_infants" : @0,
// RECOMMENDED: travel class
// must be 'economy', 'premium', 'business' or 'first'
@"fb_travel_class" : @"economy"
}
];
Event Parameters Details
On mobile, the parameter names are different than for Facebook Pixel. Often prepended by
fb_, with some exceptions, such as value versus _valueToSum.| Parameter Name and Type | Description |
|---|---|
content_type for FB pixelfb_content_type for App Eventstype: string or string[] | Recommended. Must be flight. If combined with another travel ads product, such as hotels, use '["flight", "hotel"]'. |
departing_departure_date, for FB pixelfb_departing_departure_date, for App Eventstype: string | Highly recommended. The date and time for start of the outbound journey. We accept dates in YYYYMMDD, YYYY-MM-DD, YYYY-MM-DDThh:mmTZD and YYYY-MM-DDThh:mm:ssTZD. When provided, you can use this in the ad using template tags and target people based on their travel dates using booking window in your audiences.Examples:
|
returning_departure_date, Facebook Pixelfb_returning_departure_date, App Eventstype: string | Highly recommended for round trips. The date and time for start of the return journey. We accept the same date formats as listed for departing_departure_date. When provided, you can use this in the ad using template tags and target people based on their travel dates using booking window in your audiences. |
currency, FB pixelfb_currency, App Eventstype: string | Required for purchase.Currency for the value. Specified using ISO 4217 currency format.Example: USD |
value, FB pixel_valueToSum, App Eventstype: float | Required for purchase.A total price of the booking. This number quantifies the value of this event to the advertiser. Example: 155 |
departing_arrival_date, Facebook pixelfb_departing_arrival_date, App Eventstype: string | The date and time for arrival at the destination of the outbound journey. Use the same date formats listed for departing_departure_date. |
returning_arrival_date, Facebook pixelfb_returning_arrival_date, App Eventstype: string | The date and time when the return journey is done. Use the same date formats listed for departing_departure_date. |
destination_ids, Facebook pixel
fb_destination_ids, App Eventstype: string or string[] | If you have a destination catalog, you can associate one or more destinations in this catalog with a specific flight event. For instance, link a particular route to a nearby museum and a nearby beach, both of which are destinations in the catalog. Example: '["dest2", "dest5", "dest8"]' |
num_adults, Facebook Pixel
fb_num_adults, App Eventstype: string | Number of adults flying. When provided, you can display this in the ad using template tags. Example: 2. |
num_children, Facebook Pixelfb_num_children, App Eventstype: int | Number of children flying. When provided, you can display this in the ad using template tags. Example: 2. |
num_infants, Facebook Pixelfb_num_infants, App Eventstype: int | Number of infants flying. When provided, you can display this in the ad using template tags. Example: 2. |
price, Facebook Pixelfb_price, App Eventstype: float | The lowest price from search results for the selected route and dates. For Search event only.Example: 95 |
travel_class, Facebook Pixelfb_travel_class, App Eventstype: string | Must be economy, premium, business or firstExample: economy. |
user_score, Facebook Pixelfb_user_score, App Eventstype: float | Represents the relative value of this potential customer to advertiser. Example: 50 |
preferred_num_stops, Facebook Pixel
fb_preferred_num_stops, App Eventstype: int | Indicate the preferred number of stops the user is looking for. 0 for direct flights.Example: 0 |