将 Firebase 版 Google Analytics 添加到您的即时应用

跟踪应用（无论是即时应用还是已安装应用）的成功情况对每个开发者都很重要。有多个分析库与 Google Play 免安装体验兼容，包括 Fabric Answers、Localytics 和 Mixpanel。

如果您当前的分析解决方案未列出，或者您发现它不适用于 Google Play 免安装体验，请考虑使用 Firebase 版 Google Analytics 作为您的遥测解决方案。本页面介绍了如何在即时应用项目中设置 Firebase 版 Google Analytics。

将 Firebase 版 Google Analytics 添加到即时应用项目

  1. 按照 Firebase 版 Google Analytics 入门指南中介绍的说明，将 Firebase SDK 添加到您的应用。
  2. 使用最新版本的 google-services 插件。
  3. 将 google-services.json 文件放在每个模块中。

  4. 将以下行添加到每个模块的 build.gradle 文件中

    Groovy

    // android { ... }
// dependencies { ... }
plugins {
    id 'com.google.gms.google-services'
}

    Kotlin

    // android { ... }
// dependencies { ... }
plugins {
    id("com.google.gms.google-services")
}

将 Firebase 版 Google Analytics 添加到您的即时应用项目后，您可以像在可安装应用项目中一样使用 Firebase 版 Google Analytics API。

如需详细了解如何使用 Firebase 版 Google Analytics API，请参阅 Firebase 版 Google Analytics 入门文档。

区分已安装应用数据和即时应用数据

由于您的已安装应用和即时应用共用一个软件包名称，因此您可能需要区分从它们各自收集的事件和数据。为了在 Analytics（分析）中区分您的即时应用和已安装应用，请设置一个 app_type 用户属性，即时应用的值设置为“instant”，已安装应用的值设置为“installed”。

以下代码段显示了一个 activity，它获取 Analytics（分析）实例，然后设置一个用户属性。请注意，该代码在 onCreate(android.os.Bundle) 方法中使用了 PackageManagerCompat.isInstantApp() 来确定应用上下文。

Kotlin

val STATUS_INSTALLED = "installed"
val STATUS_INSTANT = "instant"
val ANALYTICS_USER_PROP = "app_type"

private lateinit var firebaseAnalytics: FirebaseAnalytics

protected fun onCreate(savedInstanceState: Bundle?) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT)
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED)
    }
}

Java

final String STATUS_INSTALLED = "installed";
final String STATUS_INSTANT = "instant";
final String ANALYTICS_USER_PROP = "app_type";

private FirebaseAnalytics firebaseAnalytics;

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this);

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT);
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED);
    }

}

设置 app_type 用户属性后，您可以在 Analytics（分析）控制台的“事件”标签页中选择一个事件，然后按 app_type 值过滤该事件。生成的数据投影会为您提供即时应用或已安装应用中指定事件的计数。

如需详细了解如何在 Firebase 版 Google Analytics 中记录和查看事件，请参阅记录事件。

解析 Analytics（分析）事件

Analytics（分析）允许您跟踪对即时应用有价值的各种指标。下表描述了您的即时应用的相关指标，包括 Analytics（分析）中相应的事件名称或属性。

名称 Analytics（分析）值 定义
访问次数 session_start 会话已开始。此事件会自动跟踪。
实物购买 Firebase.Event.ECOMMERCE_PURCHASE 实物购买。您必须在代码中显式跟踪此事件。
数字购买 in_app_purchase 数字应用内购买。此事件会自动跟踪。
应用内停留时间 user_engagement 应用在前台停留的时间量。此事件会自动跟踪。
即时应用上下文 app_type 在即时或已安装上下文中运行的应用所引发的事件。您必须在代码中显式跟踪此事件。请参阅上文的区分已安装应用数据和即时应用数据。
session_start.count 和 app_type 访问两次或更多的用户受众。您必须显式跟踪 app_type 事件；session_start 会自动为您跟踪。请参阅上文的区分已安装应用数据和即时应用数据。 如需详细了解您可以在 Analytics（分析）中收集的事件常量，请参阅 FirebaseAnalytics.Event。

本页面上的内容和代码示例受 内容许可中描述的许可限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的商标或注册商标。