Skip to main content
In Gameball, events are the core of what makes customer interactions exciting and rewarding. Whenever a customer does something on your platform—like adding a product to their cart, watching a video, or attending a physical event—that action can trigger an event in Gameball, allowing you to track it and even reward the customer. Let’s walk through some common examples of event tracking and see how easy it is to set up campaigns and messages that engage your users at every step.
Gameball Events Engine Overview

​
Why Track Events?

Tracking events allows you to:
  1. Gain insights into what your customers are doing on your platform
  2. Reward actions in real-time to drive more engagement
  3. Personalize experiences based on customer interests and behaviors

​
How Gameball Event Engine Works

Gameball listens to your system, takes note of your customers’ actions, and uses that data to trigger rewards or personalized messages. Here’s how to bring this to life with some common examples!

​
Example 1: Tracking “Add to Cart” Events (E-commerce)

Let’s say you run an online store and want to reward customers when they add items to their carts. Here’s how to do it:

​
1. Send a Basic “Add to Cart” Event

When a customer clicks “Add to Cart”, you can send a simple event to Gameball. In this example, we’ll track a customer adding an “iPhone 12” to their cart: 
{
  "events": {
    "added_to_cart": {}
  },
  "customerId": "CUST_ID"
}
This basic event lets Gameball know that the customer has added an item to their cart. You could then create a rewards campaign like “Cart Ninja” to reward customers who add items to their cart frequently.

​
2. Enhance with Extra Information

If you want to go further, add details like product ID, price, and category. This way, you can create even more personalized campaigns or messages based on what your customer is adding to their cart. 
{
  "events": {
    "added_to_cart": {
      "product_id": "231402",
      "product_title": "iPhone 12",
      "price": 1350.00,
      "category": "Mobile Phones",
      "vendor": "Apple"
    }
  },
  "customerId": "CUST_ID"
}
Example Campaigns:
  • Apple Top Fan: Reward users the first time they add an Apple product
  • Custom Message: Encourage users to “Save up to 6% on Apple products when you add a charger!” by sending this message if the added item is an Apple phone

​
Example 2: Tracking Music App Events

Let’s say you have a music streaming app, and you want to reward users for engaging with music. For instance, you can track when a user likes a song to give them rewards based on how often they interact.
Music streaming app event tracking

​
Sending a “Song Liked” Event

When a customer likes a song, send this event with details about the song: 
{
  "events": {
    "song_liked": {
      "song_id": "231402",
      "title": "Coping",
      "album_id": "95621",
      "artist_id": "4773",
      "tags": ["Pop", "R&B"]
    }
  },
  "customerId": "spotify_user123"
}
Example Campaigns:
  • Rosie’s Cheerleader: Reward fans who like 3 songs by the same artist
  • Album Boost: Drive up listens on a new album by rewarding users who like a set number of songs from it
With these event details, you can easily track and engage your customers by setting up campaigns in Gameball.

​
Example 3: Tracking Physical Events

Imagine you’re hosting an on-ground event, like a conference, and want to track attendance at different sessions to boost engagement.
Physical event tracking

​
Sending an “Attend Session” Event

Using a QR code, you can log details every time an attendee enters a session. Here’s how the event might look: 
{
  "events": {
    "session_attended": {
      "session_id": "231402",
      "title": "Using Artificial Intelligence for Marketing Analytics",
      "event_id": "15",
      "session_duration": 90,
      "category": "AI"
    }
  },
  "customerId": "attendee_123"
}
Example Campaigns:
  • AI Warrior: Reward users for attending three AI-related sessions
  • Session Hero: Motivate attendees to attend a specific session by awarding points for checking in
With event data like session duration and category, you can engage attendees and reward them for specific behaviors, making their event experience more interactive.

​
How to Use Gameball for Event-Based Campaigns

​
1. Set Up Rewards

Click on Create Campaign → Rewards to create campaigns triggered by events.
Create Reward Campaign

Create Reward Campaign

Rosie's Cheerleader Reward Campaign

Rosie's Cheerleader Reward Campaign

​
2. Send Messages

Click on Create Campaign → Communication, you can create messages based on event conditions, like offering a discount when certain products are in the cart.
Create Communication Campaign

Create Communication Campaign

Rosie's Cheerleader Communication Campaign

Rosie's Cheerleader Communication Campaign

​
Advanced: Event Engine Configuration

Once you’re tracking events, you’ll want to configure how Gameball responds to them using the Event Engine. The Event Engine provides powerful operators to create sophisticated campaign rules based on customer behavior.

Using the Event Engine

Learn how to use key operators (Equals, Different Values, Accumulative Total, Repeated Value) to create advanced reward campaigns, referral programs, and communication campaigns based on tracked events.

​
Additional Resources

Send Events API

Complete API documentation for tracking events

Event Engine Guide

Dashboard configuration and advanced operators
By capturing key actions through events, you can build an interactive experience that keeps customers engaged, both online and offline. With Gameball, the possibilities are endless—now it’s your turn to make the most of them!