How Do I Track Customer Events with the Android SDK (v2, Legacy)?

Start sending your customers’ events on your app to Gameball, along with any metadata that describes the event. Depending on your Gameball programs configuration, the customer can be rewarded based upon the sent events. Tracked events can be app events or server-side events depending on how you would like to design your programs. App events can be sent via the available SDK interface and server-side events can be sent to Gameball via the Track Events API. Every Track Event call records a single customer action which we call “events”. We recommend that you make your event names human-readable, so that everyone can figure them out instantly. Event metadata are extra pieces of information you can tie to events you track. They can be anything that will be useful while designing your program. To send Customer events from your app to Gameball, you can use the sendEvent method as shown below.

Parameters

object

required

Event body that is being sent to Gameball.

Show Event Object

string

required

The customer’s unique identifier.

string

Customer’s unique Email address.

string

Customer’s unique Mobile number.

string

required

String representing the event name (e.g., write_review, place_order, etc.), where each key is the event name.

object

An object containing metadata related to the event. The structure of the event object can vary depending on the specific event being recorded. Events can be any significant action a customer performs, such as making a purchase, writing a review, adding to cart, etc.

function

Callback is used for providing the developer with the status of the request as a boolean whether it succeeded or not or with an error if any.

Create Event Object

Event event = new Event.Builder()
        .withCustomerId("customer123")
        .withEventName("purchase_completed")
        .withEmail("jack@domain.com")
        .withMobile("0123456789")
        .withEventMetaData("purchase_price", 19.99)
        .build();

val event = Event.Builder()
    .withCustomerId("customer123")
    .withEventName("purchase_completed")
    .withEmail("jack@domain.com")
    .withMobile("0123456789")
    .withEventMetaData("purchase_price", 19.99)
    .build()

Send the Event

Using the previously created GameballApp instance or by creating a new one, call the sendEvent() method as shown below.

gameballApp.sendEvent(event, new Callback<Boolean>() {
    @Override
    public void onSuccess(Boolean aBoolean) {
        // TODO Handle on success result
    }

    @Override
    public void onError(Throwable e) {
        // TODO Handle on failure result
    }
});

gameballApp.sendEvent(event, object : Callback<Boolean?> {
    override fun onSuccess(aBoolean: Boolean?) {
        // TODO Handle on success result
    }

    override fun onError(e: Throwable) {
        // TODO Handle on failure result
    }
})

Overview

Web & POS Integration

Mobile Integration

How Do I Track Customer Events with the Android SDK (v2, Legacy)?

Parameters

Create Event Object

Send the Event

Next Steps

​Parameters

​Create Event Object

​Send the Event

​Next Steps

Parameters

Create Event Object

Send the Event

Next Steps