Appy
← 返回博客
指南

如何在真机上测试 Google Play Install Referrer

从 Android Studio 装上的包永远没有 install referrer,所以大多数测试读到一个空值就停下了。本文讲怎样拿到真实的值:编码好的 Play 网址、内部测试渠道、全新安装,以及首次启动时用 Kotlin 读取;另外说明每种空值或异常值意味着什么。

Appy•2026年11月13日•阅读约 7 分钟

链接自动把 referrer 带到 Google Play

  • 一条链接覆盖 Google Play、App Store 和你的网站
  • 推广活动和链接名称在安装后依然保留
  • 免费套餐,无需信用卡
免费生成链接

简短回答

怎样在真机上测试 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

  1. https://play.google.com/store/apps/details

    商店页面

    Google Play 应用详情页的标准地址。

  2. ?id=com.example.myshop

    包名

    你的 application ID,和 Play Console 里的完全一致。

  3. &referrer=

    referrer 参数

    它后面的所有内容,都会在安装后交给你的应用。

  4. utm_source%3Dqa_test%26utm_campaign%3Dreferrer_check

    编码后的值

    即 utm_source=qa_test&utm_campaign=referrer_check,经过 URL 编码,这样其中的 = 和 & 才会留在 referrer 里面。Google 要求不超过 512 个字符。

用一个你在日志里一眼能认出的值。如果它完整到达,说明编码和传递都没问题。

完整测试一遍

01

添加依赖和读取代码

添加 com.android.installreferrer:installreferrer:2.2,并按下面的代码在首次启动时读取。把值打到日志里,方便用 logcat 查看。

02

发布到内部测试

在 Play Console 里把这个版本上传到内部测试渠道,并把你的 Google 账号加为测试人员。内部测试最多支持 100 名测试人员,新版本几分钟内就能推送到他们手上;不过第一次发布可能要等几个小时。

03

在手机上加入测试

打开“测试人员”标签页里的加入链接,使用的 Google 账号要和测试手机上 Play 商店应用登录的账号相同。

04

卸载应用

每次安装的 referrer 是固定的,重新安装之前都不会变。把之前装过的版本都删掉,包括 Android Studio 装上去的那个。

05

在手机上打开 Play 网址

在 Chrome、聊天软件里点击,或者扫二维码,让它在这部手机上打开 Play 商店应用。在电脑浏览器里通过 play.google.com 安装是另一条路径;要测的是用户实际走的那条。

06

安装并打开应用

从打开的 Play 页面安装,然后启动一次应用。在 adb logcat 里留意 referrer 和两个时间戳。

07

和你发出去的值对比

你应该看到 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() {}
    })
}
Google 会保留 referrer 90 天,并建议应用只在安装后首次运行时调用一次这个 API。

查看结果

终端

adb logcat -s InstallReferrer
先用 USB 连好测试手机并运行这条命令,再打开应用。

空值或异常值,分别是什么原因

从 Android Studio 安装后完全没有推广信息
可能的原因: 应用不是从 Google Play 安装的
怎么处理: 通过 Play 网址从测试渠道安装
utm_source=google-play&utm_medium=organic
可能的原因: 这次安装不是通过你的链接来的;这是自然安装的常见值
怎么处理: 卸载后,在手机上从 Play 网址重新开始
读到的是上一次测试的旧值
可能的原因: 应用没有重新安装,所以还是第一次的 referrer
怎么处理: 卸载后用新的网址重新安装
只收到 utm_source,后面的都丢了
可能的原因: referrer 没有编码,被 & 提前截断了
怎么处理: 对值做编码:= 写成 %3D,& 写成 %26
SERVICE_UNAVAILABLE 或 FEATURE_NOT_SUPPORTED
可能的原因: Play 商店应用正在更新、不存在或版本太旧
怎么处理: 更新 Play 商店,下次启动时再试
没有 Google Play 的华为手机上什么都没有
可能的原因: 没有 Play 商店,也就没有 Play referrer
怎么处理: AppGallery 为从它的商店安装的应用提供自己的 referrer
这个自然安装的值是 Google 在 2016 年公布的,大多数 SDK 至今仍然这样上报;把它当作“没有推广活动”,而不是错误。

Appy 能做什么

Appy 链接会自动给 Google Play 加上 referrer,里面带着链接名称,所以测试时只要点一下你自己的链接就行。在 Enterprise 套餐中,Appy SDK 会在首次启动时读取 referrer,把这次安装作为已验证安装记到那条链接名下。如果只是不用 Appy 的单次推广网址,App Store 推广链接生成器可以帮你编码 referrer。

工具和指南

资料来源(2026 年 11 月 13 日查阅)

常见问题

不发布应用能测试 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 发送旧广播的测试方法,反映不出真实安装时的情况。

继续探索

指南
2026年10月21日
8 分钟阅读

不靠设备指纹,怎样衡量应用安装

即使用户同意了跟踪,Apple 也不允许使用设备指纹;欧盟监管机构则把基于 IP 的跟踪视为对设备的访问。本文梳理在 iPhone 和 Android 上还有哪些方法能带着证据衡量安装,并给出一套从不靠猜的衡量方案。

attribution
fingerprinting
privacy
install attribution
阅读文章
指南
2026年10月15日
4 分钟阅读

在 Android 上解密 Meta Install Referrer

读取并解密 Facebook 和 Instagram 的 referrer,把安装归到广告系列、广告组和广告,浏览归因也包括在内。

meta install referrer
facebook ads
instagram ads
android
阅读文章
指南
2026年8月14日
11 分钟阅读

不用 SDK 的延迟深度链接是怎么运作的

不嵌入归因 SDK,也能把链接意图带过应用安装这道坎。本文讲清 Android 和 iOS 上什么能真正穿过商店边界、什么会断掉,以及每种变通方案的隐私代价。

deferred deep linking
install referrer
ios
android
阅读文章

想看更多内容?浏览 博客全部主题.

让链接自己带上 referrer

Appy 链接把 Android 手机送到已经带好 referrer 的 Google Play,把 iPhone 送到 App Store。免费套餐,无需信用卡。