在这里,我将向您展示如何将 Analytics 添加到您的 iOS 应用中,以衡量用户对命名屏幕的活动。如果您还没有应用程序并且只想了解 Analytics 的工作原理,请查看我们的示例应用程序。
注意:从 Google Analytics for iOS SDK 3.16 版开始,需要 Xcode 7.3 或更高版本。
Objective-C Swift
Analytics 使用 CocoaPods 来安装和管理依赖项。打开一个终端窗口并导航到您的应用程序的 Xcode 项目的位置。如果您尚未为您的应用程序创建 Podfile,请立即创建一个:
pod 初始化
打开为您的应用程序创建的 Podfile 并添加以下内容:
pod '谷歌/分析'
保存文件并运行:
吊舱安装
这将为您的应用程序创建一个 .xcworkspace 文件。将此文件用于您的应用程序的所有未来开发。
获取配置文件
单击下面的按钮获取配置文件以添加到您的项目中。
配置文件为您的应用提供特定于服务的信息。要获得它,您必须为您的应用选择一个现有项目或创建一个新项目。您还需要为您的应用提供捆绑 ID。
GET A CONFIGURATION FILE
将配置文件添加到您的项目中
将您刚刚下载的 GoogleService-Info.plist 文件拖到 Xcode 项目的根目录中,并将其添加到所有目标中。
为您的应用初始化分析
现在您已经有了项目的配置文件,可以开始实施了。首先,在 AppDelegate 中配置共享 Analytics 对象。这使您的应用可以将数据发送到 Analytics。您将执行以下操作:
包括必要的标题。
在 didFinishLaunchingWithOptions 中设置 Analytics 跟踪器。
发送异常和日志信息(可选)。
要进行这些更改,首先要确保您的 Swift 项目具有 BridgingHeader。然后,在这个桥接头中,添加 Analytics:
#import <Google/Analytics.h>
最后,重写 didFinishLaunchingWithOptions 方法来配置 GGLContext:
// Configure tracker from GoogleService-Info.plist.
var configureError:NSError?
GGLContext.sharedInstance().configureWithError(&configureError)
assert(configureError == nil, "Error configuring Google services: \(configureError)")
// Optional: configure GAI options.
let gai = GAI.sharedInstance()
gai.trackUncaughtExceptions = true // report uncaught exceptions
gai.logger.logLevel = GAILogLevel.Verbose // remove before app release
AppDelegate.swift
添加屏幕跟踪
每当用户在您的应用上打开或更改屏幕时,您都会在此处向 Google Analytics(分析)发送一个命名的屏幕视图。打开您要跟踪的视图控制器,或者如果这是一个新应用程序,请打开默认视图控制器。您的代码应执行以下操作:
添加所需的标头 <Google/Analytics.h>
使用 viewWillAppear 方法或函数覆盖来插入屏幕跟踪。
提供屏幕名称并执行跟踪。
let tracker = GAI.sharedInstance().defaultTracker
tracker.set(kGAIScreenName, value: name)
let builder = GAIDictionaryBuilder.createScreenView()
tracker.send(builder.build() as [NSObject : AnyObject])
ViewController.swift
注意:您可以将跟踪代码添加到每个代表屏幕的UIViewController,无论是命令式(通过代码)还是通过情节提要向您的用户显示。如果您想在 Analytics 中区分应用的屏幕视图,请在每个 UIViewController 中设置一个名称。共享跟踪器上记录的所有活动都会发送最新的屏幕名称,直到被替换或清除(设置为 nil)。
ViewController.swift