Integration

Integrate NotifyVisitors SDK into your android app.

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

Step 1: Import the NotifyVisitors SDK in your project

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

repositories {
   google()
   mavenCentral()
}

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

dependencies {
        implementation 'com.notifyvisitors.notifyvisitors:notifyvisitors:v5.4.7.1'
        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'     
}

Step 2: 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.

I. 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.

II. 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

  • Step 1: 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">

OR

Step 2: In case you have your own application class:

import com.notifyvisitors.notifyvisitors.NotifyVisitorsApplication;
import com.notifyvisitors.notifyvisitors.NotifyVisitorsApplication

Initialize the SDK in the onCreate callback of your application class.

@Override
public void onCreate() {
   super.onCreate();
   NotifyVisitorsApplication.register(this);
}
override fun onCreate() {
   super.onCreate()
   NotifyVisitorsApplication.register(this)
}

What’s Next