Huq Industries | iOS 的 SourceKit

Huq Industries 为移动应用程序提供现实世界分析，揭示用户在哪里购物和工作，旅行和放松。今天集成 SourceKit，以了解您受众的新见解。加入我们的合作伙伴计划，以新的方式货币化您的移动应用程序。

• 了解用户何时何地进行购物，工作和放松
• 使用 Huq 的分析工具构建和管理洞察力
• 使用 Huq 实施活动并个性化内容

要开始使用 Huq 的 SourceKit，您首先需要注册并在 Huq Industries Physical Analytics 控制台中获取 API 密钥，然后按照以下简单步骤进行。

选择版本

SourceKit 有两个版本：SourceKit 和 SourceKitLight。Huq 允许广告商进行归因分析，为了执行此操作，SDK 的主要版本 SourceKit 使用 IDFA。使用该属性时，您需要在提交应用程序时确认（如下面的“提交”部分所示）。SourceKit 启用限制附加跟踪选项。如果您希望我们不收集 IDFA，则应使用 SourceKitLight 版本。在这种情况下，唯一需要更改的代码是 Cocoapods 包含和库导入，一旦导入，库的使用就独立于版本。

初始化

Swift

SourceKit 是一个 Objective-C 框架，因此如果您还没有桥接头，您需要创建一个。如果您不知道如何创建它，请按照以下步骤操作

1. 添加项目中的一个新文件（文件 > 新 > 文件），选择“源”然后“头文件”。将文件命名为“项目名称-Bridging-Header.h”

2. 将桥接头添加到 Swift 编译器中。选择您项目的构建设置标签，然后在“Swift 编译器”部分查找。在“Swift 编译器 - 代码生成”部分下，将桥接头的路径添加到“Objective-C 桥接头”字段。检查头文件的位置以确保您获取正确的路径。如果是根目录中的，则路径将是“项目名称-Bridging-Header.h”。如果是项目子目录中的，则路径将是“项目名称/项目名称-Bridging-Header.h”。

您应该通过添加以下行将 SourceKit 库导入到桥接头文件中：

SourceKit

#import <SourceKit/HISourceKit.h> 或 #import <SourceKitLight/HISourceKit.h>

在您的 AppDelegate 中，向 func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool 方法中添加以下行：

// replace <API_Key> with the API key that you have received from Huq
HISourceKit.sharedKit().recordWithAPIKey("<API_Key>")

Objective-C

在您的 AppDelegate.m 文件中，通过添加以下行导入 SourceKit 库：

#import <SourceKit/SourceKit.h> 或 #import <SourceKitLight/SourceKitLight.h>

然后在您的 AppDelegate 的 -application:didFinishLaunching:withOptions: 方法中，只需添加以下内容

// replace <API_Key> with the API key that you have received from Huq
[[HISourceKit sharedKit] recordWithAPIKey:@“<API_Key>”];

这就是全部！ 请确保您已正确启用 位置服务，并查看以下部分以获取高级实现的使用信息。

使用位置服务

胡克工业的 SourceKit SDK 除了其他功能外，还使用位置服务来生成物理洞察。对于 iOS 8 之前的版本，调用

[[HISourceKit sharedKit] recordWithAPIKey:@“<API_Key>”];

将自动请求必要的位置权限。如果您希望在该应用程序流程的较后阶段请求此权限，那么只需在此时调用此方法。

从 iOS 8 开始，这一点变得稍微复杂了一些，因此配置 iOS 8+ 中位置服务的步骤如下：

iOS 8+ 中的位置服务使用

为了使用位置服务，您需要首先配置项目 Info.plist 文件。

• 在 plist 检查器上单击鼠标右键，然后选择添加行
• 在键字段中，添加所需模式的键
• 说明为什么您的应用使用位置服务

仅前台应用程序

对于仅在前台访问位置服务的应用程序，向 Info.plist 中添加键 NSLocationWhenInUseUsageDescription。然后，在您的类中，按常规导入 CoreLocation，按您希望配置 CLLocationManager，并记住在就绪时调用 requestWhenInUseAuthorization。

前台和后台应用程序

对于还访问后台位置服务的应用程序，向 Info.plist 中添加键 NSLocationAlwaysUsageDescription。然后，在您的类中按常规导入 CoreLocation，按您希望配置 CLLocationManager，并记住在就绪时调用 requestAlwaysAuthorization。

测试

胡克工业的 SourceKit 使用了模拟器中不可用的 API。请在连接到 Wi-Fi 的条件下，在您的设备上测试。

高级使用

您可以通过添加 自定义事件（任意标签，用于描述用户在您的应用程序中正在做什么）来将胡克工业的物理洞察事件与您自己的事件重叠。例如，您可能会对以下信息感兴趣：大多数用户在 '在家、'在工作、'或 whatever ' 之下执行某些操作。以下示例展示了如何通过添加自定义事件标签层叠胡克的洞察事件，以指示用户在那个时间在你的应用程序中做了什么。您记录的事件标签将与下一个提交给胡克工业的事件一起记录。

// Create a String that describes a user action
let userDoingSomething : String = "User doing something"

// Create and log an array of tags, you can submit as many as you like
HISourceKit.sharedKit().logCustomEventWithTags([userDoingSomething])

// Create a String that describes a user action
static NSString *userDoingSomething = @"User doing something";

// Create and log an array of tags, you can submit as many as you like
[[HISourceKit sharedKit] logCustomEventWithTags:@[userDoingSomething]];

HISourceKit.sharedKit().stopRecording()

[[HISourceKit sharedKit] stopRecording];