ID and SubID (Affiliate marker and additional marker)

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 not aaaa1234)
  • 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