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

时间：2022-02-25 15:16:45


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

是从v1或v2迁移到新版本？请阅读 迁移指南，了解如何开始使用v3。
  1. 开始之前
  1. 使用入门
    1. 1. 添加头文件和库
    2. 2. 初始化跟踪器
    3. 3. 实现屏幕衡量
  1. 后续步骤

开始之前

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

使用入门

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

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

相关文章