安装和初始化

若要安装Finteza SDK，请使用CocoaPods或Carthage程序包管理或从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项目中。

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

在应用程序中初始化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'方法