User Acquisition Telemetry

🔹 Tools to use: Big Fish Telemetry Services, AppsFlyer, GoGame

What is Telemetry?

Telemetry is the process of collecting and transmitting data from one source to another. In the gaming industry, telemetry data is used to monitor and track how players interact with various parts of the game, such as clicking on ads or reading messages. In addition, you can collect data about the player's mobile device, operating system, and more.

Games published by Big Fish use a combination of tools to collect, transmit and monitor player data:

• The Big Fish Telemetry Services automatically collect game-specific data such as install events, purchases, and session times. In addition, you can create custom events directly from the BFG SDK or through the GTS API.
• AppsFlyer tracks and attributes install and post-install events for paid and non-paid marketing channels.
• GoGame is a powerful publishing tool developed by Plarium that receives telemetry data and applies it to User Acquisition (UA) activities, such as marketing spending. GoGame has complete write access to changes in budgets, bids, and business rules that can directly impact the business of your game. When your application is configured correctly in GoGame, the system automatically detects telemetry events and converts them into GoGame’s API payload format. Once converted, the payload is sent to GoGame to be accessed by the UA team.

Setting Up GoGame

The initial setup of GoGame is performed by the User Acquisition (UA) team. Your Big Fish Producer will provide UA with the following information:

• App name
• App genre
• Three-letter app abbreviation

Once UA has completed the GoGame registration, they will provide you with a GoGame appID.

Integrating GoGame

info

GoGame integration is usually started ahead of the Soft Launch retention phase in Production M2 and is not required for Limited Market Tests in the Market Validation phase.

After your application is registered with GoGame, ensure your application is properly set up to utilize GoGame by doing the following:

1. Integrate the BFG SDK.
2. Set up telemetry events with the BFG SDK or GTS API. Ensure that your application has at least the four main telemetry events (install, session start, session end, and purchase) configured properly. See Telemetry Services for more information.
3. Integrate AppsFlyer.

Once integrated, the BFG SDK sends and populates telemetry events that are then later transformed into GoGame events. You will be able to begin using telemetry events to start passing sessions and deposits to GoGame.

GoGame Events

warning

For iOS apps, GoGame will only receive telemetry events if App Tracking Transparency (ATT) is accepted by the end-user, which returns a status of 3. If the ATT status is not 3, the data will not be sent to GoGame. See App Tracking Transparency for more information.

Once the BFG SDK is integrated into your game and you are receiving telemetry events, GoGame is running. However, there is currently no system for game teams to track whether GoGame events are successful or not. Reach out to your Producer to confirm that events are being sent successfully. In general, it is safe to assume that if a telemetry event succeeds, then GoGame is working correctly.

With GoGame events and call tracking being automatic, it is useful to know what event calls will trigger GoGame calls. The following lists all the telemetry fields that GoGame tracks:

Session Start
Purchase
Custom Events

ip
languageCode
appUserId
data{}
- eventName
raveId
platform
msgPayloadVersion
environment
osInfo

deviceInfo{}
- idfv
- appTrackingTransparencyStatus
- thirdPartyTrackingEnabled
- appsFlyerKey
- ifaEnabled
- ifa
- googleAdvertisingEnabled
- googleAdvertisingId
- amazonAdvertisingId
- amazonAdvertisingEnabled

bundleId
deviceBrand
deviceModel
deviceOsVersion
osVersion

price
currency
transactionId

eventData{}
eventName