AdGyde Logo

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
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 Install receiver code in the androidmanifest.xml

Note:
Please make sure that following receiver tag is kept inside application tag.

<receiver android:name="com.adgyde.android.InstallReceiver" android:exported="true">
<intent-filter>
<action android:name="com.android.vending.INSTALL_REFERRER" />
</intent-filter>
</receiver>

If an application uses multiple INSTALL_REFERRER receivers, you should use com.adgyde.android.MultiInstallReceiver instead of com.adgyde.android.InstallReceiver.
MultiInstallReceiver MUST be the first receiver on Top of all the other INSTALL_REFERRER receivers

<receiver android:name="com.adgyde.android.MultiInstallReceiver" android:exported="true">
<intent-filter>
<action android:name="com.android.vending.INSTALL_REFERRER" />
</intent-filter>
</receiver>

If you want to use multiple receivers, then the Manifest.xml file should look like this:

<!--The AdGyde Install Receiver should be placed first and it will broadcast to all receivers placed below it -->
<receiver android:name="com.adgyde.android.MultiInstallReceiver" android:exported="true">
<intent-filter>
<action android:name="com.android.vending.INSTALL_REFERRER" />
</intent-filter>
</receiver>

<!--All other receivers should be followed right after -->
<receiver android:name="com.google.android.abc.AbcReceiver" android:exported="true">
<intent-filter>
<action android:name="com.android.vending.INSTALL_REFERRER" />
</intent-filter>
</receiver>

<receiver android:name="com.adsmobi.android.xyz.InstallReceiver" android:exported="true">
<intent-filter>
<action android:name="com.android.vending.INSTALL_REFERRER" />
</intent-filter>
</receiver>


3.6 Add permissions to project
Add following permissions to AndroidManifest.xml

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


3.7 Add dependency to project
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.


This website uses cookies in order to improve your experience and our services. By continuing to use our website, agree to the use of such cookies. Click here for Privacy Policy.