跟踪链接参数

更多集成合作伙伴指南 • 更多面向客户的 Singular Links 指南

追踪链接参数在确保为广告网络合作伙伴准确采集数据和进行归因方面起着至关重要的作用。Singular 追踪链接支持多种多样的参数，使广告网络能够附加有关点击和展示的宝贵信息。通过填充这些参数，广告网络可以将关键数据传递给 Singular，从而更精确地衡量广告系列的表现。

一旦触发追踪链接，Singular 追踪器就会处理其中嵌入的参数，并以多种方式加以利用，例如：

作为与 Singular 集成的媒体来源，追踪链接是您集成中的关键组成部分。它们让您能够传递有关点击和展示的重要数据，从而确保准确的归因和广告系列衡量。如果贵公司还支持回传（postback），请务必在向 Singular 提交集成请求之前查阅 广告网络的回传宏和透传参数 部分。收集齐所有必要信息后，您可以 在此申请 成为 Singular 的集成媒体来源。

显示： 全部 设备数据 粒度参数 Singular Links 行为 网站链接参数

禁用短链接的参数覆盖

默认情况下，您可以在点击时向 Singular Link 附加重定向和深度链接参数（例如 _dl 、 _fallback_redirect 、 _ios_redirect 等），以动态覆盖链接已保存的设置。当您需要从同一个基础链接提供不同的重定向目的地时，这很有用。

然而，在某些工作流程中——例如许多团队成员在内部共享链接时——您可能希望阻止链接被覆盖和重复使用。

禁用短链接参数覆盖 功能可让您锁定已缩短的自定义链接，使基础链接中已设置的参数无法通过 URL 附加的方式被覆盖。基础链接中 未 设置的参数仍可作为新值进行附加。

工作原理

以下重定向和深度链接参数在基础链接中被设置时，会受到专门的覆盖保护：

_dl , _android_dl , _ios_dl , _ddl , _android_redirect , _android_ddl , _ios_redirect , _ios_ddl , _fallback_redirect

基础链接中已定义的任何其他参数也会受到保护。

如何启用（UI）

1. 在 Singular 平台中前往 Links → Manage Links 。
2. 找到您的自定义链接并点击编辑（或创建一个新链接）。
3. 如果您没有看到 Disable short link parameters overrides 开关，请先尝试打开 Shorten Link 。
4. 启用 Disable short link parameters overrides 开关。
5. 保存该链接。

如何启用（API）

通过 Singular Links API 创建或更新链接时也支持此设置。在请求正文中传递 disable_short_link_parameters_overrides 这个可选的布尔参数：

• false （默认）——基础链接中的参数可以通过附加到短链接的方式被覆盖。
• true ——基础链接中已设置的参数将被锁定，无法被覆盖。

如果您使用 Dynamic Short Links API ，任何生成的短链接都会自动从其基础 Singular Link 继承 disable_short_link_parameters_overrides 的值。无需额外配置。

限制

• 此功能 仅适用于自定义（来源）链接 。不适用于合作伙伴链接。
• 这是一项 针对单个链接的设置 。若需在账户级别控制所有链接允许哪些重定向目的地，请参阅 限制覆盖目的地 。

动态深度链接和第三方商店重定向需要进行 URL 编码

对于所有动态深度链接参数和第三方商店重定向参数（例如 _samsung_redirect 或 _android_dl ），URL 编码是 强制性的 。

我们观察到多起案例：客户或合作伙伴在附加 Singular 链接时未对查询参数值进行 URL 编码，导致链接无法正确解析，或意外回退到 Play Store。

为确保在各种设备和浏览器上都能获得一致、可靠的行为，请始终使用经过 URL 编码的值。正确的编码可以：

• 确保动态深度链接的正确解析
• 实现可靠的第三方商店重定向
• 防止意外的回退行为（例如 Play Store 重定向）

示例

正确（已进行 URL 编码）：

&_samsung_redirect=samsungapps%3A%2F%2FProductDetail%2Fnet.singular.deviceassist2

错误（未编码）：

&_samsung_redirect=samsungapps://ProductDetail/net.singular.deviceassist2