Inserción de la SDK Android en su aplicación

La integración con la tecnología Navegg es fácil y se realiza por medio de la inserción de la SDK en la aplicación.

Es aconsejable que un profesional con conocimientos en programación participe de esta tarea. A continuación, los pasos para la implementación de la SDK.

 

En el Android Studio

1. Haga el download del archivo .AAR.

Pídale a su Gerente de Cuenta que obtenga los archivos SDK.

2. Inserte el archivo navegg-android-x.x.x.aar en la pasta del proyecto.


3. En el menú de Android Studio, haga clic en File y Project Structure.


4. Añada un nuevo módulo, haciendo clic en +.


5. Seleccione Import .JAR/.AAR Package.


6. Acceda a la pasta del proyecto y añada el archivo navegg-android-x.x.x.aar.

7. Haga clic en Finish.

 


8. Haga clic en App, Dependencies y, luego, en + y Module Dependency.

9. Seleccione el módulo que ha importado y haga clic en OK.


10. Después de insertado el módulo, el Project Structure deve quedarse así:

 

Observación: Si passa algun error, después del OK, compruebe los pasos anteriores.

 


11. Inserte las permisiones en el AndroidManifest.xml

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

12. Añada el import navegg.main.Navegg que está en el sitio web http://search.maven.org en la MainActivity.Class

Después de la importación, declare la API NaveggApi e instáncie new NaveggApi con dos parámetros: NaveggApi(Context, ID).

Contenido bloqueado

Inicie sesión para ver este contenido.


13. Añada el código para rastrear los eventos

naveggAPI.setTrackPage("MainActivity");

Se debe declarar el evento para rastrear la Activity o el Fragment dentro de onCreate() o onResume().

La diferencia entre declarar en onCreate() o en onResume() es:

onCreate – Se rastreará el usuario una sola vez en la activity cuando él acceder a la pantalla. Se lo rastreará nuevamente cuando la activity llamar el onDestroy y el usuario entrar en la activity.

onResume – En este caso, si el usuario entrar en la activity primária y, luego, entrar en una activity secundária y volver para la activity primária, se lo rastreará dos veces: en el primero acceso de la activity primária y en el regresso a la activity secundária.

 

14. Añada el código para recoger los datos de los usuarios.

naveggAPI.getSegments("#Criterio");

Se puede declarar el evento para recoger los segmentos dentro de la onCreate() o del onResume().

El parámetro #Criterio tiene que ser cambiado por uno de los critérios de segmentos abajo:

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

Mientras si envié #NomeSegmento en la función, su retorno es una String. Por ejemplo: “123”.

 

15. Añada el código para configurar un segmento personalizado.

naveggAPI.setCustom("#IDCustom");

Estos segmentos son previamente creados en el DMP de Navegg. Después de esta creación, es posible marcar el usuario en el Segmento Personalizado, como en el código enseñado arriba.

 

16. Añada el código para configurar OnBoarding.

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

El Onboarding permite crear una sincronización en el banco de datos entre 1st Party keys y 3rd party keys.

La referencia de valor para el parámetro “param” es:

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;

Además, hay que convertir el parámetro “value” para HASH. Por ejemplo:

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