Installatie en initialisatie

Finteza SDK vereist Android 4.3 (API-niveau 18) of hoger en com.android.installreferrer:installreferrer library. De SDK kan worden geïnstalleerd met Gradle of handmatig door het softwarepakket te downloaden op https://repo1.maven.org/maven2/net/metaquotes/finteza/finteza-sdk/.

Installatie via Gradle #

Om Finteza SDK te verbinden, voegt u de volgende afhankelijkheid toe aan de dependencies sectie van het build.gradle bestand van uw project:

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

Add the following line to the repositories section:

repositories {
    //...
    mavenCentral()
    }

Handmatige installatie #

Download de laatste SDK versie als een aar bestand en en kopieer het naar de libs directory van uw project. Voeg vervolgens het SDK aar-bestand toe aan het project als een library/bibliotheek.

Voeg de volgende service toe aan het projectmanifest:

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

Machtigingen toevoegen:

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

Voeg vervolgens de volgende afhankelijkheid toe aan het build.gradle bestand:

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

SDK initialiseren in de toepassing #

Om te initialiseren, roept u de Finteza.initialize methode aan in de Application.onCreate or Activity.onCreate handler:

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

Stel de website-ID in als {WEBSITE_ID}. Het kan worden verkregen in de website-instellingen (ID-veld) van het Finteza paneel. Stel vervolgens de parameters in:

Parameter

Type

Omschrijving

site

string

Website domein naam, bijvoorbeeld, "my.site.com".

product

string

Productnaam die moet worden gebruikt als een prefix voor het labelen van evenementen die door uw toepassing naar Finteza worden verzonden.

 

U hebt het misschien nodig om evenementen op verschillende platforms van elkaar te scheiden voor het geval u meerdere apps voor pc, iOS, Android, enz. Hebt. Als u bijvoorbeeld de "Android App" product en het send "Registreren" evenement, dan zal de uiteindelijke naam van het evenement in Finteza "Android App Registratie" zijn.

 

Voer null in om de prefix niet te gerbuiken.

Applicatie evenementen lanceren #

Voeg de volgende code toe aan Activity.onCreate:

Finteza.activate()

Wanneer activate wordt aangeroepen bij de eerste start van de toepassing, verzendt de SDK "Installatie Voltooid" evenement naar Finteza (wanneer de product prefix is gespecificeerd, wordt "{PRODUCT} Installatie Voltooid" verzonden).

Ook, wanneer u activate aanroept, zal een nieuwe werksessie beginnen en het "Session Start" evenement is geregistreerd (als de product prefix is ingesteld, "{PRODUCT} Session Start").

Als een gebruiker de toepassing verlaat, wordt de huidige sessie beëindigd. De volgende keer dat de applicatie wordt gestart / geactiveerd, begint een nieuwe sessie.

Debugging berichten #

Om de SDK-werking te testen, kunt u de uitvoer van foutopsporingsinformatie naar de ontwikkelaarsconsole inschakelen, gefilterd op berichttype:

Alleen Evenementen

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

Full logging

Finteza.addLogging(LogUtil.LogLevel.ALL);

Alleen Errors

Finteza.addLogging(LogUtil.LogLevel.ERROR);

Om debugging berichten uit te schakelen roept u:

Finteza.addLogging(LogUtil.LogLevel.NONE); aan.

Voorbeeld

Het volgende foutopsporingsbericht geeft een fout bij het verzenden van een gebeurtenis aan vanwege de afwezigheid van het aanroepen van de activate methode:

[event] evenement kan niet verzonden worden 'Book Load': roep eerst de 'activate' methode aan
← 
 →