Track Customer Events

Start sending your customers' events on your platform to Gameball.

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.

For more information about events and usage examples, check Tracking Customer Events tutorial.

To send Customer events from your app to Gameball, you can use the sendEvent method as shown below.

Parameter	Type	Required	Description
Event	Event Object	Yes	Event body that is being sent to Gameball's dashboard.
SendEventCallback	Function	No	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.

SendEventinterface sends an Eventobject to Gameball, where the Eventobject is a wrapper holding a single or list of events. To add an event, you should use the sendEvent method and pass to it theEventobject you have created.

Event is a class that helps in creation of the Event with the common attributes mentioned below.

Parameter Name	Type	Required
uniquePlayerId	String	Yes
email	String	No
mobileNumber	String	No
events	(String, Object)	Yes

Event eventBody = Event(
          playerUniqueId: "{playerUniqueId}",
          events: {
            "{eventName}": {
              "{prop1}": "{value1}"
            }
          });

Send the Event

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

// SendEventCallback
sendEventCallback(response, error){
        if(error == null && response != null){
          // TODO Handle on success result.
        }
        else{
          // TODO Handle on failure result.
        }
      }
      
gameballApp.sendEvent(eventBody, sendEventCallback);