简介
通过使用 Google 跟踪代码管理器界面,开发者可在其移动应用中实现和管理各种衡量代码与像素,无需重新生成应用二进制文件并将其重新提交到应用市场。对于使用 Firebase Analytics 的开发者而言,则可以轻松添加 Google 跟踪代码管理器,以便管理和更改相关的实现,即使在应用发布之后亦是如此。
开发者可以记录重要事件,然后决定应触发哪些跟踪代码或像素。跟踪代码管理器目前支持以下产品的代码:
- Firebase Analytics
- Google Analytics(分析)
- Floodlight
- Google Ads
- adjust
- AppsFlyer
- Apsalar
- Kochava
- Tune
- Custom Function Calls(适用于其他产品)
前提条件
开始之前:
- 安装 Firebase SDK。
- 在 Firebase 控制台中,将您的应用添加到 Firecase 项目中。
- 将 Firebase Analytics 添加到您的应用中。
- 创建 Google 跟踪代码管理器帐号。
- 配置 Google 跟踪代码管理器容器。
下文详细介绍了在 Android 应用中配置和使用 Google 跟踪代码管理器的步骤。
开始使用
1. 将 Google 跟踪代码管理器添加到您的项目中
- 在您的模块 Gradle 文件(通常为
app/build.gradle
)中,添加以下跟踪代码管理器库依赖项:dependencies { // ... compile 'com.google.android.gms:play-services-tagmanager:11.0.4' }
- 登录您的 Google 跟踪代码管理器帐号。
- 选择一个移动容器。
- 点击顶部导航栏中的版本。
- 针对所选容器版本,依次点击操作 > 下载。
- 创建
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 跟踪代码管理器网页界面中选择您要预览的容器版本,然后选择预览,从而生成一个预览网址。保存此预览网址,以在后续步骤中使用。

要预览您的容器,请执行以下操作(如果您使用的是 Android Studio,请跳至第 3 步):
- 将以下预览活动添加到您的
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>
- 更改以下行,以添加您应用的软件包名称:
<data android:scheme="tagmanager.c.com.example.app"/>
- 在 Google 跟踪代码管理器网页界面中,生成预览链接:
- 登录您的 Google 跟踪代码管理器帐号。
- 选择一个移动容器。
- 点击顶部导航栏中的版本。
- 针对您要预览的容器版本,依次点击操作 > 预览。
- 输入您应用的软件包名称。
- 点击生成“开始预览”链接。
- 关闭您的应用,然后使用生成的预览链接或 QR 码启动它。
- 您可以点击网页界面中的生成“结束预览”链接选项生成的链接,从而退出预览模式。
调试容器
要对您的容器实现进行问题排查,请启用详细日志记录功能:
$ adb shell setprop log.tag.GoogleTagManager VERBOSE
发布容器
在预览容器并确定它可以正常工作后,您可以发布您的容器。发布容器后,移动应用用户将可以使用您的代码配置。
下一步
阅读高级配置。