iOS版Google Analytics（分析）SDK v3 - 使用入门

本文档将介绍如何开始使用iOS版Google Analytics（分析）SDK v3。

是从v1或v2迁移到新版本？请阅读 迁移指南，了解如何开始使用v3。

开始之前

在实现SDK之前，请确保您已经有：

• iOS Developer SDK 5.0或更高版本
• 适用于移动应用的Google Analytics（分析）iOS版SDK v3
• 您要使用Google Analytics（分析）衡量的iOS应用
• 至少一个Google Analytics（分析）媒体资源和应用数据视图（配置文件），以便从应用中向其发送数据。

使用入门

开始使用SDK有三个步骤：

1. 向您的项目添加头文件和库
2. 初始化跟踪器
3. 添加屏幕衡量

完成上述步骤后，您将可以使用Google Analytics（分析）衡量以下内容：

• 应用安装
• 活跃用户和受众特征
• 屏幕和用户互动度
• 崩溃和异常

1. 添加头文件并配置您的项目

下载iOS版Google Analytics（分析）SDK，并将SDK文件包中的下列文件添加到您的应用中：

• GAI.h
• GAITracker.h
• GAITrackedViewController.h
• GAIDictionaryBuilder.h
• GAIFields.h
• GAILogger.h
• libGoogleAnalyticsServices.a

Google Analytics（分析）SDK使用CoreData和SystemConfiguration框架，因此您需要将下列库添加到您的应用目标的链接库中：

• libGoogleAnalyticsServices.a
• AdSupport.framework
• CoreData.framework
• SystemConfiguration.framework
• libz.dylib

如果您的应用使用CoreData框架：从Google Analytics（分析） CoreData对象回应通知（例如 NSManagedObjectContextDidSaveNotification）可能会导致异常。Apple建议指定被管理对象上下文(Managed Object Context)为监听器的参数，以此来过滤CoreData通知。 从Apple了解详情。

2. 初始化跟踪器

要初始化跟踪器，请在您的应用委托.m文件中导入GAI.h头文件，并将此代码添加到您应用委托的application:didFinishLaunchingWithOptions:方法：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Optional: automatically send uncaught exceptions to Google Analytics.
  [GAI sharedInstance].trackUncaughtExceptions = YES;

  // Optional: set Google Analytics dispatch interval to e.g. 20 seconds.
  [GAI sharedInstance].dispatchInterval = 20;

  // Optional: set Logger to VERBOSE for debug information.
  [[[GAI sharedInstance] logger] setLogLevel:kGAILogLevelVerbose];

  // Initialize tracker. Replace with your tracking ID.
  [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Y"];

}

请注意：当您获取某个跟踪ID的跟踪器时，该跟踪器实例将在库中存续。当您之后使用同一跟踪ID调用 trackerWithTrackingId:时，将会返回同一个跟踪器实例。另外，Google Analytics（分析）SDK会暴露一个默认跟踪器实例，该实例会设置为创建的首个跟踪器实例。您可以使用以下代码来访问此实例：

id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

请注意，上例中的"UA-XXXX-Y"只是一个占位符，应当替换为在您创建Google Analytics（分析）媒体资源时分配给您的跟踪ID。如果您在应用中只使用一个媒体资源ID，则使用默认跟踪器是最佳方法。

3. 实现自动屏幕衡量

要自动衡量您的应用中的屏幕浏览，请使用您的视图控制器来对GAITrackedViewController进行扩展(extend)。设置一个名为screenName的属性，将其值设为您想要在报告中使用的屏幕名称。

例如，假设您要使用视图控制器标头来衡量“主屏幕”的浏览情况，该标头如下所示：

@interface HomeViewController : UIViewController

您需要将此标头更新为：

#import "GAITrackedViewController.h"

@interface HomeViewController : GAITrackedViewController

您必须同时提供要在您的Google Analytics（分析）报告中使用的视图名称。提供此名称的理想位置是视图控制器的初始化方法（如果有），或是viewWillAppear:方法：

- (void)viewWillAppear:(BOOL)animated {
  [super viewWillAppear:animated];
  self.screenName = @"About Screen";
}

要详细了解屏幕衡量，请参阅屏幕开发者指南。

恭喜！您的应用已设置完毕，可以向Google Analytics（分析）发送数据了。

后续步骤

您还可以将Google Analytics（分析）用于其他众多用途，包括衡量广告系列、应用内付款和交易，以及用户互动事件。请参阅以下开发者指南，了解如何在您的实现方案中添加这些功能：

• 高级配置 – 详细了解高级配置选项，包括如何使用多个跟踪器。
• 衡量广告系列 – 了解如何实现广告系列衡量功能，以了解是哪些渠道和广告系列推高了应用安装量。
• 衡量事件 – 了解如何使用事件来衡量用户与互动式内容（例如按钮、视频或其他媒体）的互动度。
• 衡量应用内付款 – 了解如何衡量应用内付款和交易。
• 用户计时 – 了解如何在应用中衡量用户计时，以此衡量内容加载时间、媒体互动时间等指标。