Installazione ed inizializzazione

L'operazione SDK di Finteza richiede Android 4.3 (API Level 18) o superiore e la libreria com.android.installreferrer:installreferrer . L'SDK può essere installato utilizzando Gradle o manualmente scaricando il pacchetto all'indirizzo https://repo1.maven.org/maven2/net/metaquotes/finteza/finteza-sdk/.

Installazione via Gradle #

Per connettere Finteza SDK, aggiungi la seguente dipendenza alla sezione dipendenze del file build.gradle del tuo progetto:

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

Add the following line to the repositories section:

repositories {
    //...
    mavenCentral()
    }

Installazione manuale #

Scarica l'ultima versione dell'SDK come file aar e copialo nella directory libs del tuo progetto. Successivamente, aggiungi il file aar dell'SDK al progetto come libreria.

Aggiungi il seguente servizio al manifest del progetto:

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

Aggiungi autorizzazioni:

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

Quindi, aggiungi la seguente dipendenza al file build.gradle :

dependencies {
   //... other dependencies
    implementation 'com.android.installreferrer:installreferrer:2.2'
}

Inizializzazione dell'SDK nell'applicazione #

Per inizializzare, chiama il metodo Finteza.initialize nell'handler Application.onCreate o Activity.onCreate :

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

Imposta l'ID del sito web come {WEBSITE_ID}. Può essere ottenuto nelle impostazioni del sito Web (campo ID) del pannello Finteza. Quindi, imposta i parametri:

Parametro

Tipo

Descrizione

site

string

Nome di dominio del sito Web, ad esempio "my.site.com".

product

string

Nome del prodotto da utilizzare come prefisso per gli eventi di etichettatura inviati a Finteza dall'applicazione.

 

Potrebbe essere necessario separare gli eventi su piattaforme diverse nel caso in cui si disponga di app per PC, iOS, Android, ecc. Ad esempio, se specifichi il prodotto "App Android" ed invii l'evento "Registrazione", il nome dell'evento finale in Finteza sarà "Registrazione app Android".

 

Imposta null per evitare di usare il prefisso.

Eventi di lancio dell'applicazione #

Aggiungi il seguente codice a Activity.onCreate:

Finteza.activate()

Quando activate viene chiamato al primo avvio dell'applicazione, SDK invia l'evento "Install Finish" a Finteza (se è specificato il prefisso del prodotto , viene inviato "{PRODUCT} Install Finish").

Inoltre, quando si chiama activate, inizia una nuova sessione di lavoro e viene registrato l'evento "Session Start" (se il prefisso del prodotto è impostato, allora "{PRODUCT} Session Start").

Se un utente lascia l'applicazione, la sessione corrente termina. Al successivo avvio/attivazione dell'applicazione, inizia una nuova sessione.

Messaggi di debug #

Per testare il funzionamento dell'SDK, è possibile abilitare l'output delle informazioni di debug sulla console degli sviluppatori, filtrato per tipo di messaggio:

Solo eventi

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

Logging completo

Finteza.addLogging(LogUtil.LogLevel.ALL);

Solo errori

Finteza.addLogging(LogUtil.LogLevel.ERROR);

Per disabilitare i messaggi di debug, chiama:

Finteza.addLogging(LogUtil.LogLevel.NONE);

Esempio

Il seguente messaggio di debug indica un evento che invia un errore a causa dell'assenza di chiamata del metodo activate :

[event] non riesce a inviare l'evento 'Book Load': chiama prima il metodo 'activate'
← 
 →