FAQ по универсальным ссылкам
На характер работы универсальной ссылки могут влиять различные факторы. Если во время тестирования универсальных ссылок или работы с ними получены неожиданные результаты, обратитесь к этому руководству. Если проблема не решилась, свяжитесь с нами.
Общие проблемы
Правильные ли синтаксис и кодировка у моего URL-адреса?
Если диплинк не ведет в указанное местоположение или выдает ошибку HTTP 404, сначала проверьте синтаксис и кодировку вашего URL-адреса.
В URL обычно используется следующий синтаксис: scheme://host:port/path?query-string#fragment-id
Каждая часть URL-адреса выполняет разные функции и использует определенные символы для идентификации и разделения значений. Схема и узел не чувствительны к регистру, а путь и строка запроса чувствительны. Если в URL-адресе допущена ошибка, ссылка должным образом не откроется.
Обратите внимание на следующие условия при создании диплинков:
- Чтобы добавить параметр Adjust в строку запроса URL-адреса, которая уже содержит параметры запроса, используйте
&. В противном случае вся информация после второго?в 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 | Открывает определенную страницу приложения |
| Универсальная ссылка | https://abcd.adj.st/%3Fpath?adjust_t=r40ncx7 | Открывает определенную страницу приложения |
| Универсальная ссылка | https://abcd.adj.st/?path&adjust_t=r40ncx7 | Запускает приложение, если оно уже установлено, но не может открыть в нем определенную страницу. |
| Универсальная ссылка | https://abcd.adj.st%3Fpath?adjust_t=r40ncx7 | Недействительна и выдает ошибку |
Почему я не вижу данные атрибуции и/или уровни кампаний?
Если данные атрибуции или уровни кампании по URL ссылке с диплинком не доступны, скорее всего, это связано с проблемой настройки. Убедитесь, что параметры идентификатора устройства и параметры кампании (при их наличии) не отбрасываются из-за ошибок кодирования в фолбэках или колбэках. Например, проверьте, что в URL-адресе нет пробелов или недопустимых символов.
Почему меня перенаправляют в магазин, даже если приложение установлено?
Обычно это свидетельствует о том, что переход по диплинку не смог открыть приложение, поэтому в качестве альтернативы было совершено перенаправление в магазин. Чтобы проверить этот вариант, выполните следующие действия:
Следуйте нашим инструкциям по тестированию универсальных ссылок и ссылок с параметром deep_link для существующих пользователей.
Если тестирование завершилось успешно и приложение открывается, определите, в каких условиях произошел сбой при переходе по диплинку. Уточните, требуется ли в такой ситуации использование дополнительных параметров.
- Например, если универсальная ссылка JSR нажимается из Slack, должен быть установлен флаг
adjust_deeplink_js=1. Это позволит загрузить схему до перенаправления в магазин. Если ссылка не работает даже при наличии флагаadjust_deeplink_js, возможно, ваша схема приложения неправильно введена в Campaign Lab.
- Например, если универсальная ссылка JSR нажимается из Slack, должен быть установлен флаг
Проверьте, что в URL ссылке нет ошибок кодирования фолбэков или колбэков, которые могли бы повредить ссылку. Это может стать причиной сбрасывания параметров. Если параметры будут сброшены, вся ссылка перестанет работать должным образом.
Почему переход по диплинку не открывает приложение в нужном месте?
Если ссылка не открывается в нужном месте, но открывается приложение, проверьте, что является причиной проблемы: ссылка или настройки приложения.
- Разместите домен (
https://abcd.adj.st/) или схему (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Чтобы получать данные о кликах для приложений, которые уже установлены, а также для реатрибуции диплинков, убедитесь, что реализован клик в SDK с использованием пакета Adjust SDK (iOS; Android).
О диплинках, которые инициируют клики SDK, в отчетах в Datascape сообщается, как о кликах. Они также видны в сырых данных при использовании колбэка click. Для получения представления с детализацией того, какие из кликов были получены в результате клика SDK с диплинком, включите параметр {is_deeplink_click}.
Проблемы с универсальными ссылками
Почему моя универсальная ссылка не открывает установленное приложение?
Проверьте правильность настройки универсальных ссылок.
Проверьте, из какой среды Apple открывает ссылку. Apple не разрешает перенаправления на универсальные ссылки за пределами Safari, поэтому вам необходимо разместить необработанную универсальную ссылку или схему в веб-среде. Например,
https://abcd.adj.st/илиmyapp://, соответственно.Установив приложение на тестовое устройство, зайдите на страницу, где размещена необработанная универсальная ссылка или схема, и выберите ее.
Если приложение не открывается :
- Откройте тестовую HTML-страницу в Safari и выберите значок «Поделиться». Должно появиться меню «Открыть в...», в котором в качестве одного из вариантов указано ваше приложение. Если появится это сообщение, значит конфигурация связанных доменов верна и файл Apple App Site Association (AASA) был загружен правильно. Если вы не видите эту опцию, может потребоваться удалить и заново установить приложение.
- Убедитесь, что идентификатор приложения при тестировании и в производстве совпадают.
- Проверьте правильность идентификатора приложения iOS и префикса приложения в AppView. Если они настроены правильно, но приложение все равно не открывается, обратитесь к разработчику для дальнейшего изучения проблемы с универсальной ссылкой или схемой привязки приложения.
- Проверьте, является ли атрибут
target=“_blank”частью вашей ссылки.
Это может привести к открытию приложения при тестировании, но не в производственной среде.
Например, с атрибутом target=“_blank” HTML-код может выглядеть следующим образом:
<a href="[https://abcd.adj.st](https://abcd.adj.st/)" target="_blank">Universal Link to App</a>
Для решения этой проблемы удалите атрибут, как показано в следующем примере:
<a href="[https://abcd.adj.st](https://abcd.adj.st/)">Universal Link to App</a>
Почему меня перенаправляют в магазин, даже если мое приложение установлено?
- Следуйте инструкциям по тестированию универсальных ссылок. Также выполните действия, описанные выше в разделе «Почему моя универсальная ссылка не открывает установленное приложение?».
- Изучите, в какой среде была нажата универсальная ссылка, когда она не сработала. Затем проверьте, требуются ли для этого экземпляра какие-либо дополнительные параметры.
- Например, если универсальная ссылка JSR нажимается из Slack, должен быть установлен флажок
adjust_deeplink_js=1. Это позволит загрузить схему до перенаправления в магазин. Если ссылка не работает даже при наличии флажкаadjust_deeplink_js, возможно, ваша схема приложения неправильно указана в настройках приложения в AppView.
- Например, если универсальная ссылка JSR нажимается из Slack, должен быть установлен флажок
Почему диплинкинг или отложенный диплинкинг не открывает приложение в нужном месте после установки?
Если ссылка не открывается в нужном месте, но открывается приложение, проверьте, что является причиной проблемы: ссылка или настройки приложения.
- Разместите домен (
https://abcd.adj.st/) или схему (myapp://) универсальной ссылки в веб-среде и нажимайте на нее оттуда. - Свяжитесь с разработчиком, чтобы убедиться, что пути в приложении настроены корректно.
Если как существующий пользователь вы идете по правильному пути, а как новый — нет, проверьте свое устройство с помощью тестовой консоли и убедитесь, что по клику произошла атрибуция. Если нет, «забудьте» это устройство на тестовой консоли и попробуйте снова.
Если по клику произошла атрибуция, проверьте, включает ли ваше устройство параметр deeplink. Если нет, проверьте, нет ли проблем с кодировкой или специальными символами, которые отсекают URL-адрес перед параметром deeplink.
Наконец, если параметр deeplink включен, убедитесь, что путь указан правильно. Если нет, значит путь по каким-то причинам был обрезан. Обратитесь за помощью по адресу support@adjust.com.
Почему моя универсальная ссылка не работает при переходе из публикации в Facebook или Instagram?
Убедитесь, что к универсальным ссылкам добавлен путь. В противном случае пользователь попадет в магазин, даже если приложение установлено. Указанный путь необязательно должен быть действительным.
Пример параметра с добавленным путем: https://abcd.adj.st/path?adjust_t=abc123
Могу ли я использовать универсальные ссылки в кампаниях по электронной почте?
По большей части iOS не разрешает переадресацию по универсальным ссылкам за пределами браузера Safari. Это сказывается на любой среде, использующей SFSafariViewController.
Существует много сред, в которых может быть открыто письмо, таких как браузер или другое приложение для работы с электронной почтой, которое не поддерживает универсальные ссылки. В итоге лучшим решением является использование JSR-ссылок, или одной из ESP-интеграций от Adjust.
Почему я не вижу данные атрибуции и/или уровни кампаний?
Проверьте, имеют ли параметры Adjust префикс adjust_ или adj_. Любые параметры Adjust без префикса adjust_ или adj_ удаляются, и вы не сможете видеть данные из этих параметров.
Почему мой партнер не получает колбэки с атрибуцией, даже если установки атрибутированы правильно?
- Проверьте, добавлен ли параметр идентификатора клика в универсальную ссылку.
- Проверьте, что в URL‑ссылке нет ошибок кодирования фолбэков или колбэков, которые могли бы повредить ссылку.
- Убедитесь, что перед параметром идентификатора клика указан префикс
adj_илиadjust_
Почему у меня возникают проблемы с универсальными ссылками JSR в Safari для iOS 12.2 и 12.3?
Для iOS 12.2 и 12.3 универсальные ссылки JSR не всегда открываются должным образом при нажатии на них в среде Safari. Особенно это касается случаев, когда HTTP-заголовок источника ссылки не читается, например при использовании режима инкогнито.
Для кампаний в Safari рекомендуется использовать необработанные универсальные ссылки. Однако это не будет работать для кампаний по электронной почте с обернутыми URL-адресами.
Начиная с iOS 13+ эта проблема не возникает, поскольку к схеме можно применить переход на резервную страницу. Однако в этом случае появляется дополнительное всплывающее окно.