延迟深链支持

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

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

延迟深链是如何工作的

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

1. 用户点击包含延迟深链参数的跟踪链接。
2. 跟踪 URL 会将用户导向应用商店。
3. 用户下载应用程序。
4. 第一次启动应用后，延迟深链参数会被发送到应用。 你需要执行一个请求来获取参数。

如何设置延迟深链

1. 在tracker中指定链接，在Deeplink字段 — 该链接既可作为常规深链接，也可作为延迟深链接使用。

2. 在应用程序中处理深链或参数的接收。 例如，通过执行请求来调用所需屏幕的导航。

   如果您请求延迟深链参数，请确保这些参数在深链中可用。

错误描述

接口 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.

了解更多

请求延迟深链参数

如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

联系支持 为文档提出改进建议