欢迎参加我们将于 6 月 3 日举行的 #Android11:Beta 版发布会

Play Install Referrer API

本文档提供了有关使用 Play Install Referrer API 的技术参考信息。Play Install Referrer API 是一种 AIDL 服务接口,主要供非 Java 程序员使用。

注意Play Install Referrer 库提供 Play Install Referrer API 的封装容器,旨在帮助 Java 程序员使用该 API。

getInstallReferrer() 方法

此方法返回与通过 Bundle 发送的给定软件包名称(表 1 中映射的键)相对应的应用安装引荐来源信息。在 Google Play 发送的 Bundle 响应中,引荐来源信息存储在映射到表 2 中详述的键的字段中。

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

参数 类型 说明
package_name String 调用方的软件包名称,用于消除歧义。

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

类型 说明
install_referrer String 已安装软件包的引荐来源网址。
referrer_click_timestamp_seconds long 引荐来源网址点击事件发生时的时间戳(以秒为单位)。
install_begin_timestamp_seconds long 安装开始时的时间戳(以秒为单位)。
google_play_instant boolean 表明应用的免安装体验是否为过去 7 天内发布的。

注意:安装引荐来源信息的有效期为 90 天,并且在用户重新安装应用之前不会发生变化。为避免应用中进行不必要的 API 调用,您应该在安装完成后首次执行期间仅调用 API 一次