End Client Trip Search with Web App
The Avinode Web App is a widget-type app that can be embedded on your website. This provides trip options for end clients and generates a lead in Avinode.
The Avinode Web Apps are widget type apps that can be installed by Avinode members on an
existing web page. There are two main types of web apps: Search web app, and Empty leg web app. There is also a combined version with both search features available in the same app.
Search web app
This web app is designed to add a lead generator to a company’s web site. Visitors are presented with a search form where they can submit their desired itinerary. The web app then displays available aircraft categories and/or aircraft types with aircraft details, pictures and information about estimated flight times and prices. The visitor can then proceed to request a more detailed quote for one or more of these options. These requests end up as leads and are available to the Avinode member in the Trips pages in the Avinode Marketplace. This web app can be powered by all the aircraft in the Avinode Marketplace or a subset of these, for example only the fleet of one operator.
Empty Leg web app
Visitors can search for empty legs published in the Avinode Marketplace. The visitor can also submit a request for one or more of these empty legs. These requests end up as leads and are available to the Avinode member in the Trips pages in the Avinode Marketplace. This web app can be powered by all the empty legs in the Avinode Marketplace or a subset of these, for example only the empty legs published by one operator.
Additionally, the empty leg web app lets you show a number of "teaser" empty legs from a select airport, as a preview to the visitor.
List view of Web apps in your Avinode Marketplace account
Creating a web app
n the Avinode system, go to the Company menu to find the Apps page. On this page you will see all your web apps. Note, you can create as many web apps as you like (as long as they are not put on the same page, then they will conflict with each other).
Select the New button. Fill in a name for your new web app and hit Save. You will now see the created web app in the list.
Branding and settings
In most cases some additional styling will be required to make the web app match the Avinode member’s brand. This styling is done inside the Avinode system when setting up the web app, and can be changed by the owner of the app at any time. Find all settings for your web app by clicking on the web app in the web app listing.
UI customization
The looks of the web app can be customized. Select the Web UI tab in the configuration pages for you web app. Here you can select colors and which search features that you like to have enabled in the web app. Changing the colors will update the preview, but the appearance for the web app will first be updated after you hit Save.
Web app UI customization in your Avinode Marketplace account
Embedding the web app
Embedding a web app to your own page is as simple as inserting a code fragment. The code fragment you should use is available in the Embed tab under the web app settings.
On this page you will find a grey box with a code to be inserted on your page.
Web app HTML embed code in your Avinode Marketplace account
The first div-element in the code called "avinodeApp", is the element where the web app will be injected. Place this element on the page where you would like the web app to be. The second part with the script should be placed in the end of your “body”. This is all you have to do to get the web app included in your page.
Common issues
Sometimes when embedding the web app, the date picker or other expanding parts of the app, appear blocked by other elements on the hosting website. This is usually because the main website has a set of styling rules (CSS) that is overriding the web app. For example there is something called 'z-index' that decides on what level an element should be stacked on a page, and likely the blocking container near the web app has a higher index. If this is the case, ask your web team to have a closer look at the website design and adjust accordingly.
Web app search results
To ensure good quality results we only provide the best options in our web apps. Logged into Avinode, you will be able to find more options for flexible end clients.
The web apps can return either type or category aggregates. By default aircraft are excluded according to the following criteria:
- More than 0 fuel stops
- Initial positioning time > 0 (transient aircraft)
- Cargo flights
- Ambulance flights
- Helicopters
Please note
Due to the default search result filters mentioned above, including any commission added, the prices shown in the web app will appear different compared to a standard, non-filtered search inside Avinode.
Settings configurable by Avinode member
Commission
This is the commission, in percent, that will be added to the prices displayed to the visitor. This is by default set to 0%.
Confirmation to end client
By default, a confirmation email is sent to the visitor after the visitor has requested a more detailed quote. With this setting, the Avinode member can decide if such a confirmation email should be sent or not.
Privacy Policy link
Setting this will enforce the user to accept your privacy policy, to be provided via a link.
Languages
The Avinode member can configure the languages to be available in the web app. Names and descriptions of the different aircraft categories can be translated.
If your website uses multiple domains for different languages, then you should setup one web app for each domain and keep only this specific language in the settings. If you choose to have multiple languages in the same web app, the default language will always be English (the default language cannot be changed).
These are the supported languages:
- English – Great Britain
- English – United States
- Russian
- German
- French
- Spanish
- Italian
- Dutch
- Portuguese – Brazil
- Chinese
Categories
The Avinode member can configure the aircraft categories available in the web app under the Categories tab.
Search result filter options
The search results can be aggregated on either aircraft category or aircraft type. This setting is found under the Embed tab.
Fleet filter
This setting decides which aircraft in the Avinode Marketplace that will be considered when compiling the results. The default fleet filter includes all aircraft in the Avinode Marketplace, but can be set to include or exclude per company and/or per aircraft.
Safety rating filter
With this setting only aircraft with a certain safety rating will be included in search results.
Contact Info
This is the contact information to the Avinode member that will be displayed in the web app.
Show price in search results
This setting can exclude all prices from the web apps, instead allowing the end client to inquire for price. This setting is found under the Embed tab.
Settings configurable by Avinode staff
Require contact info before search
With this setting the client contact form will be displayed before any search results are displayed in the app.
Other filter options
To further adjust the default filtering of search results, talk to your sales manager on the best way to do this.
Event tracking with Google Analytics
By providing your Google Analytics ID under the Embed tab you will be able to track the following events from inside the web app:
- “Show category description“ – Clicking on a category description. (We can not send the category type since they are not final. They can be whatever)
- “Change currency to: <currency_code>” – Changing currency
- “Sending inquire“ – Clicking the “Sending” button to send an inquiry
- “Change language to: <language_code>“ – Changing language
- “Change “ – Changing date fields, where date field is the date depending on the search. (fromDate, endDate, date)
- “Change ” – Changing time fields, where date field is the time depending on the search. (fromTime, endTime, time)
- “Decrement pax“ or “Increment pax” – Changing PAX
- “Change trip type to: <trip_type>” – Changing trip type
- “Open inquiry form” – Clicking inquiry button in search result
- “Close inquiry form“ – Clicking cancel or X in inquiry form
- “Search, <search_type>“ – Searching
- “Change startAirport” – Changing start airport
- “Change endAirport” – Changing end airport
No further configuration is needed. See the example below on what it should look like in your Google Analytics account once a few different events are being tracked.
Conversion tracking
The web app solution supports a referrer variable to be sent to Google Analytics. This is configured by adding the query parameter “analyticsReferrer” to your Avinode web app bootstrap script, with a referrer (URL to your referral site). See example below of how code is generated after entering an URL in the textbox and clicking save:
With “analyticsReferrer” we will send the referrer to Google Analytics and one can create reports based on different referrer values.
When not adding a referrer to the web app script, traffic will appear to be coming from an Avinode page instead, and you won't be able to trace your traffic correctly in Google Analytics.
For customers having multiple instances of web-apps on different pages adding a Referral URL will allow you to distinguish the traffic depending on the page. For instance, let's say you have your regular start page and then one which you you market via ads. The Referral URL will be different for the pages, i.e:
https://example.com/startpage
https://example.com/ad-campaign
Advanced tracking
For customers having other tracking solutions than Google Analytics, or wanting to implement some custom tracking based on events that happen inside the web app. Adding an eventListener to your page that listens to 'avinode-tracking' events will let you distinguish the event and implement custom logic.
The web app allows the user to use an event listener which can be synched with any tracking tool.
Advanced analytics
Listening for "avinode-tracking" events enables you to react on all events that the web app is currently tracking. Simply define an event handler and implement your own logic.
Do note that not all keys have arguments, see below for the full documentation
window.addEventListener("avinode-tracking", function(msg) {
// Will output the key string, i.e. 'change_airport'
console.log("tracking-key", msg.detail.key);
// Will output the args string array, i.e. ['startAirport']
console.log("tracking-args", msg.detail.args);
}, {passive: true});
| Key | Arguments | Deprecated |
|---|---|---|
| show_category_description change_airport change_currency send_lead send_inquiry change_language change_date change_time increment_pax decrement_pax change_trip_type open_inquiry_form close_inquiry_form search_one_way search_round_trip search_multi_city search_empty_leg | - 'startAirport' or 'endAirport' The selected currency - - The selected language 'date' or 'returnDate' 'time' or 'returnTime' - - The selected trip type - - - - - - |
Downloading web app leads from Avinode
t's possible to download the client leads generated through the web app, from Avinode to an external system. This is done by configuring web-hook settings and subscribing to the event type "ClientLeads". A notification will be sent out automatically each time a client lead is created, letting you download the lead information to be stored in your own system.
Read more about how to set this up on the Webhooks page, with specific details about the Client Leads notification category.
Please note
Downloading the client-leads from Avinode requires an active API connection on the member's account where the web app is setup. This will be created by Avinode support and will give access to download leads directly from the production environment, so no need to go through sandbox for testing in this case. Avinode support will provide the details needed to connect to the API.
Updated about 2 months ago