Configuring Goals

Goals are 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. Goals can be managed by clicking Management on the left-hand side of your console dashboard navigation, followed by clicking Goals below the Game column.


From this page, you can examine the configuration of your default goals, create new goals, or manage event triggers. There are two goals set up by default on each game: Install and Reactivation.

You can find examples for how to configure goals for common situations in the Use Case Guides.

After you have your event measurement deployed you should start seeing your goals being attributed on the dashboard. Check out the Testing Attribution guide for some details on how to test your new Goals.

Configuring Goals - Video Tutorial

Trigger Configuration

Each Goal may have one or more event triggers. When configuring a Goal you will be presented with a screen that asks you create a trigger. First you will need to fill in the Event Type that will trigger the Goal.


In addition, you can specify whether this event will trigger the Goal only the first time the event is seen or not. The First Time Event setting should be set to "Yes" for situations like Install measurement where you want to trigger the Goal on the first game launch for a specific user.

The Retrigger Time setting can be used to set a minimum time between events before this Goal will be triggered. This is used in Reactivation measurement to set how long a user must be inactive before they become eligible for reactivation.


Event Count Triggers

Goals can also be configured to trigger on the specific count of event. For example if you would like a Goal to trigger on the 3rd match played by a user, you would set the Event Count Trigger to 3.

This feature is not yet self-configurable through the console, so if you would like to use Event Count Triggers please contact us and we can complete configuration for you.


Retention Triggers

Goals can also be configured with a minimum and maximum retention window that a user must play during in order to trigger a goal. For example, if you would like to define a D3 Retention goal to trigger for all users that play between their 3rd and 5th day after install this can be configured by setting the Min Retention Trigger to 3 Days and the Max Retention Trigger to 5 days.

This feature is not yet self-configurable through the console, so if you would like to use Retention Triggers please contact us and we can complete configuration for you.

Goal Revenue

Goals can be configured with revenue information based on region. This can be useful if your game is priced differently in various regions. We use the location data attached to the event to determine which revenue value should be used when the goal is triggered.

There are two methods for reporting revenue into Gamesight:

  • Event Payload - For cases in which you have a known revenue value when sending the event, you can pass revenue data in the event payload. This is commonly used with in-game purchases.
  • Configuring Goals - For cases in which revenue is unknown when an event is triggered. This is commonly the case for game or DLC sales which are handled by a distribution platform. This revenue value is managed through the Gamesight Console and allow you to both specify revenue values by region and made time-based changes for events such as sales or free weekends.

Goal revenue configuration interface

Goal revenue configured through the Gamesight Console will override any revenue values that are passed in the event payload. This enables some common use cases such as:

  • Temporarily adjusting the revenue value when the game is on sale either globally or in a specific region
  • Setting up revenue values for situations where the game client is unsure of the likely sale price for your game
  • Configuring more complex region-specific or multi-currency pricing schemes to more accurately reflect the revenue earned from your game (or DLC).

You should continue to use the revenue fields on events for managing In-Game purchases or other variable revenue values that are known at time of purchase.


"Global" region

The global region is used when there is no revenue configured for a given event's location. It is the default revenue setting and will be used instead of revenue info set on the event. It is common to set up a single "Global" revenue value if your game has a single price globally.

To add revenue, go to the goal settings under the "Manage" tab and click '+ Revenue'. Pick a platform, region, and the price associated with it and click 'Add'. Then click 'Submit' to save the goal configuration.


Scheduled Revenue

Scheduled Revenue enables you to pre-schedule changes to the price of your game on specific platforms or regions. This enables you to accurately and granularly account for sales or pricing changes for your Game.

To start with Scheduled Revenue, click the + Revenue button under the Scheduled Revenue header on your Goal. This will let you fill out the name, start time, and end time for your event. Note that the start and end times are in your computer's local time.


Scheduled revenue event configuration

Next, press Configure to set the prices for your event


Scheduled revenue pricing configuration

Save your changes and that is it! Your updated pricing will automatically be applied to all goal triggers during the timeframe you specified.

Revenue Import

You can import revenue data for your goals with a CSV, which can be helpful in cases where you have a large amount of pricing data to import. To start you will need to prepare a CSV containing the revenue data for your Goals in an appropriate format. You can use the following template to help you get started.

Once you have your revenue data prepared it is time to import it into Gamesight. To do this click the "Import Goal Data" in the upper right of the goal configuration panel.


Import Goal Data button in the upper right.

Select your CSV and map the columns to the appropriate data type so that our system can import your data.


CSV column mapping

We will parse your CSV and surface any issues for you to review. Once the data looks good, click "Import" and your data will be imported.


CSV data review