不用 SDK 的延迟深度链接：底层到底是怎么运作的

Appy 链接已经替你做好了 Android 这一半

自 2026 年 9 月起，每条把用户送到 Google Play 商品页的 Appy 链接都会自动加上 referrer 参数。不需要任何配置，也不用加 SDK。referrer 里始终带有 appy_slug，也就是被点击链接的 slug，应用据此就能知道是哪条链接带来了这次安装。这部分在所有套餐上都可用，包括 Free。

如果链接开启了参数传递，点击时的 query string 也会一起放进 referrer。一个指向 appy.to/summer?screen=product-42&utm_source=poster 的二维码，在首次启动时会以下面这串字符到达应用。整个过程我们这边不存任何东西，也不靠猜测做匹配。

被扫描或点击的链接

https://appy.to/summer?screen=product-42&utm_source=poster

发往 Google Play 的地址

https://play.google.com/store/apps/details?id=com.example.app&referrer=appy_slug%3Dsummer%26screen%3Dproduct-42%26utm_source%3Dposter&screen=product-42&utm_source=poster

应用首次启动时读到的内容

appy_slug=summer&screen=product-42&utm_source=poster

后台里的设置

参数传递是 Business 套餐里按链接单独开关的设置。创建链接时它是“启用参数传递”开关；在已有链接上，同一个设置叫“传递传入参数”。关闭时，referrer 仍然会带上 appy_slug，但不带别的。

有几条规则值得知道。你自己写进 Play URL 的内容优先：如果目标地址里已经有 referrer=utm_source%3Dposter，Appy 会保留这个值，再在旁边加上 appy_slug。appy_slug 本身不能通过 query string 覆盖，所以一条链接没法冒领别的链接带来的安装。另外，如果传递的参数会让 referrer 超过 1 KB，Appy 会丢掉它们，只保留 slug。

参数是明文传输的。活动名称或页面 ID 没问题；如果涉及个人信息，或者值比较多，请只传一个短 token，再在你的服务器上解析，做法见下文的设计模式。

在应用里读取

引入 Install Referrer 库，在首次启动时读取一次，然后像解析 query string 一样解析它。客户端要做的就这些：

implementation("com.android.installreferrer:installreferrer:2.2")

fun readAppyReferrer(context: Context, onResult: (Map<String, String>) -> Unit) {
    val client = InstallReferrerClient.newBuilder(context).build()
    client.startConnection(object : InstallReferrerStateListener {
        override fun onInstallReferrerSetupFinished(responseCode: Int) {
            val raw = if (responseCode == InstallReferrerClient.InstallReferrerResponse.OK) {
                runCatching { client.installReferrer.installReferrer }.getOrNull()
            } else null
            client.endConnection()
            val uri = Uri.parse("?" + raw.orEmpty())
            onResult(uri.queryParameterNames.associateWith { uri.getQueryParameter(it).orEmpty() })
        }

        override fun onInstallReferrerServiceDisconnected() = Unit
    })
}

readAppyReferrer(this) { params ->
    val slug = params["appy_slug"] ?: return@readAppyReferrer
    params["screen"]?.let { openScreen(it) }
    analytics.logInstallSource(slug, params["utm_source"])
}

只在安装后的首次启动时运行，并记下已经运行过。referrer 会一直留在设备上，如果每次冷启动都读，用户就会反复被带到同一个页面。从 AppGallery 或直接用 APK 安装的用户不会带 referrer，这时直接打开正常的首页就好。