Implementing SDK Navegg’s technology

Integration with Navegg technology is simple and happens by inserting the SDK into the application. It is highly advisable that a professional with programming knowledge to participate in this stage. The following is the SDK implementation:

Version: 1.1.3

1. Adding to your project

An android sdk file is available via JitPack.io in grandle/maven formats. Official documentation jitpack.io

Grandle

Add the repository to the build.gradle file.

allprojects {
    repositories {
       ...
       maven { url 'https://jitpack.io' }
    }
}

Add the sdk as a dependency for your project.

   
dependencies {
   implementation 'com.github.Navegg:navegg-android:1.1.3'
}

Maven

Add the repository.

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

Add any dependencies.

<dependency>
    <groupId>com.github.Navegg</groupId>
    <artifactId>navegg-android</artifactId>
    <version>1.1.3</version>
</dependency>

Direct in Android Studio


2. Inserted the permission in  AndroidManifest.xml 

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

3. Added in MainActivity.Class the import navegg.main.NaveggA that this in site http://search.maven.org.

after the import, declare the API NaveggApi and instantiate new NaveggApi that has two parameters, NaveggApi(Context, ID).

Blocked content

Sign in to view this content.


4. Added the code to track the events.

naveggAPI.setTrackPage("MainActivity");

The events to track the Activity or Fragment should be declared inside the onCreate() or onResume().

The diferents between declare in onCreate() or onResume():

onCreate: The user wil be track once in the activity when the user access the screen. He will be track again when the activity call onDestroy and the user enter in activity.

onResume: In this case, if user enter in the primary activity and, soon after, enter in a secondary activity and return the first activity, the user will be track twice: in the first access the primary activity and in return the secondary activity.

5. Added the code to get data of the user.

naveggAPI.getSegments("#Criteria");

The event to get the segment should be declared inside the onCreate() or onResume().

The name of the segments criterias used to passed to parameter:

“gender”, “age”, “education”, “marital”, “income”, “city”, “region”, “country”, “connection”, “brand”, “product”, “interest”, “career”, “custom”, “everybuyer”, “everyone”

The return his method is a String “123”.

 

6.  Added the code to set a custom segment.

naveggAPI.setCustom("#IDCustom");

Those segments are previously creates in DMP Navegg. After this is possbile mark the user in custom segment.

7. Added the code to set OnBoarding:

naveggApi.setOnBoarding("#param","#value");

Onboarding allows create a relation in database that syncs 1st party keys and 3rd party key.

Parameter “param” values:
prtusride – Email
prtusridc – Personal ID 1 (e.g. SSN);
prtusridr – Personal ID 2 (e.g. DMV);
prtusridt – Phone number;
prtusridf – User’s 1st party ID key;

Parameter “value” is require convert to HASH.

Ex:

naveggApi.setOnBoarding("prtusride","075d8cd74e0c6b1bf77e0a16c93fcdb7e5e37372");