跟踪代码管理器 + 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_namefull_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:将跟踪代码管理器预览网址架构添加到您应用的属性列表文件。

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

调试容器

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

发布容器

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

下一步

阅读高级配置