集成安装和初始化

安装和初始化

若要安装Finteza SDK,请使用CocoaPodsCarthage程序包管理或从GitHub手动下载文件库。

通过CocoaPods安装#

若要连接Finteza SDK,请将以下字符串添加到您项目的Podfile中:

pod 'FintezaSDK'

然后,执行安装命令:

pod install

使用CocoaPods时,请始终使用.xcworkspace文件来代替.xcodeproj


通过Carthage安装#

若要连接Finteza SDK,请将以下字符串添加到您项目的Cartfile中:

github "finteza/mobile-sdk-ios"

手动安装#

下载并解压缩FintezaSDK-X.X.X.framework.zip文件。接下来,将FintezaSDK.framework转移到Xcode项目中。

在安装期间,启用“如有需要复制项目”选项。

安装适用于iOS的Finteza SDK

在应用程序中初始化SDK#

打开应用程序委托文件并导入Finteza SDK:

Objective-C:

#import <FintezaSDK/FintezaSDK.h>

Swift:

import FintezaSDK

didFinishLaunchingWithOptions方法中通过网站ID和地址初始化SDK:

Objective-C:

[Finteza initialize:@"{WEBSITE_ID}" site:@"{WEBSITE_URL}" product:@"{PRODUCT}"];

Swift:

Finteza.initialize("{WEBSITE_ID}", site: "{WEBSITE_URL}", product: "{PRODUCT}")

将网站ID设置为{WEBSITE_ID}。这可以在Finteza面板的网站设置(ID字段)中获得。接下来,设置参数:

参数

类型

描述

网站

字符串

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

产品

字符串

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

 

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

 

设置'nil'以避免使用前缀。

 

稍后,您可以使用setProduct函数更改产品名称:

 

Objective-C:

 

[Finteza setProduct:@"{PRODUCT}"];

 

Swift:

 

Finteza.setProduct("{PRODUCT}")

应用程序启动事件#

将以下代码添加到applicationDidBecomeActive

Objective-C:

[Finteza activate];

Swift:

Finteza.activate()

当调用activate(激活)时,SDK在应用程序第一次启动时将“安装完成”事件发送至Finteza(如果设置了产品前缀,则"{PRODUCT}安装完成")。

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

只有在距离上次应用程序变为非活动状态超过三分钟之后,新会话才会开始。


调试消息#

为了测试使用SDK的情况,您可以将调试数据输出到开发人员的控制台。单独显示有关事件的数据和显示的广告

事件

Objective-C:

[Finteza addLogging:FintezaLogModeEvents];

Swift:

Finteza.addLogging(FintezaLogModeEvents)

广告

Objective-C:

[Finteza addLogging:FintezaLogModeBanner];

Swift:

Finteza.addLogging(FintezaLogModeBanner)

例如

以下调试信息表示,由于缺少调用activate(激活)方法而导致的事件发生错误:

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