IntegracionesInstalación e inicialización

Instalación e inicialización

Para el funcionamiento de Finteza SDK, se requiere Android 4.0.3 (API Level 15) o supeior, así como la biblioteca com.android.installreferrer:installreferrer.  Es posible instalar SDK a través de Gradle o manualmente, descargando el paquete mediante el enlace https://bintray.com/finteza/maven/finteza-sdk.

Instalación a través de Gradle #

Para incluir Finteza SDK, añada a la sección dependencies del archivo build.gradle de su proyecto la siguiente dependencia:

dependencies {
   //... otras dependencias
    implementation 'net.metaquotes.finteza:finteza-sdk:+'
}

Instalación manual #

Descargue la última versión de SDK como archivo jar y cópiela en el directorio libs de su proyecto. A continuación, añada el archivo jar SDK al proyecto como biblioteca.

Añada al manifiesto del proyecto el servicio:

<service android:name="net.metaquotes.FintezaService" />

Y después, los permisos:

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

Acto seguido, añada al archivo build.gradle la dependencia:

dependencies {
   //... otras dependencias
    implementation 'com.android.installreferrer:installreferrer:1.0'
}

Inicialización de SDK en la aplicación #

Para proceder a la inicialización, llame el método Finteza.initialize en el manejador Application.onCreate o Activity.onCreate:

Finteza.initialize(getApplication(), "{WEBSITE_ID}""{WEBSITE_URL}""{PRODUCT}");

Como {WEBSITE_ID} indique el identificador del sitio web. Podrá obtenerlo en el panel de Finteza en el apartado de ajustes (campo "ID"). A continuación, establezca los parámetros:

Parámetro

Tipo

Descripción

site

string

Nombre de dominio del sitio web. Por ejemplo, "my.site.com".

product

string

Nombre del producto. Se usa como prefijo para marcar los eventos enviados a Finteza por su aplicación.

 

Podría ser necesario para dividir los eventos por plataformas: cuando usted tiene aplicaciones para escritorio, iOS, Android, etcétera. Por ejemplo, si usted indica el producto "Android App" y envía el evento "Registration", el nombre final del evento en Finteza será "Android App Registration".

 

Para no usar prefijo, indique el valor null.

Eventos al iniciar una aplicación #

Añada al manejador el código siguiente Activity.onCreate:

Finteza.activate()

Al llamar activate en el primer inicio de la aplicación, SDK envía a Finteza el evento de instalación "Install Finish" (si se ha establecido el prefijo del producto, "{PRODUCT} Install Finish").

Asimismo, al llamar activate, comienza una nueva sesión de funcionamiento de la aplicación y se registra el evento "Session Start" (si se ha establecido el prefijo del producto, "{PRODUCT} Session Start").

Cualquier salida de la aplicación finaliza la sesión de trabajo actual. Al iniciar/activar posteriormente la aplicación, se iniciará una nueva sesión.


Mensajes de depuración #

Para poner a prueba el funcionamiento de SDK, usted puede activar la muestra de información de depuración en la consola del desarrollador con filtrado según el tipo de mensaje:

Solo eventos

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

Log completo

Finteza.addLogging(LogUtil.LogLevel.ALL);

Solo errores

Finteza.addLogging(LogUtil.LogLevel.ERROR);

Para desactivar los mensajes de depuración, llame:

Finteza.addLogging(LogUtil.LogLevel.NONE);

Ejemplo

Este mensaje de depuración indica el error en el envío de un evento relacionado con la ausencia de la llamada del método activate:

[event] cannot send event 'Book Load': call the 'activate' method first