Skyscanner Keyword Tracking

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

Email

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 [e-mail]
• 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.