将 Google Analytics（分析）添加到 iOS 应用中

本指南介绍了如何将 Google Analytics（分析）添加到您的 iOS 应用以衡量用户在已命名屏幕上的活动。如果您目前没有应用，而是仅仅想了解一下 Google Analytics（分析）的工作原理，请参阅我们的示例应用。

Google Analytics（分析）使用 CocoaPods 来安装和管理依赖关系。打开终端窗口，然后导航至您应用的 Xcode 项目所在的位置。如果您还没有为应用创建 Podfile，请立即创建一个：

pod init

打开为应用创建的 Podfile，然后添加以下内容：

pod 'Google/Analytics'

保存文件并运行：

pod install

这将为您的应用创建一个 .xcworkspace 文件。该文件可用于与您的应用相关的所有未来开发工作。

获取配置文件

点击下面的按钮即可获取配置文件以将其添加到您的项目中。

该配置文件提供了您的应用的服务专用信息。要获取该文件，您必须为您的应用选择一个现有项目或新建一个项目。此外，您还需要为应用提供一个集合 ID。

Get a Configuration File

将配置文件添加到项目中

将您刚刚下载的 GoogleService-Info.plist 文件拖动到您的 Xcode 项目的根目录并将其添加到所有目标中。

针对应用初始化 Google Analytics（分析）

现在，为您的项目获取配置文件后，您就可以开始实现自己的方案了。首先，在 AppDelegate 中配置共享的 Google Analytics（分析）对象。这样，您的应用就可以将数据发送到 Google Analytics（分析）了。您需要执行以下操作：

  • 添加必要的标头。
  • 在 didFinishLaunchingWithOptions 内设置 Google Analytics（分析）跟踪器。
  • 发送异常和日志信息（可选）。

要进行上述更改，先在 AppDelegate 内添加 Google Analytics（分析）：

#import <Google/Analytics.h>

然后，替换 didFinishLaunchingWithOptions 方法以配置 GGLContext：

// Configure tracker from GoogleService-Info.plist.
NSError *configureError;
[[GGLContext sharedInstance] configureWithError:&configureError];
NSAssert(!configureError, @"Error configuring Google services: %@", configureError);

// Optional: configure GAI options.
GAI *gai = [GAI sharedInstance];
gai.trackUncaughtExceptions = YES;  // report uncaught exceptions
gai.logger.logLevel = kGAILogLevelVerbose;  // remove before app release
AppDelegate.m

添加屏幕跟踪

此时，每当用户打开或切换您应用上的屏幕时，您都会向 Google Analytics（分析）发送一次已命名的屏幕浏览。打开您要跟踪的“数据视图控制器”，或者如果该应用是一个新应用，请打开默认的数据视图控制器。您的代码应能够：

  • 添加所需的 <Google/Analytics.h> 标头。
  • 使用 viewWillAppear 方法或函数替换值来插入屏幕跟踪。
  • 为屏幕提供名称并执行跟踪。
id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];
[tracker set:kGAIScreenName value:name];
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];
ViewController.m

后续步骤

  • 阅读移动应用实现指南，了解如何使用 Google Analytics（分析）衡量用户互动以及有关应用使用情况的问题解答。
  • 查看更多配置选项，如抽样、测试和调试以及选择停用设置等等。
  • 如果您的应用需要，可启用可选功能，如增强型电子商务、广告客户标识符 (IDFA) 和 iAd 安装广告系列衡量功能。