Documents Sdk Integration Process

Integration Process

1. Get the App Key

Sign-in to AdGyde Dashboard, the credentials would have already been provided by AdGyde support team. In case you have not yet received the same, please contact the AdGyde Support Team.

Please follow the given steps :-
Step 1 - Visit the AdGyde Website - https://www.adgyde.com/
Step 2 - Go to Login
Step 3 - Sign-in with the provided credentials
Step 4 - Go to Setup Page
Step 5 - Select Manage Applications from the Application option on Setup Page
Step 6 - Click on "Create an application" option on Top Right corner
Step 7 - Fill in the Application details
Step 8 - Note down the App Key for integration reference

2. Download Cordova SDK

Select Download link from the SDK KIT option on Setup Page.
Link will redirect you to AdGyde SDK Page. From here download the Desired SDK

Integrate the downloaded SDK using the below steps

3. Integrate SDK into project

3.1 Add library files into the project

Unzip AdGyde Android Cordova Plugin
Put the AdGyde Android Plugin file into the plugin folder

3.2 Follow below steps to import plugin into the project

Open Cordova Project and switch platform to Android
Use "Cordova prepare" command for adding plugin into the platform.

3.3 Initializing AdGyde

Android Cordova plugin needs to be initialized in the application. Please check Example project on Android Cordova Plugin for complete code.

document.addEventListener("deviceready", function(){

// AdGyde Initialise

// Initialize AdGyde SDK with appkey & default channel id "Organic".

// When application is installed from Google Play Store without any campaign the Channel will be Organic as specified in Init Function

// In case the application is installed through a campaign link then the Default channel will be overridden and value from the campaign link will be passed.

AdGydeTracker.initAdGyde("Your App key","Organic");

});

3.4 Pass IMEI to AdGyde (Works for Android 9 and below)

If the application needs to pass the IMEI and record the same along with other user details, then Android SDK needs to be given permission to pick up IMEI explicitly. Even when application has the permission, AdGyde SDK doesn't pick up IMEI without App developer consent which user needs to pass to the SDK using AdGydeTracker.onAllowIMEI(true) function

Along with above permission make sure application itself has the permission to pick up IMEI. Add Phone state permission in the applications manifest.xml file

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Below is the sample code to initialize Android SDK with App Developer consent to pass IMEI

document.addEventListener("deviceready", function(){

// AdGyde Initialise
// Initialize AdGyde SDK with appkey & default channel id "Organic".
// When application is installed from Google Play Store without any campaign the Channel will be Organic as specified in Init Function
// In case the application is installed through a campaign link then the Default channel will be overridden and value from the campaign link will be passed.

AdGydeTracker.initAdGyde("Your App key","Organic");

//Permission for Collecting IMEI
AdGydeTracker.onAllowIMEI(true);

// Custom User Flow
AdGydeTracker.setCurrentScreen("home_page");
// FCM token method call
onFcmToken();

});

3.5 Add permissions to project

Add following permissions to AndroidManifest.xml

<uses-permission android:name="android.permission.INTERNET">
</uses-permission>

3.6 Add dependency to project

To allow th application to get the attribution details, the below code is mandatory.

Add the following dependency to Android gradle file (Module : android).

dependencies {

// . . .
compile 'com.android.installreferrer:installreferrer:1.0'

// . . .

}

4. Sessions

A session is a conversation between mobile application and user. A session starts with application start and it ends after the user has quit the application. AdGyde helps to track the sessions of the application, session duration and time spent by user on application.

Sessions Detailed Integration Process

5. User Flow

'User Flow' allows the Application Developer to gauge the movement of its users through the activities / Page defined in the application. By analysing the user flow Sankey diagram, the App developer can predict which activity / page is most popular among its users and where the drop-off rates are high.

User Flow Detailed Integration Process

6. Uninstall Tracking

AdGyde's Uninstall Tracking functionality allows you to track the number of uninstalls for a specified application. Uninstalls is an important index which helps you to track the quality of users and hence the campaign.

Un-Install Detailed Integration Process

7. Events

AdGyde's Event Tracking allows an application owner to track the events triggered by users. What user is doing in the application are generally tracked using the events like - Registration, Add to Cart, Payment initiated, Payment.
AdGyde supports multiple types of events, please follow the below link to integrate events in the application

Events detailed integration process

8. Deep Linking

Deep linking is the act of launching a mobile app while serving personalized content or sending the users to specific activities within the application.

Deep Linking Detailed Integration Process

9. Demography

AdGyde demography data provides details of Age and Gender wise segregation of User, this can be used by Advertiser to target the new users and run their campaigns effectively.

Demography detailed integration process

10. Pass additional data to SDK

AdGyde allows to pass additional data like Userid to SDK so that same can be correlated to the AdGyde Data and logs.

Advertiser's User id
In case Advertiser needs to relate Applications analytics data with its own User Id then advertiser can pass the same to AdGyde SDK explicitly using AdGydeTracker.SetUserId("ADG1045984") function. Analytical data then can be shared with the install, events etc. Userid wise also.