Knowledge Base         


How do I use Sub-IDs?


Using Sub-IDs is an excellent way to track clicks to your link or rotator on a granular level – for example if you have a landing page with many different buttons and want to use one tracking link to track clicks to each of those buttons.

To learn how to use Sub-IDs, just select whether you are using tracking links or rotators below, and you’ll get all the information you need!



Adding Sub-IDs to your tracking link is very easy.




How to Add Sub-IDs

For example, if this is your regular tracking link:

https://link-domain.com/linkSlug

If you wanted to add a Sub-ID with the value of “homepage” you can just add it to the end like this:

https://link-domain.com/linkSlug/homepage

Or a Sub-ID with the value of “top_banner” like this:

https://link-domain.com/linkSlug/top_banner

You can add up to 5 Sub-IDs to the end of any tracking link just by adding them one after the other, separated with a “/” :

.../value1/value2/value3/value4/value5

Once you start using Sub-IDs like this you’ll be able to view your stats broken down by individual Sub-IDs. Keep reading further to learn how.


What Are Some Best Practices for Using Sub-IDs?

In terms of your incoming traffic, Sub-IDs are generally meant to be used so you can break down your stats by different “things” like unique traffic sources, device type e.g. desktop vs. mobile, etc.

Ideally, for the most detailed stats possible you should really use separate tracking links for just about everything.

For example you send all of your traffic from a particular traffic source to one tracking link, but on that link you set a Mobile URL that points to another tracking link only for your mobile traffic.

But if you just need basic stats or don’t get a ton of traffic, using Sub-IDs should work just fine.

When it comes to your incoming traffic however, Sub-IDs are NOT meant to be used in a way that results in most or all of your Sub-IDs being unique, such as when each click has a unique email or “click ID” as a Sub-ID.

You can use unique Sub-IDs if you need to, and you’ll be able to see those unique identifiers within ClickMagick – for example in your click and sales logs, etc. – and pass them along to your other URLs …

… but Sub-IDs like this are inherently worthless for statistical purposes and therefore these types of Sub-IDs will NOT be included in your Sub-ID or Split Test Reports because they have no value in that context.


How to View Your Sub-ID Data

Finally, when viewing your Sub-ID stats by clicking on the number in the “TC” or “UC” columns, keep in mind that only the first Sub-ID is shown on the initial screen due to space constraints and the fact that most users generally only use one Sub-ID. You can see any additional Sub-IDs by hovering over the symbol.
 
 
 

If you need a more granular look at your data based on the first two Sub-IDs, please see the Sub-ID Stats Report (one of the available reports you can get by clicking on the report icon to the right of your tracking link and selecting “Sub-ID Stats”).
 
 
 

If you want to see all five Sub-IDs, you can also download a CSV of all your data for further review by clicking on the little wrench icon to the right of your tracking link and selecting “Download CSV”.
 
 



Combine Your Sub-ID Stats

If you have more than two Sub-IDs and you want to see the data from your link stats—without having to download the data—simply combine multiple Sub-IDs into a single Sub-ID using a separation character, such as a “-”.

For example instead of using a link like this with three Sub-IDs:

https://link-domain.com/linkSlug/subid1/subid2/subid3

... you could combine “subid2” and “subid3” using a hyphen or other character like this,:

https://link-domain.com/linkSlug/subid1/subid2-subid3

Just be aware that when you combine multiple Sub-IDs like this, you might exceed the maximum length for a Sub-ID which is 255 characters. Any extra characters will be dropped.


Passing Sub-IDs to Your Primary URL

If you want to pass your Sub-IDs to the link in the Primary URL, you can do that too. The tokens [s1]-[s5] can be used anywhere in your Primary URL and ClickMagick will replace each token with the corresponding Sub-ID that is passed in with each click.

For example if you wanted to pass the first Sub-ID to the offer parameter in the query string of your Primary URL, you would do it like this:

https://www.company.com?offer=[s1]

If you were passing the third Sub-ID to another ClickMagick tracking link in your Primary URL, you would simply pass it forward just as you would pass any Sub-ID to a link:

https://link-domain.com/linkSlug/[s3]

That would pass the [s3] value as the first Sub-ID to the link.

 
Tip: Before using Sub-IDs, you’ll want to make sure you understand exactly what you can pass in them. Sub-IDs are pretty flexible, but there are a few restrictions:
 
What are the valid characters and length of a Sub-ID?



Adding Sub-IDs to your rotator link is very simple as well and works in the same way as it does for tracking links.




How to Add Sub-IDs

For example, if this is your regular rotator link:

https://rotator-domain.com/rotatorSlug

If you wanted to add a Sub-ID with the value of “homepage” you can just add it to the end like this:

https://rotator-domain.com/rotatorSlug/homepage

Or a Sub-ID with the value of “top_banner” like this:

https://rotator-domain.com/rotatorSlug/top_banner

You can add up to 5 Sub-IDs to the end of any rotator link just by adding them one after the other, separated with a “/” :

.../value1/value2/value3/value4/value5

Once you start using Sub-IDs like this you’ll be able to view your stats broken down by individual Sub-IDs. Keep reading further to learn how.


What Are Some Best Practices for Using Sub-IDs?

In terms of your incoming traffic, Sub-IDs are generally meant to be used so you can break down your stats by different “things” like unique traffic sources, device type e.g. desktop vs. mobile, etc.

Ideally, for the most detailed stats possible you should really use separate rotators for just about everything.

But if you just need basic stats or don’t get a ton of traffic, using Sub-IDs should work just fine.

When it comes to your incoming traffic however, Sub-IDs are NOT meant to be used in a way that results in most or all of your Sub-IDs being unique, such as when each click has a unique email or “click ID” as a Sub-ID.

You can use unique Sub-IDs if you need to, and you’ll be able to see those unique identifiers within ClickMagick – for example in your click logs – and pass them along to your other URLs …

… but Sub-IDs like this are inherently worthless for statistical purposes and therefore these types of Sub-IDs will NOT be included in your Sub-ID or Split Test Reports because they have no value in that context.


How to View Your Sub-ID Data

Finally, when viewing your Sub-ID stats by clicking on the number the “TC” or “UC” column, keep in mind that only the first Sub-ID will show up due to space constraints and the fact that most users generally only use one Sub-ID with rotators. You can see any additional Sub-IDs by hovering over the symbol.

 
 

If you need a more granular look at your data based on the first two Sub-IDs, you can use tracking links and use the Sub-ID Stats Report (one of the available reports you can get by clicking on the report icon to the right of your tracking link and selecting “Sub-ID Stats”).
 
 


If you end up using tracking links to access more detailed Sub-ID reports, you can also see all five Sub-IDs by downloading a CSV of all your data by clicking on the little wrench icon to the right of your tracking link and selecting “Download CSV”.
 
 


Combine Your Sub-ID Stats

If you have more than one Sub-ID and you want to see the data from your link stats—without having to download the data—simply combine multiple Sub-IDs into a single Sub-ID using a separation character, such as a “-”.

For example instead of using a link like this with two Sub-IDs:

https://rotator-domain.com/rotatorSlug/subid1/subid2

... you could combine subid2 and subid3 using a hyphen or other character like this,:

https://rotator-domain.com/rotatorSlug/subid1-subid2

Just be aware that when you combine multiple Sub-IDs like this, you might exceed the maximum length for a Sub-ID which is 255 characters. Any extra characters will be dropped.


Passing Sub-IDs to Your Rotator URL

If you want to pass your Sub-IDs to your specific rotator URLs, you can do that too. The tokens [s1]-[s5] can be used anywhere in your rotator URL and ClickMagick will replace each token with the corresponding Sub-ID that is passed in with each click.

For example if you wanted to pass the first Sub-ID to the offer parameter in the query string of your rotator URL, you would do it like this:

https://www.company.com?offer=[s1]

If you were passing the third Sub-ID to another ClickMagick rotator in your rotator URL, you would simply pass it forward just as you would pass any Sub-ID to a rotator:

https://rotator-domain.com/rotatorSlug/[s3]

That would pass the [s3] value as the first Sub-ID to the rotator URL.
 
 
Tip: Before using Sub-IDs, you’ll want to make sure you understand exactly what you can pass in them. Sub-IDs are pretty flexible, but there are a few restrictions:
 
What are the valid characters and length of a Sub-ID?




Article 3 Last updated: 07/20/2020 6:32:28 PM
https://www.clickmagick.com/kb/?article=3