---
title: "如何在真机上测试 Google Play Install Referrer | Appy"
description: "Android Studio 装的包没有 install referrer。用内部测试渠道、编码好的 Play 网址和首次启动读取拿到真实值，并看懂空值和 organic 值。"
source: "https://appy.to/zh/blog/test-google-play-install-referrer"
---

[← 返回博客](https://appy.to/zh/blog)

指南

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

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

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

链接自动把 referrer 带到 Google Play

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

[免费生成链接](https://appy.to/zh/account/register)

用 AI 总结[ChatGPT](https://chatgpt.com/?q=%E8%AF%B7%E6%80%BB%E7%BB%93%E8%BF%99%E4%B8%AA%E9%A1%B5%E9%9D%A2%E5%B9%B6%E5%88%97%E5%87%BA%E8%A6%81%E7%82%B9%EF%BC%9A%20https%3A%2F%2Fappy.to%2Fzh%2Fblog%2Ftest-google-play-install-referrer) [Claude](https://claude.ai/new?q=%E8%AF%B7%E6%80%BB%E7%BB%93%E8%BF%99%E4%B8%AA%E9%A1%B5%E9%9D%A2%E5%B9%B6%E5%88%97%E5%87%BA%E8%A6%81%E7%82%B9%EF%BC%9A%20https%3A%2F%2Fappy.to%2Fzh%2Fblog%2Ftest-google-play-install-referrer) [Perplexity](https://www.perplexity.ai/search?q=%E8%AF%B7%E6%80%BB%E7%BB%93%E8%BF%99%E4%B8%AA%E9%A1%B5%E9%9D%A2%E5%B9%B6%E5%88%97%E5%87%BA%E8%A6%81%E7%82%B9%EF%BC%9A%20https%3A%2F%2Fappy.to%2Fzh%2Fblog%2Ftest-google-play-install-referrer)

简短回答

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

## 工具和指南

-   [App Store 与 Google Play 推广链接生成器给 App Store 链接加上推广活动参数，给 Google Play 链接加上编码好的 referrer。](https://appy.to/zh/tools/app-store-campaign-link)
-   [什么是 install referrer？简短定义，以及它能告诉你什么、不能告诉你什么。](https://appy.to/zh/glossary/install-referrer)
-   [应用推广中的 UTM 参数在 Android 上 UTM 怎样穿过应用商店保留下来，在 iPhone 上为什么不行。](https://appy.to/zh/blog/utm-parameters-for-app-campaigns)
-   [Appy Android SDK在首次启动时读取 referrer，把安装记到对应的链接名下。](https://appy.to/docs/sdk/android)

## 资料来源（2026 年 11 月 13 日查阅）

-   [Android Developers · Play Install Referrer Librarydeveloper.android.com/google/play/installreferrer/library](https://developer.android.com/google/play/installreferrer/library)
-   [Android Developers · ReferrerDetails referencedeveloper.android.com/reference/com/android/installreferrer/api/ReferrerDetails](https://developer.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](https://support.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](https://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 发送旧广播的测试方法，反映不出真实安装时的情况。

## 继续探索

指南

2026年10月21日

8 分钟阅读

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

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

attribution

fingerprinting

privacy

install attribution

[阅读文章](https://appy.to/zh/blog/measure-app-installs-without-fingerprinting)

指南

2026年10月15日

4 分钟阅读

### 在 Android 上解密 Meta Install Referrer

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

meta install referrer

facebook ads

instagram ads

android

[阅读文章](https://appy.to/zh/blog/meta-install-referrer-decryption)

指南

2026年8月14日

11 分钟阅读

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

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

deferred deep linking

install referrer

ios

android

[阅读文章](https://appy.to/zh/blog/deferred-deep-linking-without-sdk)

想看更多内容？浏览 [博客全部主题](https://appy.to/zh/blog).

## 让链接自己带上 referrer

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

[免费生成链接](https://appy.to/zh/account/register)
