What is a partner ID?
When you join Travelpayouts, you're assigned a unique Partner ID (previously known as a marker). It's automatically added to every affiliate tool you create — links, widgets, White Labels, and so on.
This ID allows us to:
- Track your clicks, searches, and bookings
- Assign earnings to your account
When someone clicks your tool, the Partner ID is stored in a cookie on their device for 30 days (unless otherwise specified by the program). If they make a booking during that time, you receive a commission.
Your Partner ID is visible in the lower-left corner of your Travelpayouts dashboard.
What is a SubID?
A SubID is an additional parameter you can add to any affiliate tool. It helps you identify:
- Which tools perform best
- Which placements drive conversions
- How different traffic sources compare
Unlike the Partner ID (which is set automatically), you define SubIDs yourself when copying the tool from your Travelpayots account and use them to analyze data more granularly.
Example: Let’s say you use several different tools in different parts of the website. For example, the search module in the sidebar, links to search for tickets in the articles on the website, a banner in the footer of the website, etc. To get separate statistics for each tool, use the SubID when copying or setting up the tool in your affiliate dashboard.
Examples of SubIDs
Placement | SubID |
---|---|
Widget on the sidebar | sidebar_widget |
Banner in blog footer | footer_banner |
Telegram ad campaign | tg_july_flights |
Hotel deeplink in newsletter | email_hotels_aug |
How to add SubID to tools
Links
When creating a text link, a SubID can be added to the link using the deep link creation form:
You can also add a SubID when copying ready-made links:
Widgets
In the widget setup screen, a SubID is added using a special field.
White Label
To add a SubID to your White Label, simply include it in the White Label URL using the following template: http://YOUR_DOMAIN/?marker=YOUR_ID.subID.
For example: http://whitelabel.travelpayouts.com/?marker=1234567.WLActions
In this example, you will be able to track all actions that occurred on the White Label using the specified SubID "WLActions" in the statistics.
Where to View SubID Statistics
Go to Reports → Performance. Here you can:
- Filter by a specific SubID
- Group statistics by SubID
-
Check bookings, clicks, conversion rates, and earnings
Best Practices for SubIDs
- Keep them short and meaningful (e.g.,
tg_hotels
notaaaa1234
) - Use lowercase + underscores for consistency
- Stick to a naming system (like
channel_type_location
) - Don’t reuse the same SubID for unrelated tools
- Use them consistently to build long-term reporting habits
Note! In the name of the SubID, you can use numbers, letters of the Latin alphabet, and the underscore character "_". The maximum length of a SubID is — 4096 characters.
Service markers
Sometimes reports may contain service markers that are used by our services.
- cal — This is a SubID indicating that an action (search/click/booking) was made after a click-through from the price chart to Aviasales
- tpsub — Subscription widget
- tpcalwt — Low-price calendar widget
- _tpform — Widget for our campaigns
- alert — Price alert from the Aviasales website
- hotelsmap — Hotel map widget
- map — Flight map