Skip to main content

适用场景

如果扫描设备上已安装您的应用,App Deep Link QR 码会通过其自定义 URI scheme 直接打开应用中的特定界面。如果尚未安装,代码会回退到您应用的商店页面,最后再退回到一个纯网页。它是一种 Quick Code——一种没有落地页的直接动作型 QR。在应用中,其卡片上的文案是 “Open your app directly if it’s installed, otherwise fall back to the store.”(如果已安装则直接打开您的应用,否则回退到商店)。
App Deep Link 始终是动态(dynamic) QR 码——这是必要的,因为解析逻辑(应用 → 商店 → 回退)需要在扫描时运行。您会获得一个 Scanova 短链接(scnv.io/...),也可以绑定自定义域名,但它本身没有落地页。

解析顺序

表单分为三个部分,扫描时按以下顺序进行检查:
  1. App installed(应用已安装)—— 设备通过匹配的 Android app URIiOS app URI 直接打开您的应用。
  2. App not installed, OS recognized(应用未安装,但识别出操作系统)—— 如果您提供了匹配的 store link(Google Play 或 Apple App Store),设备会被引导至该商店链接。
  3. Neither applies(以上均不适用)—— 扫描者会被引导至 Fallback web URL,这也是该字段为必填项的原因。
1

打开 Create QR Code 并选择 Quick Code

在侧边栏中,进入 QR Codes,然后点击 Create QR Code(或前往 /qr/create)。点击 Quick Code 卡片。
2

选择 App Deep Link

Quick Code 类型网格中,点击顶部 Dynamic 分区下 App Deep Link 下方的 Configure(此类型没有 Static 选项)。这会打开 /qr/quick/appDeepLink 处的表单。
3

添加您的应用 URI

App URIs 下,至少输入 Android app URIiOS app URI 之一——即您的应用注册的、用于直接打开的自定义 scheme(例如 myapp://profile)。
4

添加商店链接(可选)和回退网址

Store links 下,您可以选择性地添加 Google Play 和/或 Apple App Store 的网址,当应用未安装但设备操作系统被识别时会展示这些链接。在 Fallback URL 下,输入一个 Fallback web URL——此字段为必填项,因为它是所有其他情况下的最终回退目的地。
App Deep Link Quick Code 表单,包含 Android 和 iOS 应用 URI、可选的商店链接、必填的回退网址,以及该动态 QR 码自动生成的短链接

已填写应用 URI、商店链接和回退网址的 App Deep Link Quick Code 表单

5

发布

点击 Publish。会弹出一个面板,用于确认或重命名 QR 码、分配文件夹或标签,并在确认前调整 QR 码设计。

通过 API 创建

若要通过 API 而非界面创建 App Deep Link QR 码,请使用类别 ID 23(在 Create QR CodeCategory dropdown reference 表中标记为 App Deep Linkallowed_qr_types: "dy"——qr_type 只能取 "dy")。与本页其他类别不同,这里的 info 负载是一个裸数组,由带类型的区块组成,而不是 {type, data} 对象:
理论上每个区块都是可选的,但 fallback 区块的 url 实际上是必需的——不带回退地址发布会像仪表盘表单那样阻止验证通过。只有在您至少拥有一个应用 URI 时,才应包含 intentUri 区块。 完整的请求结构请参见 Create QR Code

相关内容