Automatic Click Measurement

Automatic Click Measurement (ACM) is a feature that helps you to increase coverage of Gamesight tracking across your campaigns. ACM integrates with your existing UTM structures to automatically measure Gamesight click data from your landing pages, even in cases where a click tracking tag isn't present. With a small tweak to your Web SDK integration you can get coverage from your earned channels, existing partners, and ad platforms that do not yet support Gamesight's click trackers.

ACM works by inspecting the UTM parameters you have set on your landing page for your game and determining whether that traffic has already been measured by a Gamesight Tracking link. If the click hasn't been measured, ACM will automatically track a click with parameters that map your UTM structure into your Gamesight reporting.

In the case where the traffic wasn't measured by a Gamesight Tracking link and UTM parameters aren't specified, ACM will check for Referrer data on the page. If a Referrer is present, ACM will use the Referrer domain in your Gamesight reporting.

When to use ACM

Some situations where you should consider utilizing ACM for your game include:

  • You have existing earned or organic links driving traffic that contain UTM parameters that you would like to measure with Gamesight, but replacing them with new links would be impractical
  • You are working with an ad platform that doesn't allow redirects on their landing page URLs but would still like to measure this traffic with Gamesight
  • You have existing teams and workflows that are centered around using UTM tagging for measurement and want to start leveraging Gamesight immediately without retraining or changing processes
  • You would like to see web referrer data in your Gamesight reporting and attribution (similar to Referral reporting in Google Analytics)

Requirements

  • You must have the Web SDK integrated on the marketing site for your game
  • You must have UTM Mirroring enabled
  • ACM will only measure traffic that is driven to your marketing site (it cannot measure traffic that go directly Steam, Playstation Store, etc.)
  • Your Gamesight Trackers must drive directly to your player's final URL (NOT Bitly, Sizmek, or any other platform that then redirects the user to the marketing page. Gamesight appends parameters to your landing page to prevent duplicate click measurement - additional redirects in the chain can break this parameter passing. If you must drive traffic through an additional partner, please reach out to us so we can review your configuration)

Getting Started

Enabling ACM is a straightforward process.

1. Confirm UTM Mirroring is Enabled

Under Management > Game Settings review the configuration for your Game to ensure that UTM Mirroring is enabled and you have the correct Google Ads tracking template in place (if applicable). ACM uses the same mapping of UTM parameters <> Gamesight tracker hierarchy as outlined in the UTM Mirroring guide.

2. Update Web SDK Initialization

To enable ACM you will need to implement the Web Measurement SDK on your game's marketing site (or wherever you are driving traffic). You can read more about integrating the SDK on the Web SDK Quickstart guide. Here is an example snippet with ACM enabled:

<script>
// Gamesight SDK Snippet
(function(G,m,s,g,h,t){G.gsght=G.gsght||function(){
(G.gsght.q=G.gsght.q||[]).push(arguments)},G.gsght.q=[],G.gsght.h=1*new Date();
h=m.createElement(s),t=m.getElementsByTagName(s)[0];h.async=1;h.src=g;t.parentNode.insertBefore(h,t)
})(window,document,'script','https://cdn.gsght.com/sdk.js');
  
gsght('init', 'GS-XXXXXX')
gsght('set', 'acm_enabled', true)
gsght('send')
</script>

Note that the acm_enabled flag tells the SDK to turn on Automatic Click Measurement.

That's it! You will now start to see UTM-tagged traffic from your landing page as attributable clicks in your Gamesight reporting.

Advanced Configuration

In addition to the standard UTM parameter mapping that is available, ACM can support many more reporting and configuration parameters. Most of the URL Parameters available on Trackers are also available for use with ACM. To avoid conflict with existing parameters in use on your website, all of the Gamesight URL Parameters must be prefixed with gs_ for use by ACM. You can find a full list of the supported parameters below.

Hierarchy Parameters

URL ParameterDescriptionDefault
gs_networkTracker's Network IDNone
gs_network_nameNetwork's display name in the ConsoleInherits Network ID value
gs_campaignTracker's Campaign IDNone
gs_campaign_nameCampaign's display name in the ConsoleInherits Campaign ID value
gs_ad_groupTracker's Ad Group IDNone
gs_ad_group_nameAd Group's display name in the ConsoleInherits Ad Group ID value
gs_adTracker's Ad IDNone
gs_ad_nameAd's display name in the ConsoleInherits Ad ID value

Reporting Dimensions

URL ParameterDescriptionDefault
gs_ad_typeUsed to designate the type of creative being used in this ad (text/video/banner/etc)None
gs_placementLocation on the page where this ad was placed (sidebar, feed, top, position 3, etc)None
gs_keywordHolds keyword(s) for SEM campaignsNone
gs_creativeHolds a unique ID for the specific creativeNone
gs_site_idIdentifies specific site/platform ad was run through within a network, used for differentiating Facebook vs Instagram vs Messenger, for exampleNone
gs_sub_site_idIdentifies sub-site/sub-platform ad was run through
gs_sub1, gs_sub2, gs_sub3, gs_sub4, gs_sub5, gs_sub6, gs_sub7, gs_sub8, gs_sub9, gs_sub10Arbitrary tag-like parameters that can be used to track any additional dimensions you would like to add to your reportingNone

Cost

URL ParameterDescriptionDefault
gs_cost_modelThe model to use when assigning cost to this touchpoint. Allowed values are: CPM, CPC, CPICPC
gs_cost_amountCost amount on a per unit basis. For example, for a 1.00 CPI this field would be set to 1.000.00
gs_cost_currencyCurrency that cost information is reported in.USD

Miscellaneous

URL ParameterDescriptionDefault
gs_attribution_windowClick through attribution window (in seconds) for this Touchpoint. Only valid on Click Tracking URLsNone. Inherited from Parent Tracker(s)

Note that Gamesight-specific URL Parameters will take precedence over UTM parameters. For example, if you pass both utm_campaign=1 and gs_campaign=2 to a page with ACM enabled, the click will be measured for Campaign 2.

Specifying Team ID

By default, all traffic measured by Automatic Click Measurement will be placed in your "Default Team" (the team with the lowest ID in your Game). If you would like to specify which Team traffic reports under you can specify a team ID in the utm_medium parameter.

For example, if I want my UTM-tagged traffic to be measured by ACM under the "External Agency" team in my account, I would first look up the Team ID corresponding to my team.

643643

Desired Team for ACM Measurement

In this example, the Team ID is 123456789 so we will need to apply that ID to our UTM structure. The medium parameter uses the format utm_medium={ad_type}_{team_id}, so if you would like to specify the Ad Type as social_media and Team as 123456789 you would use a link of the form:

https://mygame.com?utm_source=twitter
&utm_campaign=launch&utm_medium=social_media_123456789

Notice the utm_medium=social_media_123456789 parameter at the end of the link which includes both the desired Ad Type and Team ID values. If you do not wish to set the Ad Type parameter, you can just use the Team ID prefixed with an _ as your utm_medium value:

https://mygame.com?utm_source=twitter
&utm_campaign=launch&utm_medium=_123456789

You can now run traffic to this page and it will report under the "External Agency" Team on Gamesight.