集成安装和初始化

安装和初始化

Finteza SDK操作需要Android 4.0.3 (API Level 15)或以上版本以及com.android.installreferrer:installreferrer程序库。SDK可以使用Gradle安装或通过在https://bintray.com/finteza/maven/finteza-sdk下载安装包手动安装。

通过Gradle安装#

若要连接Finteza SDK,请将以下从属添加到您项目的build.gradle文件的从属部分:

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

手动安装#

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

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

<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:1.0'
}

在应用程序中安装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'方法