Quick Start

This section is to help you understand the structure and different combinations of an allez link.

If you only want to make one-off, single-use links, use the Allez Generator in your hub.

The minimum viable link

You need two things: your affiliate ID and a destination.

https://www.stay22.com/allez/roam?aid=<AID>&address=paris%20france

That's a complete, functional Allez link.

Three ways to specify location

1. Address (simplest)

Pass a human-readable location in address=. City + country works, but the more specific the better.

https://www.stay22.com/allez/roam?aid=<AID>&address=bell%20centre%20montreal

2. GPS Coordinates (most precise)

If you have lat/lng, use them - they skip the geocoding step and give the most accurate results.

The params are lat= and lng=

https://www.stay22.com/allez/roam?aid=<AID>&lat=45.4960&lng=-73.5693

3. Direct OTA link

Already have a specific Booking.com or Expedia URL? Pass it through link= and Allez handles the affiliate attribution.

https://www.stay22.com/allez/booking?aid=<AID>&link=https%3A%2F%2Fwww.booking.com%2Fhotel%2Fca%2Frenaissance-montreal-downtown.en-us.html

The link parameter must be URL-encoded. Use encodeURIComponent() in JavaScript.

Add tracking

Use the campaign parameter to distinguish where your clicks come from. You can add multiple campaigns.

The biggest mistake you can make is not adding campaigns. If you want to know where each purchase came from, campaigns are the way to track them.

If you have your analytics set up, you can append your user-tracking identifiers to the campaign, for re-targetting.

https://www.stay22.com/allez/roam?aid=<AID>&address=paris&campaign=blog_post_123&campaign=summer_2026

If you're building your own searchbox or itinerary planner, you need to know how many people in the party. Add them to the URL to give your users less to click on. This leads to better conversion rates.

https://www.stay22.com/allez/roam?aid=<AID>&address=paris&checkin=2026-07-01&checkout=2026-07-05&adults=2&children=1

Next steps

Familiarize Yourself - Build and test URLs interactively
Parameters - All available query parameters
Providers - Per-provider details