# Introduction

In this guide you’ll learn: 

- What are App Events

- Why create App Events

- What are Adjust and Firebase Platforms

- Configuring App Events

- Setting up Game Settings pertaining to App Events on Game Server

**Table of Contents**

* * *

# What are App Events?

App Events are specific in-game actions or milestones (e.g., completing a level, making a purchase, unlocking a reward) that are tracked for analytics, marketing, and optimisation purposes.

# Why create App Events?

App Events allow us to:

- Track user behaviour in detail.

- Send meaningful data to analytics platforms.

- Improve marketing campaigns (e.g., ad attribution, retargeting).

- Optimise game performance based on user interactions.

# What is Adjust?

Adjust is a mobile marketing platform that helps measure user acquisition, attribute installs to marketing campaigns, and analyze event data.

# What is Firebase?

Firebase is Google’s mobile development platform. Among other features, it helps capture and analyze in-game events for performance monitoring, user segmentation, and engagement.

* * *

# 2. Creating App Events

1. Access Harmony.

2. In the left-hand menu, click **App Events**.

3. Open the _New App Event_ form by clicking [**+ New**].

4. Fill in Details:

## How to Add an Adjust Event Milestone

1. Milestone Value:

2. Adjust iOS Token:

3. Adjust Android Token

4. Send event to Firebase (optional)

5. Save the milestone

6. Delete (if needed)

Example:

- Event Key = LevelUp

- Milestone Value = 250

- iOS Token = abc123

- Android Token = xyz456

- Result: The event sent to Adjust will be LevelUp\_250 with the specified tokens.

1. Save the Event to add it to the list.

* * *

## 3. Managing App Events

- **Edit** : Blue pencil icon.

- **Delete** : Red trash icon.

- **Bulk upload** : via CSV.

- **Filter:** for quick lookup.

* * *

## 4. Setting Up Game Settings on the Game Server

App Events must also be enabled in **Game Settings** for them to be sent to external systems like Adjust or Firebase.

1. Access Game Server.

2. Navigate to Game Settings

3. Open Analytics Tab

4. Enable the following fields:

5. Add events: From the drop-downs, select the pertinent pre-configured events.

6. Save the changes to confirm the configuration.

* * *

### Adjust Events Logic

- **Base Event Handling**

- If _Send base event to Adjust = true_:
GS sends Adjust Key, Adjust iOS token, and Adjust Android token as part of the JSON response.

- If _Send base event to Adjust = false_:
No Adjust values are sent for this event.

- **Milestone Handling**

- GS combines base events + milestone events from all selected configs into ios\_token\_remap and android\_token\_remap.

- **Validation:**
Cannot add two App Event configs with the same Adjust Key.
Firebase booleans are ignored for this setting.
For AppsFlyer Event Allow List:
Only AppsFlyer Key is used.
No milestone logic is applied.
Users cannot select two configs with the same AppsFlyer Key (unless empty).

* * *