Android 版 Google 跟踪代码管理器

作为开发者,您可以使用 Google 跟踪代码管理器在移动应用中植入和管理各种衡量代码与像素,而无需重新生成应用二进制文件并将其重新提交到应用市场。使用 Google Analytics for Firebase SDK 的开发者可以轻松添加跟踪代码管理器来管理和更改相关植入,即使在应用发布之后亦是如此。

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

前提条件

开始之前:

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

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

  1. 在您的模块 Gradle 文件(通常是 app/build.gradle)中,添加以下跟踪代码管理器库依赖项:

    dependencies {
      // ...
      compile 'com.google.android.gms:play-services-tagmanager:18.0.4'
    }
    
  2. 登录您的跟踪代码管理器帐号。

  3. 选择一个移动容器。

  4. 点击顶部导航栏中的版本

  5. 点击您要使用的容器版本。

  6. 点击下载

  7. 创建 app/src/main/assets/containers 文件夹(如果不存在)。将已下载的容器复制到该文件夹中。

2. 记录事件和变量

跟踪代码管理器会使用 Google Analytics for Firebase SDK 所记录的事件、参数和用户属性来触发和构建您在 Google 跟踪代码管理器中配置的代码。

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

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

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

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

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

然后,您可以在跟踪代码管理器中按如下方式配置新的事件参数变量,以捕获 image_namefull_text parameter 值:

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

和:

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

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

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

然后,您可以在 Google 跟踪代码管理器中配置新的 Firebase 用户属性变量,以捕获 favorite_food 值:

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

修改和屏蔽事件

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

Google Analytics for Firebase SDK 还会自动记录一些事件用户属性。您可以在跟踪代码管理器中使用自动收集的事件和属性,而无需添加任何代码。不过,您无法屏蔽这些事件和属性。

3. 发送事件

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

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

在发布容器版本之前,您需要进行预览,以确保它可以按预期正常工作。通过 Google 跟踪代码管理器,您可以预览容器的各个版本,只需在网页界面中生成相应链接和二维码,然后使用它们打开您的应用即可。此外,您还可以启用详细日志记录模式,以调试任何意外行为。

预览容器

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

您可以在跟踪代码管理器网页界面的预览窗口中找到预览网址
图 1:从跟踪代码管理器网页界面获取预览网址。

若要预览您的容器,请执行以下操作(如果您使用的是 Android Studio,请跳至第 3 步):

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

    <!--  Add preview activity. -->
    <activity
      android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
      android:noHistory="true"> <!-- optional, removes previewActivity from 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. 登录您的跟踪代码管理器帐号。
    2. 选择一个移动容器。
    3. 点击顶部导航栏中的版本
    4. 针对您要预览的容器版本,依次点击操作 > 预览
    5. 输入您应用的软件包名称。
    6. 点击生成“开始预览”链接
  4. 关闭您的应用,然后使用生成的预览链接或二维码启动它。

  5. 您可以点击网页界面中的生成“结束预览”链接选项生成的链接,从而退出预览模式。

调试容器

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

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

发布容器

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

后续步骤

阅读高级配置