Диплинки: часто задаваемые вопросы
На характер работы с диплинками могут влиять разные факторы. Если во время тестирования диплинков или работы с ними вы получаете неожиданные результаты, обратитесь к этому руководству. Если у вас еще остались вопросы, обратитесь в службу поддержки по адресу support@adjust.com.
Общие проблемы
Правильные ли синтаксис и кодировка у моего 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}.
Устранение неполадок диплинков с использованием ссылки и параметра deep_link
Почему мой диплинк не работает из публикации на Facebook?
В кампаниях, проводящихся с использованием публикаций на Facebook, нужно использовать URL ссылки Adjust с добавлением параметра deeplink. Кроме того, к параметру deeplink должен быть добавлен путь, иначе пользователь будет перенаправлен в магазин (даже если приложение установлено). Указанный путь необязательно должен быть действительным.
Пример параметра с добавленным путем: https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path
Устранение неполадок с отложенными диплинками
Почему мой отложенный диплинк не открывает приложение в нужном месте после установки?
Если отложенный диплинк не ведет по правильному пути в приложении после установки, сначала проверьте, существует ли этот путь на самом деле. Разместите схему (myapp://) в веб-среде и нажмите на нее оттуда, чтобы проверить, в чем проблема — в ссылке или настройке приложения. Свяжитесь с разработчиком, чтобы убедиться, что пути в приложении настроены правильно.
Если как существующий пользователь вы идете по правильному пути, а как новый — нет, проверьте свое устройство с помощью Тестовой консоли и убедитесь, что по клику произошла атрибуция. Если нет, «забудьте» это устройство на «Тестовой консоли» и попробуйте снова.
Если по клику произошла атрибуция, проверьте, включает ли ваше устройство параметр deeplink. Если нет, проверьте, нет ли проблем с кодировкой или специальными символами, которые отсекают URL-адрес перед параметром deeplink.
Наконец, если параметр deeplink включен, убедитесь, что путь существует. Если путь отсутствует, значит, по каким-то причинам он был обрезан. Обратитесь за помощью по адресу support@adjust.com.
Почему мой отложенный диплинк не работает, после того как устройство было забыто?
Иногда во время тестирования отложенный диплинк остается на некоторое время после клика, даже если устройство было «забыто» на Тестовой консоли.
Если такое происходит, результат теста может выглядеть следующим образом.
- Вы кликнули по диплинку, установили приложение и открыли его.
- Вы отменили установку приложения.
- Вы «забыли» устройство на Тестовой консоли.
- Вы выполнили другой тест (клик, установка, открытие), а отложенный диплинк по-прежнему не работает.
В этом случае снова удалите приложение, «забудьте» свое устройство на тестовой консоли, а затем повторите тест. После этого отложенный диплинк снова должен работать правильно.