Singular MMP

This document is a walkthrough for linking attribution data from Gamesight with Singular so that you can monitor cross-platform activity for titles with a shared account system between PC/console and mobile. Currently, this integration is one way from Gamesight to Singular. An optimized integration will be released soon, featuring two-way data sharing between Gamesight and Singular.


Gamesight has an integration with Singular that enables cross-platform games to gain deeper insights into player behavior between the PC/console and mobile versions of your game in a single dashboard. By enabling the Singular integration, you will be able to:

  • See all of your Gamesight conversion data in your Singular reports
  • Get insight into user movement between the mobile and pc/console editions of your game
  • Differentiate between new installs and users that already played on PC/console editions of your game when running UA campaigns
  • View total lifetime value and player retention data with engagement and revenue data covering both the pc/console and mobile editions of your game

Getting Started

The Singular integration is currently setup manually on an account-by-account basis. There are a few steps that you should follow to link your Gamesight reporting with Singular.

1. Get Your Singular API Key

Your Singular API key allows Gamesight to send attribution data to Singular. You can find your Singular API key within the Singular dashboard. Go to Settings > SDK Keys and copy your API key. Provide this API key to the Gamesight representative assisting you with the Singular integration.

2. Provide Relevant Goal IDs

Gamesight will provide Singular attribution data for individual goals. Notify your Gamesight representative of the goal IDs for which you want to pass attribution data to Singular. Attribution data for any other goal IDs not provided won't be shared with Singular.

3. Append Tracking Links

Gamesight tracking links must be appended with special singular parameters to reflect the campaign structure in Singular reporting. All campaign structure-related macros from the ad network should be mapped to a wp parameter at the end of your Gamesight-generated tracking link, similar to how these macros are mapped to Gamesight parameters. Example of a Facebook tracking URL with Singular wp parameters appended (notice how Gamesight and Singular parameters are mapped to the same Facebook macros):

https://gsght.com/c/XXXXX?campaign={{campaign.id}}&campaign_name={{campaign.name}}&ad_group={{adset.id}}&ad_group_name={{adset.name}}&ad={{ad.id}}&ad_name={{ad.name}}&placement={{placement}}&site_id={{site_source_name}}&wpsrc=Facebook&wpcid={{campaign.id}}&wpsnetn={{site_source_name}}&wpcrid={{ad.id}}&wpscn={{adset.name}}&wpscid={{adset.id}}&wpcrn={{ad.name}}&wpcn={{campaign.name}}

Mapping table of common Singular parameters with its Gamesight equivalent:

Singular wp** ParameterGamesight Parameter
wpcidcampaign
wpcncampaign_name
wpscidad_group
wpscnad_group_name
wpcridad
wpcrnad_name
wpsnetnsite_id

4. Validate Results in Singular Reporting

That's it! Your attribution data will now be shared with Singular. You can validate the results of your Singular reports to confirm that data is flowing from Gamesight to Singular.