Postbacks

Gamesight has a robust postback (webhook) system that provides real-time notifications of new attributed installs. These postbacks can be sent to Ad Networks, BI platforms, or other external services that would want to be notified of new attributed goals.

Postbacks are sent as HTTP requests to an external web server, most frequently GET or POST requests.

📘

Postback Events

Postbacks are only available for triggered Goals. Postbacks for clicks/impressions are not supported.

Configuring Postbacks

To setup postbacks for a particular network, navigate to the tracker page and click on the Postbacks tab. Top level network trackers will have a postback created automatically for your primary conversion goal. You can add additional goals as triggers for this postback or create a new postback for those goals.

Custom Postbacks

Many networks have postbacks enabled that only require you to configure a few parameters. But if you want a fully custom postback that will send goal data back to an internal BI system, you can do so by clicking Add Postback and selecting Custom URL from the select. This will reveal an input for the HTTP method and URL where you would like us to send your goal data. When filling out the parameters you can select from a list of macros that we will replace with information about the touchpoint, event, and goal.

📘

Postback Scope

When postbacks are created they are scoped to the same Game, Team, and Network as the tracker.

Macros

When setting up a new postback there are many macros that are available. Macros are dynamic values or variables that you can request

Global

These macros are available on all postbacks.

* Touchpoint names for platforms with Tracker Hierarchy Mirroring (Facebook, Google CM, etc) may not be present at the time of postback for the first few hours after a new campaign goes live (our systems pull down new campaign names from external platforms every few hours). If a name is not set for the Tracker, these fields will fallback to the ID (eg touchpoint.campaign_name will be the same as touchpoint.campaign).

Network Params

Additional parameters can be made available during Network Tracker configuration. These fields are generally used to define values like security keys or other client-specific Network parameters. All of these Macros are of the form {postback_params.*}

Query Params

All query parameters present in the Touchpoint that triggered the postback are available for use as postback Macros. You can access these fields through the {query_params.*} Macros.

Transforms

The postback system also supports several transforms that will adjust the value of the postback macro before replacing it into your postback request.

Postback Logs

You can view the Postback Log for each individual postback that you have set up in Gamesight for your Network Trackers.

From the Tracker Configuration page, click on the Tracker that you want to view your postbacks for. Next, click the Postbacks tab and click on the postback that you want to view logs for - followed by clicking the "View Logs" button as shown below.

Using the Filters tab, you can set a specific time range for your search. Using the Display tab, you can add additional columns of data such as the User ID, Game ID, Request Headers, Request Body, etc. as shown below.