SourceKitAds 1.1.8
- 由
- Huq Industries制作
Huq Industries | iOS SourceKit
Huq Industries的移动应用程序实时分析揭示您的用户在哪里购物和工作，旅行和放松。今天集成SourceKit，以深入了解您的受众行为。加入我们的合作伙伴计划，以新方式货币化您的移动应用程序。
- 了解您的用户何时何地购物，工作，休息
- 使用Huq的 analysistools构建和管理洞察力
- 使用Huq推动活动并个性化内容
要开始使用华科HSourcetKit，您首先需要在Huq Industries的物理分析控制台注册并获取一个API密钥，然后按照以下简单步骤操作。
要使用哪个版本
SourceKit有两个版本 - SourceKit和SourceKitLight。华科赋权广告商进行归因，为此目的，SourceKit SDK的主版本使用IDFA。使用此属性时，您将在下面所示的“提交”部分中承认它。SourceKit启用了限制添加跟踪选项。如果您希望我们不收集IDFA，则应使用SourceKitLight版本。在这种情况下，唯一需要更改的代码是Cocoapods包含和库导入，导入后库的版本是独立的。
初始化
Swift
SourceKit是一个Objective-C框架，因此如果您还没有桥接头，则需要创建一个。如果您不知道如何做，请按照以下步骤操作
-
在您的项目中添加一个新文件（文件 > 新 > 文件），选择“源”然后选择“头文件”。将您的文件命名为“ProjectName-Bridging-Header.h"
-
将桥接头添加到您的Swift编译器中。选择项目构建设置选项卡，然后搜索“Swift编译器”。在“Swift编译器 - 代码生成”部分下，将桥接头的路径添加到“Objective-C桥接头”字段中。检查头文件的位置，确保您得到了正确的路径。如果是根目录，则路径简单为“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 Industries 的 SourceKit SDK 充分利用位置服务来生成实体洞察。对于 iOS 8 之前的版本，调用
[[HISourceKit sharedKit] recordWithAPIKey:@“<API_Key>”];将自动请求必要的位置权限。如果你希望该请求在应用程序流程的稍后阶段进行，那么只需在那个时间点调用此方法。
从 iOS 8 开始，这变得更加复杂。因此，以下是 iOS 8+ 中配置位置服务的步骤：
在 iOS 8+ 中使用位置服务
要使用位置服务，首先需要配置你的项目的 Info.plist。
- 右键单击 plist 检查器，然后选择添加行
- 在键字段中，添加你所需的模式的键
- 说明你的应用为何使用位置服务
仅前台应用
对于仅在前台访问位置服务的应用，将键 NSLocationWhenInUseUsageDescription 添加到你的 Info.plist。然后在你的类中，如常导入 CoreLocation，按照你的意愿配置 CLLocationManager，并记住当你准备就绪时调用 requestWhenInUseAuthorization。
前台和后台应用
对于也需在后更新访问位置服务的应用，将键 NSLocationAlwaysUsageDescription 添加到你的 Info.plist。然后在你的类中，如常导入 CoreLocation，按照你的意愿配置 CLLocationManager，并记住当你准备就绪时调用 requestAlwaysAuthorization。
测试
Huq 的 SourceKit 使用了模拟器中不可用的 API。在连接到 Wi-Fi 的状态下，在你的设备上进行测试。
高级使用
您可以通过添加 自定义事件、任意标签来覆盖 Huq Industries 的实体洞察事件，这些标签用于描述用户在您的应用中正在做什么。例如，您可能想了解大多数用户在 在家、在工作或在任何其他地方 时在应用中执行某种特定操作。以下示例显示了如何使用您自己的自定义事件标签与 Huq 的洞察事件叠加，以表明用户在那时在应用中做了什么。记录的事件标签将与提交给 Huq Industries 的下一个事件一起记录。
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()