Huq Industries | SourceKit for iOS
Huq Industries 实际世界的移动应用分析揭示用户在哪里购物、工作、旅行和放松。今天集成 SourceKit，深入了解您的受众行为。加入我们的合作伙伴计划，以新的方式货币化您的移动应用。
- 了解您的用户何时以及如何购物、工作和放松
- 使用 Huq 的分析工具构建和管理见解
- 使用 Huq 驱动活动和个性化内容
要开始使用 Huq 的 SourceKit，您首先需要在Huq Industries 物理分析控制台注册并获取 API 密钥，然后按照以下简单步骤操作。
选择使用哪个版本
SourceKit 有两个版本 - SourceKit 和 SourceKitLight。Huq 允许广告商执行归因，为此目的，主版本 SDK 使用 IDFA。使用此功能需要在下面的“提交”部分中提交您的应用程序时予以确认。SourceKit 允许限制额外的跟踪选项。如果您希望我们不收集 IDFA，则应使用 SourceKitLight 版本。在这种情况下，唯一需要更改的代码是 Cocoapods 包含和库导入，一旦导入，使用该库与版本无关。
使用 Cocoapods 安装
将以下行添加到您的 Podspec 并运行 pod install
pod 'SourceKit' 或 pod 'SourceKitLight'
初始化
Swift
SourceKit 是一个 Objective-C 框架，因此如果您的项目还没有桥接头文件，您需要创建一个。如果您不知道如何操作，请按照以下步骤进行
-
将新文件添加到您的项目（文件 > 新 > 文件），选择“源”下的“头文件”。将您的文件命名为“ProjectName-Bridging-Header.h"
-
将桥接头文件添加到 Swift 编译器中。选择您的项目的编译设置标签，然后搜索“Swift Compiler”。在“Swift Compiler - Code Generation”部分下的“Objective-C Bridging Header”字段中添加您桥接头的路径。检查头文件位置，以确保您正确输入路径。如果是根目录，路径将简单为“ProjectName-Bridging-Header.h”。如果是项目子目录，路径将为“ProjectName/ProjectName-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>”];就完成了！检查您是否正确启用了 位置服务，并请在下方查看高级实现的更多信息。
使用位置服务
为了使 Huq SDK 高效运行，您的应用程序必须使用后台位置服务。
请按照Apple 的说明来实施位置服务。
测试
SourceKit从Huq中使用了在模拟器中不可用的API。请在连接到WiFi的情况下在您的设备上测试。
Swift
// 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])Objective-C
#import <SourceKit/SourceKit.h> 或 #import <SourceKitLight/SourceKitLight.h>
// 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]];注意：自定义事件仅实现一次，并在向Huq Industries提交每个事件请求后重置。
最终用户退出
Huq非常重视隐私，虽然SourceKit收集的数据是匿名的，但Huq确实提供给您停止收集用户数据的手段，例如，当用户选择退出功能时。
Swift
HISourceKit.sharedKit().stopRecording()Objective-C
#import <SourceKit/SourceKit.h> 或 #import <SourceKitLight/SourceKitLight.h>
[[HISourceKit sharedKit] stopRecording];调用stopRecording将停止SourceKit提交任何数据更新。如果您想在任何时候重新启动SourceKit，只需像第一次一样再次调用recordWithAPIKey:即可。
应用程序提交
向App Store提交应用程序时，如果您使用了SDK的SourceKit版本，应选中“是”以确认“此应用程序使用广告标识符（IDFA）？”并选择“将此应用程序安装归因于之前发布的广告”选项。
附加支持
Huq Insights至少每24小时刷新一次。如果您在登录Insights仪表板24小时后仍然看不到任何数据，请检查以下情况
- 您是否在设备上进行测试
- 您是否已启用位置服务
- 您是否在WiFi状态下进行测试
为了更频繁地生成洞察事件，在Xcode中导航到Debug > 模拟位置 > 选择不同的城市或添加GPX文件来模拟移动。
如果您有任何其他问题，请通过[email protected]联系我们。
许可
本SourceKit SDK版权所有2014-2017 Huq Industries Limited。此SDK根据Huq物理洞察平台服务条款进行许可，可在Huq Industries网站上找到此处（“许可证”）。除非（1）您已在Huq注册了账户，（2）拥有有效的Huq API密钥，（3）已同意许可证条款，并且（4）符合许可证规定，否则您不得使用此SDK。任何未经授权使用此SDK的行为构成版权侵权和违法行为。