URL Parameters & Macros
URL Parameters and Macros can be used together to dynamically manage all of your Gamesight Trackers. These two features together with a bit of creativity can let you do anything from managing Dynamic Trackers, to giving users unique landing pages, to setting up complex Ad Network integrations.
Read more about passing Tracker Hierarchy parameters through URL Parameters in the Dynamic Trackers guide.
|Tracker's Campaign ID||None|
|Campaign's display name in the Console||Inherits Campaign ID value|
|Tracker's Ad Group ID||None|
|Ad Group's display name in the Console||Inherits Ad Group ID value|
|Tracker's Ad ID||None|
|Ad's display name in the Console||Inherits Ad ID value|
The following parameters let you provide more precision in your reporting structure by tracking additional common dimensions. These values do not alter Tracker behavior, they are simply passed directly into your reporting as additional fields that you can group/filter by.
|Used to designate the type of creative being used in this ad (text/video/banner/etc)||None|
|Location on the page where this ad was placed (sidebar, feed, top, position 3, etc)||None|
|Holds keyword(s) for SEM campaigns||None|
|Holds a unique ID for the specific creative||None|
|Identifies specific site/platform ad was run through within a network, used for differentiating Facebook vs Instagram vs Messenger, for example||None|
|Identifies sub-site/sub-platform ad was run through|
|Arbitrary tag-like parameters that can be used to track any additional dimensions you would like to add to your reporting||None|
Cost parameters can be used to help you track the cost of each Touchpoint for campaigns that are running with simple pricing models. Review the Measuring ROAS guide for more details on working with cost reporting.
|The model to use when assigning cost to this touchpoint. Allowed values are: CPM, CPC, CPI||CPC|
|Cost amount on a per unit basis. For example, for a 1.00 CPI this field would be set to 1.00||0.00|
|Currency that cost information is reported in.||USD|
If any of the External IDs that you are using for direct attribution are known at the time of click/impression those values can be passed directly as URL Parameters instead of using the Web SDK to create session mappings. General details about External ID implementation can be found in the Web Measurement SDK Quick Start.
|The External ID value, format depends on the Type provided.||None|
|The External ID Type, supported types can be found here.||None|
|Set the hashing behavior for this external ID.|
- unset: stores the ID unhashed
|Used to manage this id's scope:|
|The organization that this ID is scoped to.||None|
As an example here are a few complete External ID definitions using URL Parameters:
# Passing a single id ?xid[id]=123456789&xid[type]=steamid64 # Passing a single id with hashing options ?xid[id]=testing&xid[type]=xbgt&xid[sha256]=server # Passing multiple ids ?xid[id]=123&xid[type]=psid&xid[id]=456&xid[type]=xuid
|Click through attribution window (in seconds) for this Touchpoint. Only valid on Click Tracking URLs||None. Inherited from Parent Tracker(s)|
|View through attribution window (in seconds) for this Touchpoint. Only valid on Impression Tracking URLs||None. Inherited from Parent Tracker(s)|
|Full URL to redirect user to. Only valid on Click Tracking URLs. More details below||None. Inherited from Parent Tracker(s)|
destination_url macro can be useful for complex tracking scenarios where you have multiple landing page variants. By passing
destination_url to your tracker you can override the Destination URL value set on your tracker.
For example, if you have a tracker
https://gsght.com/c/XXXXXX that normally directs users to
https://gamesight.io but you want to send some traffic selectively to
https://store.steampowered.com you can override the Destination URL like so:
This link will now send the user to Steam when clicked. Some common use cases for the
destination_url macro include:
- Overriding the landing page when working with Dynamic Trackers - specifically for managing multiple landing pages on Facebook Ads.
- Managing multiple localized landing pages without generating separate Trackers for each page.
- Chaining your Gamesight tracking structure with third party click measurement solutions such as Sizmek or DCM.
The following macros are available on all click tracking links despite their values not being passed through the URL Parameters.
|ID for current click|
|Game ID for Tracker used for click|
|Team ID for Tracker used for click|
|Network for Tracker used for click|
|Campaign for Tracker used for click|
|Ad Group for Tracker used for click|
|Ad for Tracker used for click|
Any parameter passed to the click URL (whether that is a SubID, cost, or even a
custom parameter that you append) can be replaced in the destination URL for the
For example, if my tracker has a destination URL of:
We can use a click link of:
This will send the user to:
Updated 5 months ago