Instalasi dan inisialisasi

Operasi Finteza SDK memerlukan Android 4.3 (API Level 18) atau lebih tinggi dan pustaka com.android.installreferrer:installreferrer. SDK dapat diinstal menggunakan Gradle atau secara manual dengan mengunduh paket di https://repo1.maven.org/maven2/net/metaquotes/finteza/finteza-sdk/.

Instalasi melalui Gradle #

Untuk menghubungkan Finteza SDK, tambahkan dependensi berikut ke bagian dependensi dari file build.gradle proyek anda:

dependencies {
   //... dependensi lainnya
   implementasi 'net.metaquotes.finteza:finteza-sdk:+'
}

Add the following line to the repositories section:

repositories {
    //...
    mavenCentral()
    }

Instalasi manual #

Unduh versi SDK terbaru sebagai file aar dan salin ke direktori libs proyek anda. Selanjutnya, tambahkan file aar SDK ke proyek sebagai sebuah pustaka.

Tambahkan layanan berikut ke manifes proyek:

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

Tambahkan izin:

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

Selanjutnya, tambahkan dependensi berikut ke file build.gradle:

dependencies {
   //... dependensi lainnya
   implementasi 'com.android.installreferrer:installreferrer:2.2'
}

Menginisialisasi SDK dalam aplikasi #

Untuk menginisialisasi, panggil metode Finteza.initialize dalam Application.onCreate atau pawang Activity.onCreate:

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

Tetapkan ID situs web sebagai {WEBSITE_ID}. Ini dapat diperoleh di pengaturan situs web (bidang ID) dari panel Finteza. Selanjutnya, atur parameter:

Parameter

Jenis

Deskripsi

situs

rangkaian

Nama domain situs web, misalnya, "my.site.com".

produk

rangkaian

Nama produk yang akan digunakan sebagai sebuah awalan untuk pelabelan peristiwa yang dikirim ke Finteza oleh aplikasi anda.

 

Anda mungkin memerlukannya untuk memisahkan peristiwa di berbagai platform jika anda memiliki aplikasi untuk PC, iOS, Android, dll. Misalnya, jika anda menentukan produk "Aplikasi Android" dan mengirim peristiwa "Registrasi", nama peristiwa terakhir di Finteza adalah "Pendaftaran Aplikasi Android".

 

Atur nol untuk menghindari penggunaan awalan.

Peristiwa peluncuran aplikasi #

Tambahkan kode berikut ke Activity.onCreate:

Finteza.activate()

Ketika mengaktifkan dipanggil pada permulaan aplikasi pertama, SDK mengirim peristiwa "Instal Selesai" ke Finteza (jika awalan produk ditentukan, "{PRODUCT} Instal Selesai" dikirim).

Juga, saat panggilan mengaktifkan, sebuah sesi kerja baru dimulai dan peristiwa "Sesi Mulai" terdaftar (jika awalan produk diatur, maka "{PRODUCT} Sesi Mulai").

Jika seorang pengguna meninggalkan aplikasi, sesi saat ini berakhir. Berikutnya aplikasi diluncurkan / diaktifkan, sebuah sesi baru dimulai.

Pesan debugging #

Untuk menguji operasi SDK, anda dapat mengaktifkan output informasi debug ke konsol developer, difilter menurut jenis pesan:

Hanya peristiwa

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

Penebangan penuh

Finteza.addLogging(LogUtil.LogLevel.ALL);

Hanya kesalahan

Finteza.addLogging(LogUtil.LogLevel.ERROR);

Untuk menonaktifkan pesan debug, panggil:

Finteza.addLogging(LogUtil.LogLevel.NONE);

Contoh

Pesan debug berikut ini menunjukkan kesalahan pengiriman peristiwa karena tidak adanya panggilan metode aktifkan:

[peristiwa] tidak dapat mengirim peristiwa 'Muat Buku': panggil metode 'aktifkan' terlebih dahulu
← 
 →