跟踪代码管理器 + Firebase：使用入门

简介

通过使用 Google 跟踪代码管理器界面，开发者可在其移动应用中实现和管理各种衡量代码与像素，无需重新生成应用二进制文件并将其重新提交到应用市场。对于使用 Firebase Analytics 的开发者而言，则可以轻松添加 Google 跟踪代码管理器，以便管理和更改相关的实现，即使在应用发布之后亦是如此。

开发者可以记录重要事件，然后决定应触发哪些跟踪代码或像素。跟踪代码管理器目前支持以下产品的代码：

  • Firebase Analytics
  • Google Analytics（分析）
  • Floodlight
  • Google Ads
  • Adjust
  • AppsFlyer
  • Apsalar
  • Kochava
  • Tune
  • Custom Function Calls（适用于其他产品）

前提条件

开始之前：

以下部分逐步介绍了在 iOS 应用中配置和使用 Google 跟踪代码管理器的步骤。

开始使用

  1. 将 Google 跟踪代码管理器添加到您的项目中。
  2. 记录事件和变量。
  3. 触发代码。
  4. 预览、调试和发布您的容器。

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

  1. 将 Google 跟踪代码管理器 Cocoapod 添加到您的项目中：
    1. 在终端运行以下命令以安装 Cocoapods：
      $ sudo gem install cocoapods
    2. 更改为您的项目目录。
    3. 运行以下命令，创建名为 Podfile 的文件：
      $ pod init
    4. 在 Podfile 中添加以下内容：
      pod 'GoogleTagManager', '~> 6.0'
    5. 运行以下命令，以下载 Google 跟踪代码管理器依赖项并将其安装到您的项目中：
      $ pod install
  2. 如果您的 Google 跟踪代码管理器帐号没有 iOS 容器，请创建一个：
    1. 登录您的 Google 跟踪代码管理器帐号。
    2. 点击顶部导航栏中的管理。
    3. 在容器列上，点击下拉菜单，然后选择创建容器。
    4. 输入容器名称。
    5. 选择 iOS 容器。
    6. 选择 Firebase（iOS 版）SDK。
    7. 点击创建。
  3. 下载容器：
    1. 登录您的 Google 跟踪代码管理器帐号。
    2. 选择您的 iOS 容器。
    3. 点击顶部导航栏中的版本。
    4. 针对所选容器版本，依次点击操作 > 下载。
      已下载文件的名称由容器 ID 及 .json 扩展名构成。
  4. 将下载的容器添加到您的项目中：
    1. 将下载的文件复制到 Xcode 项目根目录下名为 container 的文件夹中（通常为 PROJECT_ROOT/container/GTM-XXXXXX.json）。
    2. 打开 Xcode。
    3. 从文件菜单中选择将文件添加到...
    4. 选择 container 文件夹。
    5. 点击选项并确保已选中创建文件夹参考。
    6. 点击完成。

2. 记录事件和变量

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

有关如何记录事件和设置用户属性的说明，请参阅 Firebase Analytics 开发者文档。

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

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

例如，如果您要在应用中记录以下自定义事件：

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

则可以在 Google 跟踪代码管理器中配置新事件参数变量来捕获 image_name 和 full_text parameter 值：

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

和：

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

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

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

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

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

修改和屏蔽 Firebase Analytics 事件

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

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

3. 触发代码

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

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

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

预览容器

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

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

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

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

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

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

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

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

调试容器

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

发布容器

预览容器并确定它可以正常工作之后，您可以发布您的容器。发布容器后，移动应用用户将可以使用您的代码配置。

下一步

阅读高级配置。