将 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

添加屏幕跟踪

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

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

后续步骤

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