PWAnalytics 1.3.1

PWAnalytics 1.3.1

测试已测试
语言语言 Obj-CObjective C
许可证 自定义
发布最后发布2016年10月

Illya BusiginIllya BusiginSam OdomXiangwei WangSteven Spry维护。



Phunware iOS分析SDK

版本 1.3.1

这是Phunware为分析模块提供的iOS SDK。请访问http://maas.phunware.com/获取更多信息并注册。

要求

  • PWCore v3.0.2或更高版本
  • iOS 7.0或更高版本
  • Xcode 6或更高版本

入门

  • 下载PWAnalytics并运行包含的示例应用。
  • 下面继续阅读安装和集成说明。
  • 务必阅读文档以获取更详细的信息。

安装

以下框架是必需的

PWCore.framework

PWAnalytics依赖于可在此处找到的PWCore.framework:https://github.com/phunware/maas-core-ios-sdk

建议您将MaaS框架添加到'Vendor/Phunware'目录。此目录应包含PWCore.framework和PWAnalytics.framework,以及您使用的任何其他MaaS框架。

文档

文档包含在存储库的文档文件夹中,包含HTML格式和.docset格式。您也可以在此处找到最新文档:http://phunware.github.io/maas-analytics-ios-sdk/

集成

您需要在想要添加分析事件的地方导入PWAnalytics.framework。您可能想将它包含在Prefix.pch中。

#import <PWAnalytics/PWAnalytics.h>

在您的应用代理中,在application:didFinishLaunchingWithOptions:方法中初始化PWCore。有关更详细的PWCore安装说明,请参阅:https://github.com/phunware/maas-core-ios-sdk#installation

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    // These values can be found for your application in the MaaS portal:
    [PWCore setApplicationID:@"APPLICATION_ID"
                   setAccessKey:@"ACCESS_KEY"
                  signatureKey:@"SIGNATURE_KEY"
                 encryptionKey:@"ENCRYPT_KEY"]; // Currently unused. You can place any NSString value here.
    ...
}

添加事件

要使用PWAnalytics添加事件

- (void)viewWillAppear:(BOOL)animated
{
    [super viewWillAppear:animated];

    [PWAnalytics addEvent:@"Featured Page View"];
    ...
}

时间事件

PWAnalytics支持时间分析

- (void)startLevel:(PWGameLevel *)level
{   
    // Start a timed event like so:
    [PWAnalytics startTimedEvent:@"My Awesome Game - Level 1"];
    ...
}

- (void)endLevel:(PWGameLevel *)level
{   
    // And end a timed event like so:
    [PWAnalytics endTimedEvent:@"My Awesome Game - Level 1"];
    ...
}

事件参数

PWAnalytics 允许您将最多10个键/值对应用于所有事件。所有参数键和值必须是字母数字字符串。

- (void)viewWillAppear:(BOOL)animated
{
    [super viewWillAppear:animated];

    [PWAnalytics addEvent:@"Featured Page View" withParamaters:@{@"gender" : @"male"}];

    [PWAnalytics addEvent:@"My Awesome Game - Level 1" withParameters:@{@"difficulty" : @"easy"}];

    // Keep in mind that calling endTimedEvent:withParameters will replace any parameters that you specified in startTimedEvent:withParameters.
    [PWAnalytics endTimedEvent:@"My Awesome Game - Level 1" withParameters:@{@"difficulty" : @"easy", @"attempts" : @"5"}];
    ...
}