The Events API allows you to pass revenue data allowing you to track your Return on Ad Spend directly through the Gamesight dashboard. There are two different types of revenue that can be attached to events.
Currency conversion is handled as described in our Currency Handling documentation.
Once Per User Revenue
The once_per_user
revenue type is to be used when you are tracking revenue in situations where you intend to send the event more than once but only want to count the revenue once. This should be used in situations such as:
- Attaching revenue to game launch events for premium games
- Attaching revenue to DLC/expansion ownership events that fire every game launch
Here is an example request
curl https://api.ingest.marketing.gamesight.io/events \
-X POST \
-H 'Authorization: SOMEAPIKEYHERE' \
-H 'X-Api-Version: 1.1.0' \
-H 'Content-Type: application/json' \
-d "$(cat <<-EOF
{
"user_id": "b91f8k5r",
"type": "game_launch",
"revenue_currency": "usd",
"revenue_amount": 10.00,
"revenue_type": "once_per_user",
"identifiers": {...}
}
EOF
)"
Cumulative Revenue
The cumulative
revenue type is to be used when you are tracking revenue in situations where you want revenue to be incremented every time the event is seen. This should be used in situations such as:
- Attaching revenue to an in-game purchase upon completion of the transaction
curl https://api.ingest.marketing.gamesight.io/events \
-X POST \
-H 'Authorization: SOMEAPIKEYHERE' \
-H 'X-Api-Version: 1.1.0' \
-H 'Content-Type: application/json' \
-d "$(cat <<-EOF
{
"user_id": "b91f8k5r",
"type": "skin_purchase",
"revenue_currency": "usd",
"revenue_amount": 5.00,
"revenue_type": "cumulative",
"identifiers": {...}
}
EOF)"