深度链接常见问题
深度链接行为可能会受到多种因素的影响。如果您的深度链接在测试或生产模式中出现异常,请查阅本指南,了解解决办法。如果在尝试本文解决办法后问题依旧存在,请联系support@adjust.com。
常见问题
我的 URL 语法和编码正确吗?
如果您的深度链接未定向至指定目的地,或链接返回 HTTP 404 错误,请首先检查您的 URL 语法和编码。
URL 通常使用以下语法:scheme://host:port/path?query-string#fragment-id
URL 的每个部分会执行不同的功能,并且使用特定的字符来标识和分隔各个值。Scheme 和 host 不区分大小写,但路径和查询字符串区分大小写。URL 构成出现错误则会影响其正常打开。
设置深度链接时,请注意以下条件:
- 如果需要向已包含查询参数的 URL 查询字符串添加 Adjust 参数,请使用
&
。否则,URL 中第二个?
之后的所有信息将被删除。- 正确示例:
https://abcd.adj.st/my?path=location&client=name&adjust_t=klm012
- 错误示例:
https://z9pm.adj.st/my?path=location&client=name?adjust_t=klm012
- 正确示例:
- 如果您的查询字符串已进行编码,请以
/
开头或确保它是deeplink
参数的一部分。
如果您的应用尚未安装,并且不满足这些条件,则浏览器将移除 adjust_t
参数。Adjust 需要使用此参数来确定点击来源,否则我们将返回 HTTP 404 错误 URL not found
。
示例
根据 URL 的设置方式,您的深度链接可能出现以下行为:
深度链接设置 | 链接 URL 示例 | 行为 |
---|---|---|
链接 URL + deep_link 参数 | https://app.adjust.com/r40ncx7?deep_link=adjust%3A%2F%2F%3Fpath | 打开应用内的特定页面 |
通用链接 (Universal Link) | https://abcd.adj.st/%3Fpath?adjust_t=r40ncx7 | 打开应用内的特定页面 |
通用链接 (Universal Link) | https://abcd.adj.st/?path&adjust_t=r40ncx7 | 若应用已安装则打开应用,但无法打开特定应用内页面。 |
通用链接 (Universal Link) | https://abcd.adj.st%3Fpath?adjust_t=r40ncx7 | 无效并返回错误 |
我为什么看不到归因数据和/或推广活动层级?
如果深度链接 URL 中的归因数据或推广活动层级不可用,则可能是设置问题导致的。请检查设备 ID 参数和推广活动参数(如适用)是否由于后备或回传中的编码错误而被截断。例如,确定 URL 中没有空格或无效字符。
我的应用已经安装,但为何还是会被转到应用商店?
通常而言,此行为意味着您的深度链接打开应用失败,并且,作为后备,我们已重定向至商店。要进行测试,请按照以下步骤操作:
按照我们的测试说明,以现有用户身份检查通用链接和带有 deep_link 参数的链接。
如果您的测试成功,并且应用打开,则考虑深度链接打开失败时,点击此链接的环境。然后检查这种情况下是否需要任何其他参数。
- 例如,如果从 Slack 中点击 JSR 通用链接,则应出现
adjust_deeplink_js=1
标记,这有助于在重定向至商店之前加载 Scheme。如果在带有adjust_deeplink_js
标记的情况下,您的链接仍未正常工作,则 App Scheme 可能未被正确输入 Campaign Lab。
- 例如,如果从 Slack 中点击 JSR 通用链接,则应出现
请确保链接 URL 中的后备或回传没有 编码错误 。此类错误可能导致参数丢失,进而导致整个链接无法正常发挥作用。
我的深度链接为什么没有正确打开应用内的位置?
如果您的链接能打开应用,但无法打开正确位置,请查看是否是链接或应用设置出现了问题。
- 将通用链接域名 (
https://abcd.adj.st/
) 或 scheme (myapp://
) 设置在浏览器环境中点击。 - 请联系您的开发者,检查应用内的路径设置是否正确。
只有深度链接附加了 Adjust 链接或 Adjust 参数时,Adjust 才会接收其传入的点击数据,而只含有应用专属域名的直接深度链接不会向 Adjust 返回任何数据。
发送点击数据:
myapp://welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1
https://z9pm.adj.st/welcome?adjust_t=abc123&adjust_campaign=re-engage_my_users&adjust_adgroup=apac&adjust_creative=promo1
不发送点击数据:
myapp://welcome
要接收针对已安装应用或深度链接再归因的点击数据,请务必在 Adjust SDK 中安装 SDK 点击 (iOS; 安卓)。
触发 SDK 点击的深度链接会在 Datascape 中报告为点击。您也可以使用 click
回传在原始数据中查看这些信息。要具体查看哪些点击来自深度链接 SDK 点击,请附加 {is_deeplink_click}
参数。
借助链接 + deep_link 参数对深度链接进行问题排查
Facebook 帖文中的深度链接为何无法运行?
通过 Facebook 贴文开展的推广活动需要使用附加了 deeplink
参数的 Adjust 链接 URL。此外,deeplink
参数必须附加路径,否则用户将被转至商店(即使已安装应用也将如此)。提供的路径不需要有效。
附加路径的参数示例:https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path
延迟深度链接问题排查
应用安装后,延迟深度链接为何无法打开应用正确位置?
如果安装后,延迟深度链接未将您定位至正确的应用内位置,请首先检查此路径是否确实存在。在浏览器中点击打开 scheme (myapp://
),判断问题的起因在于链接还是应用设置。请联系您的开发者,检查应用内的路径设置是否正确。
如果您以现有用户的身份进入了正确的路径,而不是以新用户的身份进入,则通过测试控制台检查您的设备是否归因于该点击。如果未归因于此点击,请通过测试控制台清除设备,然后重试。
如果您被归因于此点击,请检查您的设备是否包含 deeplink
参数。如不包含,请确保没有编码错误以及 deeplink
参数之前没有特殊字符截断 URL。
最后,如果包含 deeplink
参数,则确保路径能够显示。如果未能显示,则说明由于某些原因路径已被切断。请联系 support@adjust.com 获取帮助。