Overview

This section will describe how to install the NotifyVisitors SDK and configure the Android SDK easily. NotifyVisitors provides users with an Android SDK that helps the app developers to track, segment and engage users.

1) Installation

Import the NotifyVisitors SDK in your project.

Add the following repository to your project-level ' build.gradle file,

repositories {
   google()
   mavenCentral()
}

Add the following dependency to your apps' build.gradle file :

dependencies {
        implementation 'com.notifyvisitors.notifyvisitors:notifyvisitors:v5.4.1.0'
        implementation 'com.android.installreferrer:installreferrer:2.1'

 //Add the following required libraries if not using currently (skip those which are already added)

        implementation 'com.google.android.gms:play-services-location:21.0.1'
        implementation 'androidx.appcompat:appcompat:1.6.1'
        implementation 'androidx.legacy:legacy-support-v4:1.0.0'
        implementation 'com.google.android.material:material:1.9.0'
        implementation 'androidx.recyclerview:recyclerview:1.3.1'
        implementation 'androidx.cardview:cardview:1.0.0'     
          
        implementation platform('com.google.firebase:firebase-bom:30.3.1')
        implementation ('com.google.firebase:firebase-core')   
        implementation ('com.google.firebase:firebase-messaging')
}

Configure AndroidManifest.xml

You must include your NotifyVisitors credentials in the AndroidManifest.xml file of your application to connect your Android app to your NotifyVisitors account.

Insert the below XML snippet inside application tag of your AndroidManifest.xml file :

<application>
     <meta-data android:name="notifyvisitors_bid" 
                android:value="11xx" />
     <meta-data android:name="notifyvisitors_bid_e" 
                android:value="F8665C849AB6xxxxxxxxxxxxxxxxxx" />
.......

</application>

📘
Info
In above example Dummy Brand ID and Secret keys are shown. Kindly login your NV_account to see your credentials.

Insert the below XML snippet inside manifest tag of your AndroidManifest.xml file:

<manifest>
       <uses-permission android:name="android.permission.INTERNET" />
       <uses-permission android:name="android.permission.WAKE_LOCK" />
       <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
       <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
       <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
       <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
       <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

2) Initialization

In case, you don’t have your own application class, then you can register our application class in your apps' manifest file.

<application android:name="com.notifyvisitors.notifyvisitors.NotifyVisitorsApplication">

In case you have your own class application, then you can initialize the SDK in onCreate method of your Application class.

NotifyVisitorsApplication.register(applicationContext);

NotifyVisitorsApplication.register(applicationContext)