Installation og initialisering

Finteza SDK operation behøver Android 4.3 (API Level 18) eller højere og com.android.installreferrer:installreferrer bibliotek. SDK kan installeres ved at bruge Gradle eller manuelt ved at downloade pakken hos https://repo1.maven.org/maven2/net/metaquotes/finteza/finteza-sdk/.

Installation via Gradle #

For at forbinde Finteza SDK, tilføj den følgende afhængighed til afhængighederne sektionen af build.gradle fil fra din projekt:

dependencies {
   //... andre afhængigheder
    implementation 'net.metaquotes.finteza:finteza-sdk:+'
}

Add the following line to the repositories section:

repositories {
    //...
    mavenCentral()
    }

Manuel installation #

Download den seneste SDK version som en aar file og kopier den libs vejledningen af dit projekt. Som det næste, tilføj SDK aar filen til projektet som et bibliotek.

Tilføj den følgende tjeneste til projektets manifest:

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

Tilføj tilladelser:

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

Som det næste, tilføj den følgende afhængighed til build.gradle fil:

dependencies {
   //... andre afhængigheder
    implementation 'com.android.installreferrer:installreferrer:2.2'
}

Initialisering SDK i appen #

Til initialisering, brug Finteza.initialize metoden i Application.onCreate eller Activity.onCreate manager:

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

Indstil hjemmesidens ID som {WEBSITE_ID}. Dette kan findes i hjemmeside-indstillingerne (ID-feltet) på Finteza-panelet. Som det næste, indstil parametrerne:

Parameter

Type

Beskrivelse

site

streng

Hjemmesidens domænenavn, eksempelvis, "my.site.com".

product

streng

Produktnavnet kan bruges som et forudindstillet til mærker til events, som sendes til Finteza af din app.

 

Du kan bruge den til at adskille events mellem forskellige platforme i tilfælde at du har apps til PC, iOS, Android, m.m. Eksempelvis, hvis du specificerer "Android appen" produkt og send "Registrering" af event, det endelige eventnavn i Finteza vil være "Android App Registrering".

 

Indstil null for at undgå foranstillede titler.

Applikation lancering events #

Tilføj den følgende kode til Activity.onCreate:

Finteza.activate()

Når activate bliver brugt i den første start af applikationen, SDK sender "Installer Færdigt" event til Finteza (hvis foranstillet produkt er specificeres, "{PRODUCT} Installer Færdigt" er sendt).

Også når det bruges activate, en ny arbejdssession starte og "Session start" event er registreret (hvis produktets præfiks er indstillet, så "{PRODUCT} Session Start").

Hvis en bruger forlader appen, ender den nuværende session. Den næste gang den lanceres /aktiveres, begynder en ny session.


Debugging af beskeder #

For at teste SDK's opperationalitet, kan du tillade udgangen for debugging-information til udviklerens konsol, filtreret af beskedtypen:

Kun events

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

Fuld logging

Finteza.addLogging(LogUtil.LogLevel.ALL);

Kun fejl

Finteza.addLogging(LogUtil.LogLevel.ERROR);

For at deaktivere debugging af beskeder, brug:

Finteza.addLogging(LogUtil.LogLevel.NONE);

Eksempel:

Den følgende debugging af beskeder indikerer en event afsendelses fejl, som følge af manglen på at aktiver metode brug:

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