<img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=128060241156018&amp;ev=PageView&amp;noscript=1">

Allez (Deep-Links)

This documentation provides detailed instructions for generating multiple Stay22 links for use across various platforms, including web pages, applications, and emails. You can quickly create an unlimited number of customized deep links and seamlessly integrate them into your app, website, or emails. Refer to the information below to get started.

Features

  • Choose between linking to a destination (city or country) or a specific hotel listing
  • Machine-learning algorithms that determine the optimal landing page and online travel agency to maximize conversion rates.
  • Automatic Geolocation domain (TLD) handling (for e.g redirecting to .com vs .co.uk, based on the clicking user’s location)
  • Automatic language and currency handling
  • Unlimited campaign IDs (labels) as you want to track and distinguish bookings
  • No adblockers or third party cookies issues

AI Functionality Overview

Based on data collected from our 1.5 billion annual users, our AI will dynamically direct each user to the online travel agency (OTA) with the highest likelihood of conversion for them. 

 

OR Allez 3

 

Our supplier OTAs include:

  • Booking.com
  • Vrbo (and sister sites such as Abritel, Fewo, Stayz and BookABach)
  • Expedia
  • Hotels.com
  • Tripadvisor
  • Kayak (and sister sites such as Momondo, HotelsCombined, Cheapflights, Swoodoo, checkfelix, and Mundi)
  • Trivago

Wide Scale Integration

This is a one-time integration, whether you aim to replace your current hotel links, update accommodation links for specific destinations or locations, or create new links to enhance your content.

Each type of Allez link is built upon a single URL (see below). You'll need the basic URL structure to get started and can add parameters as needed.

 

A) Linking to hotels via a Hotel Listing Page

To direct the user to the detailed page of a listing, simply include the hotel name and location (city and country) in the following format:

https://www.stay22.com/allez/wildcard?aid={aid}&campaign={optional_label}&hotelname={hotelname}&address={location}

Example:

https://www.stay22.com/allez/wildcard?aid=affiliateid&campaign=test&address=miami%20USA&hotelname=four%20seasons

Important Notes:

  • AID (Affiliate ID): It is crucial to ensure your AID is always included. This should remain constant.
  • Campaign ID: It is strongly recommended to use this parameter to define and track different marketing campaigns. There is no limit to the number of campaign IDs you can use, allowing for detailed performance analysis. You can define this parameter as needed.
  • Hotel Name: For hotels with multiple word names (such as hotel names that being with "the"), make sure the names are properly separated with "%20"
  • Address Parameter: Use the &address= parameter to improve search accuracy when using the hotel name. use city and country

B) Linking to a destination with a Search Results Page (SRP) 

In addition to specific hotel links, Allez Links can also generate URLs for broader accommodation searches based on destination, address, or GPS coordinates

The basic URL format for SRP:

https://www.stay22.com/allez/wildcard?aid={aid}&campaign={optional_label}&address={location}

Examples:

Using an address:

https://www.stay22.com/allez/wildcard?aid=affiliateid&campaign=test&address=Louvre%20Paris

Using GPS coordinates:

https://www.stay22.com/allez/wildcard?aid=affiliateid&campaign=test&lat=50.717541&lng=-1.875141

 

Important Notes:

  • AID (Affiliate ID): It is crucial to ensure your AID is always included. This should remain constant.
  • Campaign ID: It is strongly recommended to use this parameter to define and track different marketing campaigns. There is no limit to the number of campaign IDs you can use, allowing for detailed performance analysis. You can define this parameter as needed.
  • GPS Coordinates: We recommend using latitude and longitude if possible (lat/lng parameters)

Glossary of parameters

  • address: The city and country of the hotel or the destination you are linking to.  Using lat/lng is preferred for accuracy.
  • latitude and longitude: Recommended for precise location searches. This can replace the address parameter (e.g., lat=50.717541&lng=-1.875141).
    Example: https://www.stay22.com/allez/booking?lat=50.717541&lng=-1.875141
  • aid: Affiliate ID. If you don’t have one, sign up to the Hub to create one. The format is &aid=affiliateid
  • campaign: Use this parameter to track each of your links’ performance (clicks, bookings origin), we strongly recommend adding at least one campaign ID. Add multiple campaigns like so: &campaign=label1&campaign=label2&campaign=label3
  • checkin && checkout: Important for events but optional. If there are no specific events or dates, it’s best to omit this parameter. If you need to specify dates, use this format: checkin=YYYY-MM-DD&checkout=YYYY-MM-DD

Smart Geofencing for TLDs

We automatically detect the user’s location and redirect them to the correct TLD based on their IP address. This ensures a seamless experience for your users. For example, even if you generate a link to a vrbo.com site, if the user clicking is from Australia, they will be redirected to Stayz.com.au, the Australian brand that is equivalent (with the exact same destination and listing details). This increases both conversion rates and link relevancy to your users.

  • Vrbo:
    • vrbo.com (US and international, including all languages and currency detections)
    • abritel.fr (France)
    • stayz.com.au (Australia)
    • bookabach.co.nz (New Zealand)
    • FeWo-direkt.de (Germany)
  • Booking.com:
    • As for Booking.com, the brand only supports “booking.com” TLD internationally, but we do automatic language and currency setting for your users.
  • Expedia:
    • The same smart routing rules applies to Expedia.com. Expedia has over 30 TLD’s from .ca, .co.uk, and etc. You’re in good hands 👍
  • Tripadvisor:
    • The same smart routing rules applies to Tripadvisor.com. Tripadvisor also has over 30 TLD’s from .fr, .ca, .co.uk, and etc.
  • Hotels.com:
    • We support redirecting from and to all subdomains for hotels.com, including hoteles.com (LATAM), and hoteis.com (Brazil).
  • Kayak:
    • We offer support for all KAYAK TLDs, ensuring seamless integration with your platform. Our smart routing rules apply to KAYAK as well, allowing users to be redirected to the appropriate local version of the site, such as kayak.co.jp, kayak.co.uk, and others, based on their location and preferences. The same rules for its sister sites such as Momondo, HotelsCombined, Cheapflights, Swoodoo, checkfelix, and Mundi.
  • Trivago:
    • The same smart routing rules applies to Trivago.com. Trivago also has over 30 TLD’s from .fr, .ca, .co.uk, and etc.

Feedback & tech support

For immediate assistance, email your PSA, or use the chat bubble in the bottom right corner.