---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.0
alternate:
  - https://appmetrica.yandex.com/docs/en/sdk/android/analytics/android-deferred-deeplinks.md
  - https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-deferred-deeplinks.md
  - https://appmetrica.yandex.com/docs/zh/sdk/android/analytics/android-deferred-deeplinks.md
  - href: https://appmetrica.yandex.com/docs/zh/sdk/android/analytics/android-deferred-deeplinks.md
    type: text/markdown
    title: Markdown version
  - href: https://appmetrica.yandex.com/docs/zh/llms.txt?revision=r21975373
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com/docs/zh/llms.txt?revision=r21975373

# 延迟深链支持

延迟深链用于在第一次启动时将参数传递到应用程序。 这些参数可以根据引导用户的来源，在应用中执行操作（例如打开特定的应用屏幕、显示某些内容等）。

与普通深链不同，延迟深链只在第一次启动应用时生效。

{% note info "" %}

延迟深链只在 Android 设备上工作。

{% endnote %}

## 延迟深链是如何工作的  {#process}

下面的方案展示了延迟深链的工作流程：

![延迟深链是如何工作的](../../../../_images/deferred-deeplink-zh.png)

1. 用户点击包含延迟深链参数的跟踪链接。
1. 跟踪 URL 会将用户导向应用商店。
1. 用户下载应用程序。
1. 第一次启动应用后，延迟深链参数会被发送到应用。 你需要执行一个[请求](https://appmetrica.yandex.com/docs/zh/sdk/android/analytics/android-operations.md#deferreddeeplink-request)来获取参数。

## 如何设置延迟深链 {#setup}

1. 在[tracker](https://appmetrica.yandex.com/docs/zh/mobile-tracking/add-tracker.md)中指定链接，在**Deeplink**字段 — 该链接既可作为常规深链接，也可作为延迟深链接使用。

2. 在应用程序中处理深链或参数的接收。 例如，通过执行[请求](https://appmetrica.yandex.com/docs/zh/sdk/android/analytics/android-operations.md#deferreddeeplink-request)来调用所需屏幕的导航。 
    
    如果您请求延迟深链参数，请确保这些参数在深链中可用。

{% note warning "" %}

跟踪链接中的参数不会自动传输到深链，但可以根据[说明](https://appmetrica.yandex.com/docs/zh/mobile-tracking/tracking-specification.md#passing-params)进行传输。 您可以用这种方式将参数传递到普通深链和延迟深链中。

{% endnote %}

## 错误描述 {#errors}

接口 `DeferredDeeplinkListener` 和 `DeferredDeeplinkParametersListener` 中包含了在发出请求时可能出现的错误的描述：

**非首次启动**

参数或延迟深链无法获取，因为它们只能在应用程序首次启动时请求。

应用程序的首次启动是指用户第一次请求参数的过程会话（运行时环境、虚拟机）。 如果在请求时存在深链，则监听器会在同一线程中同步调用。 在下一次启动过程中，库不再识别延迟的深链，并返回 `NOT_A_FIRST_LAUNCH` 错误。

**PARSE_ERROR**

根据界面不同，此错误表示以下内容：

* 如果使用了`DeferredDeeplinkListener`接口：未找到延迟深链。 这可能是因为 referrer 中没有包含 `appmetrica_deep_link` 参数。
* 如果使用`DeferredDeeplinkParametersListener`接口：延迟深链不包含有效参数。
   如果以下条件之一未满足，则会返回 `PARSE_ERROR` 错误：

   * INSTALL_REFERRER 必须包含 `appmetrica_deep_link` 参数。
   * 参数 `appmetrica_deep_link` 的值必须包含有效的 URI。
   * 深链 URI 中必须至少包含一个查询参数。

   一个有效的深链示例：`sampleapp://samplepath?sampleparam1=samplevalue1`.

## 了解更多 {#learn-more}

[请求延迟深链参数](https://appmetrica.yandex.com/docs/zh/sdk/android/analytics/android-operations.md#deferreddeeplink-parameters-request)

<!-- source: zh/_includes/feedback-button-3.md -->
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

<a href="../troubleshooting/feedback-new">
  <span class="button">联系支持</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">为文档提出改进建议</span>
</a>
<!-- endsource: zh/_includes/feedback-button-3.md -->