Documents Events - AdGyde Solutions

Events

Event is a powerful tool to track interaction between user and mobile application.
There are 3 kinds of events, which are

Simple Event
Counting Event
Computing Event

1. Simple Event

Simple event is an event without parameters. It can be used to track simple event. For example, if you need to track how many times user Clicked "Registration" Button. Just put a line at onClick() function in the activity.

function simpleEvent() {

// Fire simple event named "registration"
AdGydeTracker.simpleEvent("registration");
window.plugins.toast.showShortBottom(
'Simple Event Triggered',
function(a){
console.log('toast success: ' + a)
},
function(b){
alert('toast error: ' + b)
}
);

}

Simple event can be used to construct funnel, the details for same can be found under funnel section.

For more complicated event tracking - Counting Event or Computing Event should be considered.

2. Counting Event

Counting Event is useful to track event which needs counting. For example, if we are developing a news application. This application has three categories, which are local news, national news and international news. We need to know which category is the most popular, just implement the following code on click listener.

function showToast(ToastText) {

window.plugins.toast.showShortBottom(
ToastText,
function(a){
console.log('toast success: ' + a)
},
function(b){
alert('toast error: ' + b)
}
);

}

/**
* Being triggered if "Local News" tab clicked.
*/

function countingEventLocal() {

// parameter to be passed {"parameter_name" : "value"}
var parameter={"category":"local_news"};
// AdGydeTracker.countingEvent(eventid, parameter);
AdGydeTracker.countingEvent("selected_category", parameter);

showToast('Counting Event Triggered');

}

/**
* Being triggered if "National News" tab clicked.
*/

function countingEventNational() {

// parameter to be passed {"parameter_name" : "value"}
var parameter={"Category":"national_news"};
// AdGydeTracker.countingEvent(eventid, parameter);
AdGydeTracker.countingEvent("selected_category", parameter);

showToast('Counting Event Triggered');

}

/**
* Being triggered if "International News" tab clicked.
*/

function countingEventInternatonal() {

// parameter to be passed {"parameter_name" : "value"}
var parameter={"Category":"international_news"};
// AdGydeTracker.countingEvent(eventid, parameter);
AdGydeTracker.countingEvent("selected_category", parameter);

showToast('Counting Event Triggered');

}

As the events are different and AdGyde Server needs to differentiate that the event is counting event, therefore events need to be added in Dashboard with specified type.

Following are the steps to add counting event in Dashboard

Login to AdGyde Dashboard
Open Setup Page from Left Navigation Menu
Click on Manage Events under Events option
Click on 'Create an Event' button on Top right Corner
Select your Application Name
Select 'Counting' under Type field
Enter event_id as 'selected_category', this should be same as first parameter of AdGydeTracker.countingEvent(String, Map<String, String>)
Enter 'category' on parameter_name field
Click on 'Create' button

3. Computing Event

Computing Event can be used to track accumulative values.

E.g. If we put our banner in application with different Weightage or say Cost, then using the computing event we can know the Contribution of each Banner as per weightage assigned.

/**
* Invoked when offer clicked.
*/

function onOfferClicked() {

// First Array entry is for Parameter Name and Sub-event name which will be accumulated.
// Second Array entry is for Sub-event name and its accumulating value. Value must be integer type.
var parameters={"offers_list", price};

// Trigger event where first parameter is event_id
AdGydeTracker.computingEvent("offers", parameters);

showToast('Computing Event Triggered');

}

Computing event uses 2 parameters. First parameter defines event id say 'offerslist' and parameter which will be accumulated. Second parameter defines parameter value. For example, application placed 2 banners. First for a 'Special Offer', with Product of ₹6. Second is 'Exclusive Offer', with Product of ₹55. 'Special Offer' clicked 39 times, 'Exclusive Offer' clicked 4 times. Accumulated value is 'Special Offer' = ₹6 * 39 = ₹234, 'Exclusive Offer' = ₹55 * 4 = ₹210.

4. Revenue Event

There is a separate Revenue event which should and can be used for keeping track of revenue generated through the application. Revenue shown in the Dashboard is also based on this event only.

/**
* Invoked when Revenue needs to be calculated.
*/

function revenueEvent() {

// Record successful Revenue for 17 Units (Units can be defined on Dashboard)
AdGydeTracker.eventRevenue(17);
showToast('In App Revenue Event Triggered');

}

5. Unique Event

Unique Event is useful to track events which need unique counting in a specific time period. For example, if we develop a news application. This application has three categories, which are local news, national news and international news.

AdGyde provides Unique Events in three types

eventDailyUnique
eventPermanentUnique
eventCustomUnique

The 3 Types of Unique events can be used for different requirements

To know how many unique users complete the Game Stage in each date, eventDailyUnique should be used
To know how many unique users complete the Game Stage in user lifetime, eventPermanentUnique should be used
To know how many unique users complete the Game Stage in 24 Hours, eventCustomUnique should be used

For the unique event following code needs to be implemented

/**
* Daily Unique event allows to keep an event unique for current date
* When user completes Game Stage
*/

function onGameStageCompleted() {

//The parameter being passed in unique event are in combination of ParameterName and Value
var parameters={"level":"level_1"};

// Event is triggered with EventId and Parameters prepared above, the same are passed in this function
AdGydeTracker.eventDailyUnique("gamelevelcomplete", parameters);

showToast('Daily Unique Event Triggered');

}

/**
* Permanent Unique event allows to keep an event unique for user lifetime
*/

public void onGameStageCompletedUnique() {

//The parameter being passed in unique event are in combination of ParameterName and Value
var parameters={"level":"level_1"};

// Event is triggered with EventId and Parameters prepared above, the same are passed in this function
AdGydeTracker.eventPermanentUnique("gamelevelcomplete",parameters);

showToast('Permanent Unique Event Triggered');

}

/**
* Custom Unique event allows to keep an event unique for user defined time (hours)
*/

public void onCategoryInternationalNewsClicked() {

//The parameter being passed in unique event are in combination of ParameterName and Value
var parameters={"level":"level_1"};

// Event is triggered with EventId and Parameters prepared above, the same are passed in this function

// The third parameter (3) specifies that the Event will not be counted again before 3 hours
AdGydeTracker.eventCustomUnique("gamelevelcomplete",parameters, 3);

showToast('Custom Unique Event Triggered');

}

As the events are different and AdGyde Server needs to differentiate that the event is unique event, therefore events need to be added in Dashboard with specified type.

Please follow instructions below to create unique event

Login to AdGyde Dashboard
Open Setup Page from Left Navigation Menu
Click on Manage Events under Events option
Click on 'Create an Event' button on Top right Corner
Select your Application Name
Select 'Unique' under Type field
Enter event_id as 'gamelevelcomplete', this should be same as first parameter of AdGydeTracker.eventDailyUnique(String, Map<String, String>) or eventPermanentUnique or eventCustomUnique
Enter 'level' on parameter_name field
Click on 'Create' button