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`	`字符串`	已安装软件包的引荐来源网址。
`referrer_click_timestamp_seconds`	`long`	引荐来源点击发生的客户端时间戳（以秒为单位）。
`install_begin_timestamp_seconds`	`long`	应用安装开始的客户端时间戳（以秒为单位）。
`referrer_click_timestamp_server_seconds`	`long`	引荐来源点击发生的服务器端时间戳（以秒为单位）。
`install_begin_timestamp_server_seconds`	`long`	应用安装开始的服务器端时间戳（以秒为单位）。
`install_version`	`字符串`	应用首次安装时应用的版本。
`google_play_instant`	`布尔值`	表示您的应用的即时体验是否在过去 7 天内启动过。

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