Установка и инициализация

Для работы Finteza SDK требуется Android 4.3 (API Level 18) или выше, а также библиотека com.android.installreferrer:installreferrer.  Установить SDK можно через Gradle или же вручную, скачав пакет по ссылке https://repo1.maven.org/maven2/net/metaquotes/finteza/finteza-sdk/.

Установка через Gradle #

Чтобы подключить Finteza SDK, в секцию dependencies файла build.gradle вашего проекта добавьте следующую зависимость:

dependencies {
    //... другие зависимости
    implementation 'net.metaquotes.finteza:finteza-sdk:+'
}

В секцию репозиториев добавьте:

repositories {
    //...
    mavenCentral()
    }

Установка вручную #

Скачайте последнюю версию SDK в виде aar-файла и скопируйте его в директорию libs вашего проекта. Далее добавьте aar-файл SDK в проект в качестве библиотеки.

Добавьте в манифест проекта сервис:

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

А затем разрешения:

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

Далее в файл build.gradle добавьте зависимость:

dependencies {
    //... другие зависимости
    implementation 'com.android.installreferrer:installreferrer:2.2'
}

Инициализация SDK в приложении #

Для инициализации вызовите метод Finteza.initialize в обработчике Application.onCreate или Activity.onCreate:

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

В качестве {WEBSITE_ID} укажите идентификатор сайта. Его можно получить в панели Finteza в разделе настроек сайта (поле "ID"). Далее задайте параметры:

Параметр

Тип

Описание

site

string

Доменное имя сайта. Например, "my.site.com".

product

string

Название продукта. Используется как префикс для маркировки событий, отправляемых в Finteza вашим приложением.

 

Он может понадобиться для разделения событий по разным платформам: когда у вас есть приложения для десктопа, iOS, Android и т.д. Например, если вы укажете продукт "Android App" и отправите событие "Registration", то итоговое имя события в Finteza будет "Android App Registration".

 

Чтобы не использовать префикс, укажите значение null.

События при запуске приложения #

Добавьте следующий код в обработчик Activity.onCreate:

Finteza.activate()

При вызове activate на первом запуске приложения SDK отправляет в Finteza событие установки "Install Finish" (если задан префикс продукта, то "{PRODUCT} Install Finish").

Также при вызове activate начинается новая сессия работы приложения и регистрируется событие "Session Start" (если задан префикс продукта, то "{PRODUCT} Session Start").

Любой уход из приложения завершает текущую сессию работы. При последующем запуске/активации приложения начинается новая сессия.

Отладочные сообщения #

Для тестирования работы с SDK вы можете включить вывод отладочной информации в консоль разработчика с фильтрацией по типу сообщений:

Только события

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

Полное логирование

Finteza.addLogging(LogUtil.LogLevel.ALL);

Только ошибки

Finteza.addLogging(LogUtil.LogLevel.ERROR);

Для отключения отладочных сообщений вызовите:

Finteza.addLogging(LogUtil.LogLevel.NONE);

Пример

Такое отладочное сообщение указывает на ошибку в отправке события, связанную с отсутствием вызова метода activate:

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