Диплинки: часто задаваемые вопросы
На поведение диплинков в процессе тестирования или в продакшене могут влиять различные факторы. Используйте эту статью для устранения распространенных проблем с диплинками, универсальными ссылками и отложенными диплинками Adjust. Если проблема сохраняется, обратитесь в службу поддержки по адресу support@adjust.com.
Общие проблемы с диплинками
Если ваш диплинк не открывает ожидаемую страницу или возвращает ошибку HTTP 404 «URL не найден», прежде всего проверьте синтаксис и кодировку URL-адреса.
URL-адреса, как правило, имеют следующую структуру: scheme://host:port/path?query-string#fragment-id
Каждая часть URL-адреса имеет определенную функцию. Схема и узел не чувствительны к регистру, а путь и строка запроса чувствительны. Любая ошибка в структуре URL-адреса может помешать ссылке открыться должным образом.
При настройке диплинка:
- Добавляя параметр Adjust в строку запроса URL-адреса, уже содержащую параметры запроса, используйте
&. Не добавляйте второй символ?, так как информация после второго?может быть отброшена. - Если ваша строка запроса закодирована, начните ее с символа
/или убедитесь, что она является частью параметраdeeplink. - Убедитесь, что в параметрах фолбэков, колбэков, идентификаторов устройств или кампаний отсутствуют пробелы или недопустимые символы. Проблемы с кодировкой могут привести к обрезанию параметров.
Пример правильного синтаксиса :
https://example.go.link/my?path=location&client=name&adjust_t=klm012
Пример неправильного синтаксиса:
https://example.go.link/my?path=location&client=name?adjust_t=klm012
Если приложение не установлено, а URL-адрес имеет некорректную структуру, браузер может отбросить параметр adjust_t. Этот параметр требуется Adjust для идентификации источника клика. Без него Adjust возвращает 404 URL not found.
Обычно это означает, что диплинк не смог открыть приложение, поэтому в качестве запасного варианта пользователь был перенаправлен в магазин.
Если требуется устранить неполадки:
- Проверьте ссылку как существующий пользователь.
- Если во время тестирования приложение открывается, проверьте среду, в которой ссылка изначально не сработала.
- Проверьте корректность настройки ваших универсальных ссылок / ссылок на приложение для Android / настраиваемых схем приложения, так как именно эти стандарты ссылок необходимы для открытия приложения.
- Убедитесь, что в фолбэках или колбэках отсутствуют ошибки кодировки, так как они могут привести к отбрасыванию параметров и повреждению ссылки.
Если ссылка открывает приложение, но не открывает нужный экран внутри него, проверьте, вызвана ли проблема настройками ссылки или настройками самого приложения.
Разместите свой диплинк в веб-среде и откройте его с тестового устройства. Если вы используете брендированный домен, протестируйте брендированную ссылку напрямую. Если вы используете устаревшую ссылку Adjust adj.st, вы можете протестировать домен универсальной ссылки (например, https://abcd.adj.st/) или схему приложения, например myapp://.
Если приложение открывается, но путь указан неверно, попросите разработчика подтвердить, что пути внутри приложения настроены корректно.
Примечание. Универсальные ссылки adj.st — это устаревший подход. В новых реализациях рекомендуется использовать брендированные домены.
Атрибуция и отчетность
Нет. 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Для получения данных о кликах по установленным приложениям и реатрибуции через диплинки подключите функцию отслеживания кликов в Adjust SDK для iOS или Android. О диплинках, которые инициируют клики SDK, в отчетах в Datascape сообщается как о кликах; в сырых данных они отображаются как колбэки клика.
Чтобы идентифицировать клики, которые пришли через диплинк, отслеженный в SDK, добавьте плейсхолдер {is_deeplink_click}.
Если данные атрибуции или уровни кампании по URL ссылке с диплинком недоступны, скорее всего, это связано с проблемой настройки. Убедитесь, что параметры идентификатора устройства и параметры кампании (при их наличии) не отбрасываются из-за ошибок кодирования в фолбэках или колбэках. Например, проверьте, что в URL-адресе нет пробелов или недопустимых символов.
Проблемы с универсальными ссылками
Если установки атрибутируются корректно, но ваш партнер не получает атрибутированные колбэки, проверьте настройки универсальной ссылки.
Убедитесь, что:
Параметр идентификатора клика добавлен к универсальной ссылке.В фолбэках и колбэках отсутствуют ошибки кодирования.Параметр идентификатора клика имеет префикс adj_ или adjust_.
Если идентификатор клика отсутствует, имеет некорректный формат или был обрезан из-за проблем с кодировкой, Adjust может атрибутировать установку, но не сможет передать ожидаемые данные колбэка партнеру.
Сначала убедитесь, что универсальные ссылки настроены правильно.
Затем проверьте, откуда Apple открывает ссылку. Apple не разрешает перенаправления на универсальные ссылки вне браузера Safari, поэтому вам необходимо разместить необработанную универсальную ссылку или схему в веб-среде и перейти по ней оттуда.
Если ваше приложение по-прежнему не открывается:
- Откройте тестовую HTML-страницу в Safari и выберите значок «Поделиться». Если вы видите опцию «Открыть в…», в которой указано ваше приложение, значит, конфигурация Associated Domains выполнена корректно, а файл Apple App Site Association был загружен.
- Если приложения нет в списке, удалите и переустановите его.
- Убедитесь, что Bundle ID совпадает в тестовой и рабочей средах.
- Убедитесь, что iOS Bundle ID и App Prefix в AppView указаны верно.
- Если приложение по-прежнему не открывается, попросите разработчика проверить универсальную ссылку или схему привязки приложения.
Также проверьте, содержит ли ваша ссылка target="_blank". Это может работать на этапе тестирования, но отказать в продакшене. Удалите атрибут из ссылки.
Убедитесь, что к универсальной ссылке добавлен путь. Если путь отсутствует, пользователь попадет в магазин, даже если приложение установлено. Указанный путь необязательно должен быть действительным.
В большинстве случаев iOS не разрешает переадресацию по универсальным ссылкам за пределами браузера Safari. Это касается и сред, использующих SFSafariViewController.
Поскольку ссылки из электронных писем могут открываться в самых разных средах (включая браузеры и почтовые клиенты, не поддерживающие универсальные ссылки), Adjust рекомендует использовать JSR-ссылки или интеграцию Adjust с ESP.
Диплинки с параметром deeplink
В кампаниях, проводимых через публикации на Facebook, нужно использовать URL-адрес ссылки Adjust с добавлением параметра deeplink. Параметр deeplink также должен содержать путь. Если путь отсутствует, пользователь может быть перенаправлен в магазин, даже если приложение уже установлено. Указанный путь необязательно должен быть действительным.
Пример: https://app.adjust.com/abc123?deeplink=adjust%3A%2F%2Fsuch_path.
Отложенные диплинки
Отложенный диплинк используется в тех случаях, когда пользователь нажимает на диплинк до того, как установил приложение. После установки приложение должно открыться в заданном местоположении внутри приложения.
Если отложенный диплинк не открывает нужное местоположение:
- Проверьте, существует ли путь в приложении.
- Разместите схему приложения (например,
myapp://) в веб-среде и перейдите по ссылке оттуда. - Если путь не работает для существующего пользователя, попросите вашего разработчика подтвердить, что пути внутри приложения настроены корректно.
- Если путь работает для существующего пользователя, но не работает для нового, проверьте устройство в Тестовой консоли и убедитесь, что оно было атрибутировано клику.
- Если устройство не атрибутировано, «забудьте» его на тестовой консоли и выполните тест снова.
- Если устройство было атрибутировано, проверьте, содержит ли оно параметр
deeplink. - Если параметр
deeplinkотсутствует, убедитесь в отсутствии проблем с кодировкой или специальными символами, которые могут обрезать URL-адрес. - Если параметр
deeplinkприсутствует, но путь отсутствует, обратитесь в службу поддержки Adjust.
Иногда во время тестирования отложенный диплинк остается на некоторое время после клика, даже если устройство было «забыто» на Тестовой консоли.
Это может произойти, если вы:
- Кликнули по диплинку, установили приложение и открыли его.
- Удалите приложение.
- «Забыли» устройство на тестовой консоли.
- Выполнили другой тест, а отложенный диплинк по-прежнему не работает.
Чтобы устранить эту проблему, снова удалите приложение, снова удалите устройство из тестовой консоли и повторно запустите тест.