Gameball Developers Guide
v4.0
v4.0
  • Introduction
  • Installing Gameball
    • Web
      • Initialize Gameball Customer Widget
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Go-Live Checklist
    • iOS
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Push Notifications
      • Track Referrals
      • Go-Live Checklist
    • Android
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Push Notifications
      • Go-Live Checklist
    • React Native
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Push Notifications
      • Go-Live Checklist
    • Flutter
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Go-Live Checklist
    • Generic Mobile App
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Push Notifications
  • REST API
    • Overview
      • What's New in V4.0
      • Authentication
      • Rate Limiting
      • Status and Error Codes
    • Customers
      • Customer Management
      • Customer Progress
      • Customer Tags
      • Customer Notifications
    • Events
    • Order
      • Order Tracking
      • Order Rewards & History
    • Payment
      • Payment Tracking
    • Transactions
      • Cashback & Redemptions
      • Hold Management
      • Transaction Management
      • Transaction Validation
    • Coupons
    • Configurations
      • Reward Configurations
      • Program Configurations
      • Widget Configuration
    • Leaderboard
    • Batches
      • Batch Creation
      • Batch Management
  • Webhooks
    • Overview
    • Subscribing to Webhooks
    • Webhook Topics
      • Customer's Notifications
      • Customer's Profile Updates
  • Tutorials
    • Tracking Customer Events
    • Redemption Integration
      • Direct debit redemption
      • Coupons Redemption
        • Use Your Own Couponing Engine
        • Gameball Couponing Engine
    • Checkout Integration
    • Build Custom UI Elements
      • Reward Campaigns
      • VIP Tiers
      • Customer Balance
      • Widget Configurations
      • Coupons Customer Experience
      • Customer Notifications
      • Customer Leaderboard
    • Build your Own Notification System
    • Channel Merging Guide
    • Previewing Potential Points Before Purchase
    • Refund
    • Retail & POS Integration with Gameball Loyalty Program
    • Referrals
    • Widget Deep Links
    • Batch APIs usage example
  • Branch.io Integration
  • Adjust Integration
Powered by GitBook
On this page
  • Why Track Events?
  • How Gameball Event Engine Works
  • Example 1: Tracking "Add to Cart" Events (E-commerce)
  • Example 2: Tracking Music App Events
  • Example 3: Tracking Physical Events
  • How to Use Gameball for Event-Based Campaigns
  1. Tutorials

Tracking Customer Events

PreviousCustomer's Profile UpdatesNextRedemption Integration

Last updated 6 months ago

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.

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": {
    "add_to_cart": {}
  },
  "customerId": "CUST_ID"
}

This basic event lets Gameball know that user_123 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": {
    "add_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.

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.

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": {
    "attend_session": {
      "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.

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

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!

Create Reward Campaign
Rosie’s Cheerleader Reward Campaign
Create Communication Campaign
Rosie’s Cheerleader Communication Campaign
music streaming app
Create Reward Campaign
Rosie’s Cheerleader Reward Campaign
Create Communication Campaign
Rosie’s Cheerleader Communication Campaign