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。