安装和初始化

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，请将以下从属添加到您项目的build.gradle文件的从属部分：

dependencies {
   //... 其他从属
    implementation 'net.metaquotes.finteza:finteza-sdk:+'
}

Add the following line to the repositories section:

repositories {
    //...
    mavenCentral()
    }

手动安装 #

下载最新SDK版本的aar文件，并将其复制到您项目的libs目录中。接下来，将SDK aar文件作为程序库添加到项目中。

将以下服务添加到项目清单中：

<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 #

若要安装SDK，请调用Application.onCreate中的Finteza.initialize方法或Activity.onCreate处理程序：

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

设置网站ID 为{WEBSITE_ID}。这可以在Finteza面板的网站设置（ID字段）中获得。接下来，设置参数：

参数

类型

描述

网站

字符串

网站域名，例如"my.site.com"。

产品

字符串

将被用作前缀的产品名称，用于标记通过应用程序发送到Finteza的事件。

 

如果您有PC、iOS、Android等应用程序，您可能需要在不同的平台上分隔事件。例如，如果您指定了"Android App"产品并发送“Registration（注册）”事件，那么Finteza中的最终事件名称将为"Android App Registration"。

 

设置 null以避免使用前缀。

应用程序启动事件 #

将以下代码添加到Activity.onCreate：

Finteza.activate()

当在第一个应用程序启动调用activate（激活）时，SDK将“安装完成”事件发送至Finteza（如果指定了产品前缀，则发送"{PRODUCT}安装完成"）。

此外，当调用activate（激活）时，会启动一个新的工作会话并注册“Session Start（启动会话）”事件（如果设置了产品前缀，则“{PRODUCT} 启动会话”）。

如果用户离开应用程序，那么当前会话结束。下一次启动/激活应用程序时，将开始一个新会话。

调试消息 #

若要测试SDK操作，您可以将调试信息输出到开发人员控制板，并根据消息类型进行过滤：

仅事件

Finteza.addLogging(LogUtil.LogLevel.EVENTS);

完整日志记录

Finteza.addLogging(LogUtil.LogLevel.ALL);

仅错误

Finteza.addLogging(LogUtil.LogLevel.ERROR);

要禁用调试信息，请调用：

Finteza.addLogging(LogUtil.LogLevel.NONE);

例如

以下调试信息表示，由于缺少调用activate（激活）方法而导致的事件发生错误：

[event] 无法发送事件'Book Load'：首先调用'activate'方法
← 
 →