此页面由 Cloud Translation API 翻译。

为您的免安装应用添加 Google Analytics for Firebase

无论是免安装应用还是安装版应用，跟踪它们是否取得成功对于每一位用户都很重要开发者。有多个分析库兼容 Google Play 免安装体验，包括 Fabric 解答、 Localytics、和 Mixpanel。

如果您当前的分析解决方案未列出，或您发现它并未显示支持 Google Play 免安装体验，不妨考虑使用 Google Analytics for Firebase，您的遥测解决方案。本页介绍了如何设置 Google Analytics for Firebase 在免安装应用项目中运行

将 Google Analytics for Firebase 添加到免安装应用项目中

按照说明将 Firebase SDK 添加到您的应用具体说明 Google Analytics for Firebase 入门指南。
使用最新版本的 Google 服务插件。
在每个模块中放置 google-services.json 文件。

将下面这行代码添加到每个模块的 build.gradle 文件中：

Groovy

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

Kotlin

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

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

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

区分安装式和免安装应用数据

由于您的安装版应用和免安装应用共用同一个软件包名称，您可能需要区分从每个会话收集到的事件和数据。接收者在 Google Analytics 中区分免安装应用和安装式应用，设置 app_type 用户属性，值为“instant”和 “已安装”。

以下代码段展示了一个 activity，用于获取 Analytics 实例，然后设置用户属性。请注意，代码使用的 PackageManagerCompat.isInstantApp() 在onCreate(android.os.Bundle)内方法确定应用的上下文。

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 用户属性后，您便可在 Google Analytics 控制台的事件标签页，然后按 app_type 值。由此产生的数据投影会为您提供或安装版应用中指定的事件。

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

解读 Analytics 事件

通过 Google Analytics 可以跟踪各种有价值的指标免安装应用。下表介绍了包括相应的事件名称或属性， Google Analytics。

名称	Analytics 值	定义
访问次数	`session_start`	会话已开始。系统会自动跟踪此事件。
实体店购买	`Firebase.Event.ECOMMERCE_PURCHASE`	实体店购买。您必须明确跟踪此事件。
数字商品购买	`in_app_purchase`	数字应用内购买。系统会自动跟踪此事件。
在应用内花费的时间	`user_engagement`	应用在前台运行的时长。系统会自动跟踪此事件。
免安装应用环境	`app_type`	从即时运行或安装式运行的应用引发的事件上下文。您必须明确跟踪此事件。请参阅安装版和免安装应用数据。
回访者数量	`session_start.count` 和 `app_type`	至少访问两次的用户的数量。您必须明确跟踪 `app_type` 事件；`session_start` 已为您跟踪。请参阅区分安装版应用数据与免安装应用数据之间的差异。

如需详细了解您可以在请参阅 FirebaseAnalytics.Event。