Inserção da SDK em seu aplicativo

A integração com a tecnologia Navegg é simples e acontece por meio da inserção da SDK no aplicativo.

A integração com a tecnologia Navegg é simples e acontece por meio da inserção da SDK no aplicativo. É extremamente aconselhável que um profissional com conhecimento em programação participe desta etapa. Seguem abaixo os passos para a implementação da SDK.

Versão atual: 1.1.3

1. Adicionando ao seu projeto

A sdk android está disponível via JitPack.io nos formatos grandle/maven. Documentação oficial jitpack.io

Grandle

Adicione o repositório no arquivo build.gradle.

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

Adicione a sdk como dependência do seu projeto.

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

Maven

Adicione o repositório

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

Adicione a dependência.

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

Direto no Android Studio


2. Insira as permissões no 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. Adicione o import navegg.main.Navegg

Após a importação, declare a API NaveggApi e instancie new NaveggApi com dois parâmetros: NaveggApi(Context, ID).

Conteúdo bloqueado

Você precisa fazer login para visualizar esse conteúdo.


4. Adicione o código para trackear os eventos.

naveggAPI.setTrackPage("MainActivity");

O evento para trackear a Activity ou o Fragment deverá ser declarado dentro da onCreate() ou do onResume().

A diferença entre declarar na onCreate() ou no onResume() é:

onCreate – O usuário será trakeado uma única vez na activity quando acessar a tela. Ele será trackeado novamente quando a activity chamar o onDestroy e o usúario entrar na activity.

onResume – Neste caso, se o usúario entrar na activity primária e, logo após, entrar numa activity secundária e voltar para a activity primária, o usuário será trackeado duas vezes: no primeiro acesso a activity primária e no retorno a activity secundária.

 

5. Adicione o código para pegar os dados do usúario.

naveggAPI.getSegments("#Critério");

O evento para pegar os segmentos poderá ser declarado dentro da onCreate() ou do onResume().

O nome dos critérios dos segmentos utilizados para ser passado por parâmetro:

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

O retorno desse metódo é uma String “123”;

 

6. Adicione o código para setar um segmento personalizado:

naveggAPI.setCustom("#IDCustom");

Esses segmentos são préviamente criados no DMP Navegg. Após isso é possível marcar o usúario no Segmento Personalizado, como no código acima.

 

7.Adicione o código para setar OnBoarding:

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

Onboarding permite criar um relacionamento no banco de dados que sincroniza entre 1st party keys e 3rd party keys.

Parâmetro “param” valores:

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;

Além disso, é necessário converter o parâmetro “value” para HASH. Por exemplo:

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