如何在真机上测试 Google Play Install Referrer
从 Android Studio 装上的包永远没有 install referrer,所以大多数测试读到一个空值就停下了。本文讲怎样拿到真实的值:编码好的 Play 网址、内部测试渠道、全新安装,以及首次启动时用 Kotlin 读取;另外说明每种空值或异常值意味着什么。
简短回答
怎样在真机上测试 Google Play Install Referrer?
把版本发布到内部测试渠道,从测试手机上卸载应用,在这部手机上打开带有 URL 编码 referrer 的 Play 网址,从 Play 页面安装,然后在首次启动时用 Play Install Referrer Library 读取这个值。从 Android Studio 或 adb 安装的包永远不会带推广 referrer。
要点
- 每次安装的 referrer 是固定的,保留 90 天;要再测一次,就卸载后从 Play 网址重新安装。
- 对值做编码,让 = 和 & 留在 referrer 参数里,长度不超过 512 个字符。
- utm_source=google-play&utm_medium=organic 说明这次安装不是通过你的链接来的。
简短的回答
Google Play 只会为通过 Play 商店应用完成的安装提供 referrer。用 Android Studio 或 adb 装上的调试包,背后没有任何来自 Play 的安装,自然也读不到和推广活动相关的内容。
想做真实测试,就把一个版本发布到内部测试渠道,从测试手机上卸载应用,在这部手机上打开带有编码 referrer 的 Play 网址,从打开的 Play 页面安装,然后在首次启动时读取这个值。测试渠道配好之后,整个流程大约十分钟。
用来测试的 Play 网址
就是一条普通的商店链接,多了一个参数。
https://play.google.com/store/apps/details?id=com.example.myshop&referrer=utm_source%3Dqa_test%26utm_campaign%3Dreferrer_check
https://play.google.com/store/apps/details
商店页面
Google Play 应用详情页的标准地址。
?id=com.example.myshop
包名
你的 application ID,和 Play Console 里的完全一致。
&referrer=
referrer 参数
它后面的所有内容,都会在安装后交给你的应用。
utm_source%3Dqa_test%26utm_campaign%3Dreferrer_check
编码后的值
即 utm_source=qa_test&utm_campaign=referrer_check,经过 URL 编码,这样其中的 = 和 & 才会留在 referrer 里面。Google 要求不超过 512 个字符。
完整测试一遍
添加依赖和读取代码
添加 com.android.installreferrer:installreferrer:2.2,并按下面的代码在首次启动时读取。把值打到日志里,方便用 logcat 查看。
发布到内部测试
在 Play Console 里把这个版本上传到内部测试渠道,并把你的 Google 账号加为测试人员。内部测试最多支持 100 名测试人员,新版本几分钟内就能推送到他们手上;不过第一次发布可能要等几个小时。
在手机上加入测试
打开“测试人员”标签页里的加入链接,使用的 Google 账号要和测试手机上 Play 商店应用登录的账号相同。
卸载应用
每次安装的 referrer 是固定的,重新安装之前都不会变。把之前装过的版本都删掉,包括 Android Studio 装上去的那个。
在手机上打开 Play 网址
在 Chrome、聊天软件里点击,或者扫二维码,让它在这部手机上打开 Play 商店应用。在电脑浏览器里通过 play.google.com 安装是另一条路径;要测的是用户实际走的那条。
安装并打开应用
从打开的 Play 页面安装,然后启动一次应用。在 adb logcat 里留意 referrer 和两个时间戳。
和你发出去的值对比
你应该看到 utm_source=qa_test&utm_campaign=referrer_check、一个点击时间和一个开始安装的时间。要再测一次,就卸载应用,从 Play 网址重新开始。
在首次启动时读取
Kotlin 代码,基于 Google 的示例。只读取一次 referrer,写入日志,然后关闭连接。
build.gradle.kts
dependencies {
implementation("com.android.installreferrer:installreferrer:2.2")
}InstallReferrer.kt
import android.content.Context
import android.util.Log
import com.android.installreferrer.api.InstallReferrerClient
import com.android.installreferrer.api.InstallReferrerClient.InstallReferrerResponse
import com.android.installreferrer.api.InstallReferrerStateListener
fun readInstallReferrerOnce(context: Context) {
val prefs = context.getSharedPreferences("install_referrer", Context.MODE_PRIVATE)
if (prefs.getBoolean("read", false)) return
val client = InstallReferrerClient.newBuilder(context).build()
client.startConnection(object : InstallReferrerStateListener {
override fun onInstallReferrerSetupFinished(responseCode: Int) {
when (responseCode) {
InstallReferrerResponse.OK -> {
val details = client.installReferrer
Log.d("InstallReferrer", "referrer=${details.installReferrer}")
Log.d("InstallReferrer", "clickTime=${details.referrerClickTimestampSeconds}")
Log.d("InstallReferrer", "installBegin=${details.installBeginTimestampSeconds}")
prefs.edit().putBoolean("read", true).apply()
}
InstallReferrerResponse.FEATURE_NOT_SUPPORTED ->
Log.d("InstallReferrer", "Play Store app doesn't support the API")
InstallReferrerResponse.SERVICE_UNAVAILABLE ->
Log.d("InstallReferrer", "Play Store service unavailable, try again later")
}
client.endConnection()
}
override fun onInstallReferrerServiceDisconnected() {}
})
}查看结果
终端
adb logcat -s InstallReferrer空值或异常值,分别是什么原因
Appy 能做什么
Appy 链接会自动给 Google Play 加上 referrer,里面带着链接名称,所以测试时只要点一下你自己的链接就行。在 Enterprise 套餐中,Appy SDK 会在首次启动时读取 referrer,把这次安装作为已验证安装记到那条链接名下。如果只是不用 Appy 的单次推广网址,App Store 推广链接生成器可以帮你编码 referrer。
工具和指南
资料来源(2026 年 11 月 13 日查阅)
- Android Developers · Play Install Referrer Librarydeveloper.android.com/google/play/installreferrer/library
- Android Developers · ReferrerDetails referencedeveloper.android.com/reference/com/android/installreferrer/api/ReferrerDetails
- Play Console Help · Set up an open, closed or internal testsupport.google.com/googleplay/android-developer/answer/9845334
- Android Developers · Referrer format for Google Play URLs (Play Games on PC)developer.android.com/games/playgames/user-acquisition
常见问题
不发布应用能测试 install referrer 吗?
拿不到真实的 referrer。Google Play 只为来自 Play 商店的安装传递 referrer,所以这个版本必须发布到某个测试渠道。内部测试渠道最快:最多 100 名测试人员,新版本几分钟内就能用。
为什么我的 install referrer 是空的?
最常见的原因是应用是从 Android Studio 或 adb 装上的,或者你打开 Play 网址时应用已经装着。先卸载,在手机上打开 Play 网址,再从 Play 页面安装。
install referrer 能保留多久?
Google 会保留 90 天,除非重新安装应用,否则它不会变。在首次启动时读取一次,把需要的内容存下来。
referrer 的值需要做 URL 编码吗?
需要。对整个值做编码,这样其中的 = 和 & 才会留在 referrer 参数里面。Google 的指南还要求它不超过 512 个字符。
还能用旧的 INSTALL_REFERRER 广播来测试吗?
不能。请使用 Play Install Referrer Library,它从 Play 商店应用读取这个值。用 adb 发送旧广播的测试方法,反映不出真实安装时的情况。
继续探索
不靠设备指纹,怎样衡量应用安装
即使用户同意了跟踪,Apple 也不允许使用设备指纹;欧盟监管机构则把基于 IP 的跟踪视为对设备的访问。本文梳理在 iPhone 和 Android 上还有哪些方法能带着证据衡量安装,并给出一套从不靠猜的衡量方案。
在 Android 上解密 Meta Install Referrer
读取并解密 Facebook 和 Instagram 的 referrer,把安装归到广告系列、广告组和广告,浏览归因也包括在内。
不用 SDK 的延迟深度链接是怎么运作的
不嵌入归因 SDK,也能把链接意图带过应用安装这道坎。本文讲清 Android 和 iOS 上什么能真正穿过商店边界、什么会断掉,以及每种变通方案的隐私代价。
想看更多内容?浏览 博客全部主题.
让链接自己带上 referrer
Appy 链接把 Android 手机送到已经带好 referrer 的 Google Play,把 iPhone 送到 App Store。免费套餐,无需信用卡。