IntegrazioniInstallazione ed inizializzazione

Installazione ed inizializzazione

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

Installazione via Gradle #

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

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

Installazione manuale #

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

Aggiungere 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, aggiungere la seguente dipendenza al file build.gradle

dependencies {
   //... altre dipendenze
    implementation 'com.android.installreferrer:installreferrer:1.0'
}

Inizializzazione dell'SDK nell'applicazione #

Per inizializzare, chiamare 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, impostare i parametri:

Parametro

genere

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 si specifica 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, chiamare:

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] cannot send event 'Book Load': call the 'activate' method first