对回传进行编码

URL 编码是将复杂 URL 的敏感区段转换为代码的做法,如此便于服务器读取 URL。执行 URL 编码很重要,如果未能正确编码 URL,服务器就会出现错误,导致 Adjust 无法读取并处理参数,可能造成宝贵回传数据的丢失,重定向和后备也可能出现故障。

相同的编码规则适用于回传 URL 和链接 URL。

Adjust URL 编码要求

您只需要对回传 URL 进行编码。

警告:
请勿对 Adjust 链接或链接中的任何推广活动参数进行编码。

您必须始终对以下内容进行编码。要查看更完整的列表,请参考 RFC 3986 说明。

  • 不安全的特殊字符:@, &, +, ,, /, :, ;, =, ?, @, ", <, >, #, %, {, }, |, ``, ^, ~, [, ], `````, (, )
  • 空格 ( )
  • 作为参数值的 URL,如后备 (fallback) URL
  • 参数内含的参数(如安卓安装 referrer 值)

我们建议不要在回传 URL 中使用空格或特殊字符,而是使用下划线。

虽然我们会说明何时需要对 URL 的重要部分进行编码,但您也需要对包含不安全字符的任何参数值进行编码。如果您不确定某个值是否包含不安全字符,请将其输入一个 URL 编码工具。该操作会转换值中的所有敏感字符。

请注意:
无需 对带有花括号 ({ }) 的占位符进行编码。

若您未能正确编码 URL,我们的服务器就会出现错误,导致后备和重定向发生故障,无法读取和处理参数。

示例

回传 URL 中的特殊字符

经编码的 URL务必对 URL 进行编码
未经编码的 URL请勿直接使用
http://callbacks.myserver.com/registration?username=bob_uncle&email=bob.uncle%40mail.com

带有 URL 参数的链接

经编码的 URL务必对 URL 进行编码
未经编码的 URL请勿直接使用
https://app.adjust.com/abc123?redirect=https%3A%2F%2Fwww.mywebsite.com%2Flanding_page

在参数内包含参数的链接

经编码的 URL务必对 URL 进行编码
未经编码的 URL请勿直接使用
https://app.adjust.com/abc123?referrer=adjust_tracker%3Dabc123%26adjust_campaign%3DChristmasCamp59_ChristmasCampId330%26adjust_adgroup%3DAppId48399_SubID%26adjust_creative%3DCreative9383_SubId%26utm_source%3Dadjust_store&adjust_install_callback=www.3rdpartydomain.com%253Fsrc%253Dadjust%2526advertiserId%253D57638%2526password%253D4d13c4dc
请注意:
在本示例中,事实上 URL 中已经含有一个经编码的回传参数,这表示回传 URL 值必须经过双重编码