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

简介

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

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

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

注意：要成为代码供应商并希望 Google 添加贵公司的代码模板，请填写此表单。有关详情，请参阅 Google 跟踪代码管理器供应商代码模板计划。

前提条件

开始之前：

• 安装 Firebase SDK。
• 在 Firebase 控制台中，将您的应用添加到 Firecase 项目中。
• 将 Firebase Analytics 添加到您的应用中。
• 创建 Google 跟踪代码管理器帐号。
• 配置 Google 跟踪代码管理器容器。

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

开始使用

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

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

1. 在您的模块 Gradle 文件（通常为 app/build.gradle）中，添加以下跟踪代码管理器库依赖项：

   dependencies {
     // ...
     compile 'com.google.android.gms:play-services-tagmanager:11.0.4'
   }
   

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

   

6. 创建 app/src/main/assets/containers 文件夹（如果需要）。将已下载的容器复制到该文件夹。

2. 记录事件和变量

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

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

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

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

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

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

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

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

和：

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

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

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

则可以在 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 跟踪代码管理器，您可以预览容器的各个版本，具体方法是：在网页界面中生成相应链接和 QR 码，然后使用它们打开您的应用。此外，您还可以启用详细日志记录模式，以调试任何异常行为。

预览容器

在预览容器之前，请在 Google 跟踪代码管理器网页界面中选择您要预览的容器版本，然后选择预览，从而生成一个预览网址。保存此预览网址，以在后续步骤中使用。

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

要预览您的容器，请执行以下操作（如果您使用的是 Android Studio，请跳至第 3 步）：

1. 将以下预览活动添加到您的 AndroidManifest 文件中：

   <!--  Add preview activity. -->
   <activity
     android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
     android:noHistory="true">  <!-- optional, removes the previewActivity from the activity stack. -->
     <intent-filter>
       <data android:scheme="tagmanager.c.com.example.app" />
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE"/>
     </intent-filter>
   </activity>
   

2. 更改以下行，以添加您应用的软件包名称：

   <data android:scheme="tagmanager.c.com.example.app"/>
   

3. 在 Google 跟踪代码管理器网页界面中，生成预览链接：
   1. 登录您的 Google 跟踪代码管理器帐号。
   2. 选择一个移动容器。
   3. 点击顶部导航栏中的版本。
   4. 针对您要预览的容器版本，依次点击操作 > 预览。
   5. 输入您应用的软件包名称。
   6. 点击生成“开始预览”链接。
4. 关闭您的应用，然后使用生成的预览链接或 QR 码启动它。
5. 您可以点击网页界面中的生成“结束预览”链接选项生成的链接，从而退出预览模式。

调试容器

要对您的容器实现进行问题排查，请启用详细日志记录功能：

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

发布容器

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

注意：对于移动容器，在应用首次下载容器前，系统会使用一个默认容器来设置初始代码配置。一旦应用连接到互联网并下载了容器，就不会再使用默认容器了。通常，应用会每隔 12 小时检查一次容器的更新情况。

下一步

阅读高级配置。