Play 安装推荐来源 API

本文档提供有关使用 Play 安装推荐来源 API 的技术参考。Play 安装推荐来源 API 是一个 AIDL 服务接口，主要供非 Java 程序员使用。

注意：Play 安装推荐来源库为 Play 安装推荐来源 API 提供了一个包装器，旨在帮助 Java 程序员使用该 API。

getInstallReferrer() 方法

此方法返回与通过 Bundle 发送的给定包名称相对应的应用安装推荐来源信息（表 1 中映射的键）。在 Google Play 发送的响应 Bundle 中，推荐来源信息存储在映射到表 2 中详细说明的键的字段中。

表 1. getInstallReferrer() bundle 数据请求。

参数	类型	描述
`package_name`	`字符串`	调用者的包名称，用于消除歧义。

表 2. getInstallReferrer() 请求的响应数据。

键	类型	描述
`install_referrer`	`字符串`	已安装包的推荐来源 URL。
`referrer_click_timestamp_seconds`	`长整型`	推荐来源点击发生时的客户端时间戳（以秒为单位）。
`install_begin_timestamp_seconds`	`长整型`	应用安装开始时的客户端时间戳（以秒为单位）。
`referrer_click_timestamp_server_seconds`	`长整型`	推荐来源点击发生时的服务器端时间戳（以秒为单位）。
`install_begin_timestamp_server_seconds`	`长整型`	应用安装开始时的服务器端时间戳（以秒为单位）。
`install_version`	`字符串`	应用首次安装时应用的版本。
`google_play_instant`	`布尔型`	指示您的应用的即时体验是否在过去 7 天内启动。

注意：安装推荐来源信息将保留 90 天，并且不会更改，除非应用程序重新安装。为避免在您的应用中进行不必要的 API 调用，您应仅在安装后第一次执行期间调用 API。