At Skyscanner, we monitor market and partner performance daily. Our aim is to help our partners manage their integration from a technical and commercial point of view, to achieve optimal results.
We use these insights to measure performance in relation to your competitors, to highlight opportunities for growth, and to surface issues as they happen, so they can be addressed as quickly as possible.
We also provide performance and year-on-year analyses to you upon request and at regular business reviews.
We require partners to install keyword tracking data, to drive these insights.
What is a keyword tracking report?
Keyword tracking reports provide a line by line account of each individual sale, as a result of Skyscanner redirects to your website(s). These reports include a Skyscanner “redirect ID”, that is passed through the Skyscanner deeplink, and are then associated with individual redirects from Skyscanner.
Skyscanner partners are required to provide daily keyword tracking reports via API/SFTP/FTP/BackOffice or an email accessible to Skyscanner, with all the information detailed below for the previous day.
Where do I get the Skyscanner redirect ID?
The Skyscanner redirect ID uniquely identifies each exit from Skyscanner to partner websites. It is included in the redirect URL as a query string parameter named “skyscanner_redirectid” (please note the underscore character). This can be captured on your site and then associated with any sales made.
An example is: https://www.partnerwebsite.com/?skyscanner_redirectid=im84hg6OEeWPattLtxmiAA
What does a keyword report look like?
The report should provide us with the following data:
| Sale date time | Skyscanner redirect ID | Total value | Currency | Device | Platform | Market | Cabin Class | Trip | Trip Type | From | To | Flight No. |
| 1/6/2016 12:30 | im84hg6OEe WPattLtxmiAA | 130.00 | USD | Mobile | Referral | US | Economy | Domestic | Return | JFK | LAX | XX123;XX43 |
| 1/6/2016 14:05 | IwvI6A6SEeW Pwm2r9AiIwg | 400.00 | USD | Desktop | Referral | CA | Business | International | Multi-city | YYZ | LHR | XY1;XY2;XX3 |
| 1/6/2016 14:45 | H5awig6SEeW uNJ0r6BsjgQ | 600.00 | USD | Mobile | Referral | UK | First | Domestic | One-way | EDI | SIN | XZ1111 |
- The date and time of purchase
- The Skyscanner redirect ID (as explained above)
- The total sale value and currency
- Any other details required to identify the campaign, such as:
- The device platform type (mobile, desktop, tablet)
- The user market – the market of the website where the customer visited
- The cabin class (e.g. Economy, Premium Economy, Business, First)
- The trip type (e.g. one-way, return, multi-city) (optional)
- Travel type (i.e. domestic or international) (optional)
- Additional flight details, such as:
- Departure airport (IATA, optional)
- Arrival airport (IATA, optional)
- Flight number/ designator (e.g. XY1111;XY2222;XX123 means 3 flights, two with airline XY and one with airline XX) (optional)
How to provide daily keyword tracking reports to Skyscanner?
Skyscanner partners can choose one of the following ways to send reports to Skyscanner.
API
This sending method is Most preferred at Skyscanner because it's quite stable and technically friendly.
Skyscanner partners should provide Skyscanner with the following:
- Login API and the credentials (password and username) – the login API is used to provide access token for the daily report API.
- If there is no login API needed, the credentials (token or password and username) should be offered directly and will be used to access the daily report API.
- Daily report API
- Grant access to all Skyscanner IP addresses – detailed below
- Any other information required to access the above API(s)
- Example of API(s) request payload (query parameters or post parameters, payload format (application/json or application/xml), headers, etc)
- Example of API(s) response
- Error definition of API(s) – the error code and error message might respond from API(s)
Here is an example of APIs get the access token and daily report
SFTP/FTP
Skyscanner partners could also use SFTP/FTP server to provide us with daily report files. The daily report file, in general, is in CSV/XLS/JSON/XML format.
Skyscanner partners should provide Skyscanner with the following:
- SFTP/FTP server host address and port number
- SFTP/FTP login credential (username and password or username and private key file)
- The daily report file name is in the format to include the booking date e.g., skyscanner_revenue_report_2022-04-10.csv
- Grant access to all Skyscanner IP addresses – detailed below
Here is an example of using username and password to access SFTP for daily report
Back-Office web portal
This is the method most of the partners offer daily reports to Skyscanner. The portal should be accessed publicly on the internet. Skyscanner plays like a web scraping to retrieve report information by scraping and parsing the web page or downloading the report if offers an entry point to download.
Skyscanner partners should provide Skyscanner with the following:
- Login page URL and credentials (username and password)
- The report web page URL, in general this web page URL will contain the start date and the end date as search criteria and provide all the information on the page
- Provide an entry point for download (optional)
- Grant access to all Skyscanner IP addresses – detailed below
Here is an example of using username and password to access Back-Office for daily report
Skyscanner partners can also send daily reports via email to Skyscanner.
Live Partners
For existing live partners, the production report should be enabled with all the required data and sent to the email address below as an attachment. Test reports cannot be used.
New Partners
For partners being onboarded, with no current live traffic, please send a sample test email with the daily report attached to the email address below. The report should contain the final structure of the production report and the requirements below. No changes should be made to the structure of the report during integration.
Skyscanner partners' email reports should adhere to the following requirements:
- The daily report should be sent to DA_Feeds@skyscanner.net
- The daily report should be attached to the email in CSV/XLS format
- The subject of the email should include the partner name and the booking date e.g., edreams_skyscanner_revenue_report_2022-04-10
Send Timing
Skyscanner will retrieve partners' daily reports once a day at midnight (UTC + 0). Skyscanner partners are required to provide daily keyword tracking reports before midnight (UTC + 0) for the previous day.
Skyscanner IP Ranges
Please include the CIDRs for all our Production and Office IPs in your avail-list in your firewalls. Office IPs are essential for onboarding and support.
Production IPs:
89.251.12.0/22
3.248.216.80/28
54.246.246.80/28
3.123.44.224/28
54.93.255.0/28
3.113.218.160/28
54.250.255.192/28
18.140.177.128/28
54.255.251.80/28
15.222.97.183/32
15.223.13.244/32
15.223.89.117/32
3.97.232.6/32
3.97.64.237/32
99.79.157.92/32
89.251.12.0/24
Production IPs:
Office IPs:
188.39.95.90/32
188.39.95.140/32
212.187.171.234/32
212.187.186.162/32
194.88.79.66/32
54.254.97.41/32
210.5.13.220/32
202.66.43.28/32
91.126.39.170/32
217.163.95.162/32
217.163.77.3/32
217.163.10.187/32
8.29.109.131/32
8.29.228.65/32
8.29.109.73/32
8.29.228.119/32