Advertisers - Technical integrations

Understanding and implementing SubIDs

SubIDs are additional tracking parameters that can be added to Affilae affiliate links. They enable clicks to be tracked and make it easier to monitor conversions in detail.

 

SubID format

  • Maximum number of SubIDs per link: 6 (subid0 to subid5)
  • Maximum length per SubID: 255 characters
  • Allowed characters: alphanumeric

URL structure

  • Special characters must be encoded in URLs
  • Avoid spaces (use hyphens or underscores)
  • SubIDs may not contain personal data (RGPD)

 


2024 version

– Parameter

https://landing-page.com?ae=AFID&aev=SUBID

– SEO

https://landing-page.com#aeAFID&aevSUBID

– Redirection

https://lb.affilae.com/r/?p=PID&af=AFID&cv=SUBID&lp=https%3A%2F%2Flanding-page.com

 


2025 version 

 

The subId which was transmitted via the cv or aev variable is depreciated, its end of life is for the beginning of 2025. The value of the old subId is systematically copied into subId0.

Major changes in 2025:

– New parameter names:

  • aesubid0 to aesubid5 replace aev and cv

– There are 3 link formats:

  • 2 Client Side
  • 1 Server to server
  • The nomenclature remains the same for subIDs.

– The SEO parameter will be deprecated in January 2025.

 


Examples of use

 

C2S : Parameter

https://landing-page.com?aesubid0=subid0&aesubid1=subid1&aesubid2=subid2&aesubid3=subid3&aesubid4=subid4&aesubid5=subid5&ae=AFID

 

C2S : SEO

https://landing-page.com?aesubid0=subid0&aesubid1=subid1&aesubid2=subid2&aesubid3=subid3&aesubid4=subid4&aesubid5=subid5#aeAFID

 

S2S : Redirection

https://lb.affilae.com/r/?p=PID&af=AFID&aesubid0=subid0&aesubid1=subid1&aesubid2=subid2&aesubid3=subid3&aesubid4=subid4&aesubid5=subid5&lp=https%3A%2F%2Flanding-page.com

 

Notes : ⚠️⚠️

  • Existing integrations using the old subId do not need to make any changes for the time being.
  • The technical restrictions (length, authorised characters) remain the same for all versions
  • Numbering always starts at 0 and goes up to 5.

 


FAQ

 

➜ How many SubIDs can I use simultaneously? You can use up to 6 SubIDs (subid0 to subid5) simultaneously in the same link.

➜ Do SubIDs impact link performance? No, adding SubIDs does not have a significant impact on loading times or link performance, they may make the URL format heavier.

➜ Are SubIDs visible to end users? Yes, SubIDs are visible in the URL, so avoid including sensitive information.

➜ How can SubID data be analysed? The data can be accessed via:

  • Viewing conversions (tunnel) and exporting conversions.
  • Visualisation of clicks, and export of clicks.
  • The API (clicks and conversions)