Integrating a New Network

Do you want to work with a Network that isn't included in Gamesight's existing integrated network list? Are you a Network that would like to be integrated into the Gamesight platform? This guide will help you with the process of getting setup.

  • Looking to get a Network added? Please reach out to your account manager at that network and provide them this guide. Alternatively, you may contact Gamesight support and we can help get the ball rolling.
  • Looking to integrate your Network? Great! You have come to the right place. Get started by reviewing the integration steps below

Basic Integration Overview

Gamesight is a platform that enables PC & Console game marketers to measure the performance of their campaigns using reliable attribution. By integrating the Gamesight platform into your Network, you can allow your Advertisers to gain insights into the return from their campaigns and ultimately prove your value.

The Gamesight platform provides both click-through and view-through attribution through unique tracking links and impression pixels. In the case that your Network simply wants to enable your Advertising to track their campaigns using our technology, all you need to do is utilize the tracking links as the destination for the placements. Additionally, if you would like to support view-through you would need to embed the impression pixels as well.

  1. Append Parameters to a Tracking Link - Once an Advertiser has provided their Gamesight tracking links, you can append your own additional parameters and Sub ID. For example, you might provide additional URL Parameters for reporting.
https://gsght.com/c/XXXXX?sub1={subid_here}&sub2={subid2_here}
  1. Network Trafficks Links - The final links are now used in live placements. An example click on our above tracking link may look like the following.
https://gsght.com/c/XXXXX?sub1=siteid1&sub2=placement10

Once you are ready to start running campaigns with Gamesight, contact us through live chat or email us at [email protected] and we can verify your macros to ensure the rollout goes smoothly!

Postback Integration Overview

Integrating postbacks with Gamesight will enable you to automatically get performance data back for the campaigns that you are executing. This will enable you to optimize campaigns, automate reporting, and increase transparency for your campaigns in real-time without any spreadsheets.

We perform network integrations through either Server-to-Server (S2S) postbacks or an "Offline Conversion" flow. This postback process involves passing unique click (or impression) IDs on all TouchpointsTouchpoints - Records of the interactions that a user has with one of your marketing campaigns (either an impression or a click). This may include actions such as clicking on a banner ad, opening a marketing email, or following a referral link from an influencer tracked by Gamesight. Then when GoalsGoals - Specific Events or combinations of Events that you are trying to drive users to complete. This may include buying your game, first match completed, user reactivation, or any other combination of events. are attributed to your network we will call your postback URL with that unique ID so you can record the conversion on your end.

In some systems an ID other than the click ID is used, such as a match ID or session ID, but in all cases the flow follow the same principles.

Standard Flow

For most networks the data flow for running a campaign will look like the following:

  1. Client Creates Tracker - The first step (once the integration is complete) is for your client to create a unique Tracker. In this step we provide the option for the user to fill in any Network-specific settings that you might need for your postback (such as a security token).
  1. Network Appends Parameters to Tracking Link - Once the Tracker is setup, you will need to append your own parameters to the tracking link. For example, in addition to adding your click_id to the URL - you might provide additional URL Parameters for reporting.
https://gsght.com/c/XXXXX?network_click_id={click_id}&sub1={subid_here}&sub2={subid2_here}
  1. Network Trafficks Links - The final links are now used in live placements. An example click on our above tracking link may look like the following.
https://gsght.com/c/XXXXX?network_click_id=be6b81811fd&sub1=siteid1&sub2=placement10
  1. User Converts - If the tracked user ends up converting, your S2S postback will trigger with the Postback Macros you define populated.
https://mynetwork.com/postback?click_id=be6b81811fd&goal_id=156&conversion_time=2018-01-01T00:00:00

Can't Support S2S Postbacks?

If your platform is unable to support S2S postbacks, we can still setup your Network on Gamesight. However, you won't be able to receive automated conversion data. This will still allow your clients to get deeper transparency into your campaigns by passing SubIDs through our tracking links.

Step 1: Provide Postback Details

The first step is providing Gamesight support with the details for your S2S postback. Be sure to review the available Postback Macros so you can specify the fields that you would like to be provided. If you require client-specific values such as security tokens, please let us know.

Once you have all of the macros for your postback determined you should have a URL that looks something like the following:

https://mynetwork.com/postback?click_id={click.network_click_id}&goal_id={goal.goal_type_id}&security_token={postback_params.security_token}

Once you have your postback URL ready, please contact us through live chat or email us at [email protected] and we can implement the postback. If you need help determining how to setup the macros for your postback URL, let us know and we can help!

Step 2: Validation

Once the postback is in place, we will provide you with a testing link so we can validate the full flow from end to end. You will need to insert this URL into your platform as the destination for a campaign and provide us with an example placement link.

We will then trigger a full click and conversion flow so you can validate that the conversion appears in your platform. Once this validation is complete we will enable the integration for all of our customers.

Validating Links

After your integration is complete you'll be able to work with any Gamesight customer and automatically get postbacks without any additional work. As an extra step before you begin trafficking any links, we recommend that you use our Link Inspector tool to ensure that your postback is correctly configured for the link your client provides.

Updated 3 months ago


Integrating a New Network


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.