Instalace a inicializace

Operace Finteza SDK vyžaduje Android 4.3 (API Level 18) nebo vyšší a com.android.installreferrer:installreferrer knihovnu. SDK lze nainstalovat pomocí Gradle nebo ručně stažením balíčku na https://repo1.maven.org/maven2/net/metaquotes/finteza/finteza-sdk/.

Instalace pomocí Gradle #

Chcete-li připojit Finteza SDK, přidejte následující závislost do sekcezávislostí v build.gradle vašeho projektu:

dependencies {
   //... další závislosti
    implementation 'net.metaquotes.finteza:finteza-sdk:+'
}

Add the following line to the repositories section:

repositories {
    //...
    mavenCentral()
    }

Ruční instalace #

Stáhněte si nejnovější verzi sady SDK jako soubor aar a zkopírujte jej do adresáře libs vašeho projektu. Dále přidejte soubor aar SDK do projektu jako knihovnu.

Přidejte do manifestu projektu následující službu:

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

Přidat oprávnění:

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

Dále přidejte do souboru build.gradle následující závislost:

dependencies {
   //... další závislosti
    implementation 'com.android.installreferrer:installreferrer:2.2'
}

nicializace sady SDK v aplikaci #

Chcete-li inicializovat, volejte metodu Finteza.initialize v Application.onCreate nebo Activity.onCreate handler:

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

Nastavit ID webu jako {WEBSITE_ID}. Lze jej získat v nastavení webových stránek (pole ID) panelu Finteza. Dále nastavte parametry:

Parametr

Typ

Popis

site

string

Název domény webových stránek, například „my.site.com“.

product

string

Název produktu, který se použije jako předpona pro označování událostí odeslaných do Fintezy vaší aplikací.

 

Možná budete muset oddělit události napříč různými platformami v případě, že máte aplikace pro PC, iOS, Android atd. Pokud například zadáte produkt „Android App“ a send „Registration“, bude výslednou událostí ve Finteza „Android App Registration“.>

 

Nastavte null, abyste se vyhnuli použití předpony.

Události při spuštění aplikace #

Přidejte následující kód do Activity.onCreate:

Finteza.activate()

Když je při prvním spuštění aplikace vyvoláno aktivovat, SDK odešle událost "Install Finish" do Fintezy (pokud předpona produktu je zadána, odešle se "{PRODUCT} Install Finish").

Také při volání aktivovat se spustí nová pracovní relace a zaregistruje se událost „Session Start“ (pokud je nastavena předpona produktu, pak „{PRODUCT} Session Start ").

Pokud uživatel opustí aplikaci, aktuální relace skončí. Při příštím spuštění/aktivaci aplikace se spustí nová relace.

Debugging zprávy #

Chcete-li otestovat provoz sady SDK, můžete povolit výstup informací o ladění do vývojové konzole, filtrovaný podle typu zprávy:

Pouze události

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

Úplné protokolování

Finteza.addLogging(LogUtil.LogLevel.ALL);

Pouze chyby

Finteza.addLogging(LogUtil.LogLevel.ERROR);

Chcete-li deaktivovat debugging zprávy, volejte:

Finteza.addLogging(LogUtil.LogLevel.NONE);

Příklad

Následující zpráva o debuggingu označuje chybu při odesílání události z důvodu absence volání metody activate:

[event] nemůže odeslat událost 'Načítání knihy': nejprve vyvolejte metodu 'aktivace'
← 
 →