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.

Direto no Android Studio

1. Faça Download do arquivo .AAR.

Peça ao seu gerente de conta para obter os arquivos SDK.


2. Insira o arquivo navegg-android-x.x.x.aar na pasta do projeto.


3. No menu do Android Studio, clique em file e Project Structure.


4. Vá até o sinal de + para adicionar um novo módulo.

 

5. Selecione Import .JAR/.AAR Package.


6. Vá até a pasta do projeto e adicione o arquivo navegg-android-x.x.x.aar.

7. Depois de selecionado o módulo, clique em finish.

 


8. Clique em App, Dependencies e, depois, no ícone + e, então em, Module Dependency.

9. Selecione o módulo que acabou de importar e dê um OK.


10. Após inserido o módulo a Project Structure deverá ficar assim:

 

Obs.: Caso aconteça algum erro após o OK, verifique as etapas anteriores.


9. 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"/>

10. Adicione o import navegg.main.Navegg que se encontra no site http://search.maven.org na MainActivity.Class

Após a importação, declare a API NaveggApi e instancie new NaveggApi com dois parâmetros: NaveggApi(Context, ID). Context será o contexto da classe e  será o número ID da conta Navegg.

Conteúdo bloqueado

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


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

 

12. 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”;

 

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

 

14.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");