Thanks for previewing Google's new tag platform documentation! This site is in public beta. (Feedback)

iOS 版 Google 跟踪代码管理器

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

通过使用跟踪代码管理器界面,开发者可在其移动应用中实现和管理各种衡量代码与像素,无需重新生成应用二进制文件并将其重新提交到应用市场。即使应用已发布,使用 Google Analytics for Firebase 的开发者也可以轻松添加跟踪代码管理器来管理和更改相关实现。

开发者可以记录重要事件,然后决定应触发哪些跟踪代码或像素。

前提条件

开始之前:

下文详细介绍了在 iOS 应用中配置和使用 Google 跟踪代码管理器的步骤。

1. 将跟踪代码管理器添加到您的项目中

  1. 添加跟踪代码管理器软件包:

    CocoaPods

    要通过 CocoaPods 添加跟踪代码管理器,请执行以下操作:

    1. 在终端运行以下命令:

      $ sudo gem install cocoapods
      
    2. 更改为您的项目目录。

    3. 运行以下命令以创建名为 Podfile 的文件:

      $ pod init
      
    4. Podfile 中添加以下代码:

      pod 'GoogleTagManager', '~> 6.0'
      
    5. 运行以下命令,将跟踪代码管理器依赖项下载并安装到您的项目中:

      $ pod install
      

    Swift Package Manager

    要通过 Swift Package Manager 添加跟踪代码管理器,请执行以下操作:

    1. 如果要从基于 CocoaPods 的项目迁移,请运行 pod deintegrate,从您的 Xcode 项目中移除 CocoaPods。之后可以安全地删除 CocoaPods 生成的 .xcworkspace 文件。如果您是第一次向项目添加 Firebase,可以忽略此步骤。
    2. 在 Xcode 12 中,依次转到 File > Tag Manager Packages > Add Package Dependency... 以安装跟踪代码管理器库
    3. 在出现的提示消息中,输入跟踪代码管理器 GitHub 代码库:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
      
    4. 选择您要使用的跟踪代码管理器版本。如果是新项目,建议您使用最新版跟踪代码管理器。

    5. -ObjC 添加到您的项目的 Build Settings 下的 Other Linker Flags 中。

  2. 如果您的跟踪代码管理器帐号没有 iOS 容器,请创建一个:

    1. 登录您的跟踪代码管理器帐号。
    2. 点击顶部导航栏中的管理
    3. 容器列上,点击下拉菜单,然后选择创建容器
    4. 输入容器名称。
    5. 选择 iOS 容器。
    6. 选择 Firebase(iOS 版)SDK。
    7. 点击创建
  3. 下载您的容器:

    1. 登录您的跟踪代码管理器帐号。
    2. 选择您的 iOS 容器。
    3. 点击顶部导航栏中的版本
    4. 针对所选容器版本,依次点击操作 > 下载

  4. 将下载的容器添加到您的项目中:

    1. 将下载的文件复制到 Xcode 项目根目录下名为 container 的文件夹中(通常为 PROJECT_ROOT/container/GTM-XXXXXX.json)。
    2. 打开 Xcode。
    3. 文件菜单中选择将文件添加到...
    4. 选择 container 文件夹。
    5. 点击选项并确保已选中创建文件夹参考
    6. 点击完成

2. 记录事件和变量

跟踪代码管理器使用 Google Analytics(分析)的事件、参数和用户属性来触发和构建您在跟踪代码管理器网页界面中配置的代码。从这个意义上讲,您的 Google Analytics(分析)实现发挥的是数据层的作用。

如需了解如何记录事件设置用户属性,请参阅开发者文档

在跟踪代码管理器中配置变量

要捕获 Firebase 事件参数和用户属性的值,以供在跟踪代码管理器中使用,您可以在跟踪代码管理器界面中配置变量

例如,如果您要记录在应用中发生的下列自定义事件:

Analytics.logEvent("share_image", parameters: [
  "image_name": name,
  "full_text": text
])

则可以在跟踪代码管理器中配置新事件参数变量来捕获 image_namefull_text parameter 值:

  • 变量名称:Image Name
  • 变量类型:事件参数
  • 事件参数键名称image_name

和:

  • 变量名称:Full Text
  • 变量类型:事件参数
  • 事件参数键名称full_text

同样,如果您要在应用中设置以下用户属性:

Analytics.setUserProperty(food, forName: "favorite_food")

则可以在跟踪代码管理器中配置新 Firebase 用户属性变量来捕获 favorite_food 值:

  • 变量名称:Favorite Food
  • 变量类型:Firebase 用户属性
  • 事件参数键名称favorite_food

修改和屏蔽 Google Analytics(分析)事件

借助跟踪代码管理器,您可在 Google Analytics(分析)中记录事件前对其进行修改和屏蔽。通过修改事件,您无需更新应用,即可添加、移除或更改事件参数的值,以及调整事件名称。未被屏蔽的事件会记录到 Google Analytics(分析)中。

此外,Google Analytics(分析)还会自动记录一些事件用户属性;您无需添加任何代码即可启用它们。这些自动收集的事件和属性可在跟踪代码管理器中使用,但无法被屏蔽。

3. 触发代码

您可以使用 Firebase 事件名称变量、Firebase 事件参数变量以及其他变量来设置触发器。无论您何时记录 Firebase 事件,都会对触发条件进行求值。默认情况下,Google Analytics(分析)事件会自动触发。您可以通过在跟踪代码管理器中添加 Google Analytics(分析)代码,阻止将事件发送到 Google Analytics(分析)。

4. 预览、调试和发布您的容器

在发布容器版本之前,您需要进行预览,以确保它可以按预期运行。通过跟踪代码管理器,您可以预览容器的各个版本,具体方法是:在跟踪代码管理器网页界面中生成相应链接和 QR 码,然后使用它们打开您的应用。

预览容器

要预览容器,请在跟踪代码管理器网页界面中生成预览网址:

  1. 登录您的跟踪代码管理器帐号。
  2. 选择一个移动容器。
  3. 点击顶部导航栏中的版本
  4. 针对您要预览的容器版本,依次点击操作 > 预览
  5. 输入您应用的软件包名称。
  6. 点击生成“开始预览”链接

    您可以在跟踪代码管理器网页界面的预览窗口中找到预览网址

    图 1:从跟踪代码管理器网页界面获取预览网址。

    保存此预览网址,以在后续步骤中使用。

要启用容器预览,您必须在项目的属性列表中设定跟踪代码管理器预览网址架构。在应用的属性列表文件的网址类型下,注册以下网址标识符和网址架构:

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
在您应用的属性列表文件中注册跟踪代码管理器预览网址架构。
图 2:将跟踪代码管理器预览网址架构添加到您应用的属性列表文件。

关闭您的应用,然后在模拟器或实体设备上打开预览网址,即可预览您应用中的草稿版本容器。

调试容器

当您在模拟器中或在预览模式下运行应用时,跟踪代码管理器会自动停用日志记录功能,改用详细日志记录功能。

发布容器

在预览您的容器并确定其可以正常运行后,便可以发布您的容器。发布容器后,移动应用用户将可以使用您的代码配置。

阅读高级配置