Мы постоянно публикуем обновления документации, которые могут быть недоступны на вашем языке. Наиболее актуальные сведения содержатся в версии на английском языке.

Кодирование колбэков

Кодирование URL-адресов — это метод преобразования конфиденциальных разделов сложных URL-адресов в код, чтобы их мог прочитать сервер. Кодирование URL-адресов — важный процесс. Неправильная кодировка URL-адреса может привести к ошибке сервера, не позволяющей Adjust прочитать и обработать параметры. Это может привести к потере важны данных колбэка, а также ошибкам в функционировании перенаправления и фолбэков

К URL колбэка и URL ссылки применяются одинаковые правила кодирования.

Требования к кодированию URL в Adjust

Закодировать нужно только URL-адреса колбэков.

Предупреждение:
Не кодируйте URL ссылки Adjust и любые входящие в него параметры кампаний.

Всегда кодируйте следующие символы. Более подробный список приведен в спецификации RFC 3986.

  • Небезопасные специальные символы: @, &, +, ,, /, :, ;, =, ?, @, ", <, >, #, %, {, }, |, ``, ^, ~, [, ], `````, (, )
  • Пробелы ()
  • URL-адреса в качестве параметров (например, URL-адрес резервной страницы)
  • Параметры внутри параметров (например, значение источника ссылки для установки в Android)

Также не рекомендуется использовать в 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-адреса
Незакодированный URL-адресНе используйте в таком виде
https://app.adjust.com/abc123?redirect=https%3A%2F%2Fwww.mywebsite.com%2Flanding_page

URL ссылки с параметрами внутри параметров

Закодированный 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 колбэка должно быть дважды закодировано.