Events Module for Native Android

This section explains the steps to integrate the now.gg Events module with your development environment.

To get started, download the now.gg SDK download package that contains the now.gg Events module and add it to your development environment.

Add SDK Libraries

Start by downloading the now.gg SDK package that contains the Events module libraries and add them to your development environment by following the steps below:

Note: The now.gg SDK package contains the Events module and sample code.

1. Extract the compressed now.gg Events module and locate the .aar file in the package:

 Events.aar

2. Add the following dependency to the build.gradle file of your game:

dependencies {
         implementation fileTree(dir: 'libs', include: ['*.aar'])
 }

Use now.gg Events Module

Once the module has been successfully imported, you can now use the now.gg Events Module.

We have included some of the sample commands/events as a reference for your implementation.

You can use the NowGGEventsSdkManager class to trigger events as illustrated below:

1. Send Events and Data to the HTML Page

You can call the sendEventToBrowser function of the NowGGEventsSdkManager class, along with the required parameters, to send the events and data to your HTML page and handle it there.

a. Send Events to HTML Page

string eventName = "test-event";
 string eventData = "test-data";

 NowGGEventsSdkManager.getInstance().sendEventToBrowser(eventName, eventData, activityContext);

Reference – Additional information associated with sendEventToBrowser() can be found here.

b. Handle Events on HTML Page

After the data has been sent to your HTML, you can handle it there, as illustrated below:

const eventCallbackFunction = (event) => {
 console.log(event.eventName); // event1
 console.log(event.eventData); // eventData1
  
 // Perform event-based handling here
 };

2. Retrieve app Launch Data in your App

We have provided two methods to retrieve the app launch data you sent to your Android App from the HTML page.

a. Use the bundle to retrieve all app launch data parameters

You can call the getAppLaunchDataBundle function of the NowGGEventsSdkManager class, as illustrated below:

 //Retrieves a bundle of all app launch data params
 
 Bundle bundle = NowGGEventsSdkManager.getInstance().getAppLaunchDataBundle(activityContext);

Reference – Additional information associated with getAppLaunchDataBundle() can be found here.

b. Use property name to retrieve a specific app launch data parameter

You can call the getAppLaunchDataProperty() function of the NowGGEventsSdkManager class, along with the property name, to retrieve a specific app launch data parameter, as illustrated below:

 //Retrieves an app launch data property by name 

 String property = NowGGEventsSdkManager.getInstance().getAppLaunchDataProperty("event_name", activityContext);

Note: Returns an empty string if the property is not found.
Reference – Additional information associated with getAppLaunchDataProperty() can be found here.

Start Integrating

References