Введение
OneLink™ — это уникальная ссылка для атрибуции, созданная AppsFlyer. С помощью этой ссылки рекламодатели могут реализовать сразу три основных функции:
- Определение устройства и перенаправление: при нажатии на ссылку OneLink определяется тип устройства (Android, iOS, ПК и т. п.) и выполняется перенаправление пользователя в соответствующий пункт назначения.
- Глубинные ссылки: если рекламируемое мобильное приложение уже установлено, то после перехода по URL-адресу OneLink может обеспечить запуск этого приложения и (или) предоставить пользователю персонализированный контент (например, направить пользователя на определенное действие или определенную страницу в приложении).
- Отложенный диплинкинг: еслирекламируемое мобильное приложение не установлено, OneLink предоставляет пользователю персонализированный контент (например, направляет пользователя на определенное действие или страницу в приложении) при первом запуске приложения после установки.
Рекламодатели, как правило, применяют OneLink в своих собственных медиаисточниках, таких как электронная почта, СМС-кампании, баннеры на веб-страницах и целевые страницы, вирусная реклама в социальных сетях и даже QR-коды на печатных плакатах. Кроме того, OneLink можно использовать с интегрированными партнерами.
В этом руководстве описаны основные настройки OneLink, необходимые для использования функции идентификации устройств и перенаправления пользователей.
После выполнения основных настроек можно выполнить и другие настройки, описанные в Пошаговом руководстве по глубинным ссылкам.
Пример
Компания OfigenCom выпустила новое приложение для устройств Android и iOS. Катя, маркетолог по мобильным приложениям, решила запустить СМС-кампанию, используя базу номеров мобильных телефонов, которая есть у компании OfigenCom. СМС-сообщение содержит призыв к действию и только одну ссылку OneLink..
Все пользователи устройств Android при нажатии на ссылку направляются на страницу приложения на веб-сайте Google Play. А все пользователи устройств iOS при нажатии на эту же ссылку направляются на страницу приложения на веб-сайте iTunes.
Благодаря OneLink в ходе кампании 23,5% зарегистрированных пользователей OfigenCom стали пользователями мобильного приложения!
Процесс идентификации устройств и перенаправление пользователей
Когда пользователь нажимает на своем устройстве ссылку OneLink, выполняются следующие действия:
- Пользователь перенаправляется на серверы AppsFlyer.
- URL-адрес нажатой ссылки и ее параметры сохраняются на серверах для последующей атрибуции и глубинного связывания в случае, если пользователь установит приложение.
- Сразу же после этого на основеагента пользователяопределяется тип устройства.
- Затем пользователь перенаправляется в пункт назначения, заданный в настройках шаблона OneLink (см. ниже), в соответствии с типом используемого устройства.
Для реализации описанной процедуры необходимо выполнить настройку OneLink, которая состоит из двух этапов:
Примечание
В OneLink также реализована поддержка следующих платформ:
- Android — телевизоры Smart TV на основе Android;
- Apple — Apple TV (tvOS);
- Amazon Fire TV — для телевизоров Amazon Fire TV используйте вариант с пользовательским URL-адресом на APK для Android;
- Windows — все устройства на платформе Windows, в том числе Xbox.
Настройка шаблона OneLink
Шаблон OneLink содержит набор различных пунктов назначения, заданных для каждого типа устройства.
После выполнения основных настроек можно создать множество пользовательских ссылок с различными параметрами, которые направят пользователя в одни и те же пункты назначения, заданные в шаблоне OneLink (если пункты назначения не были переопределены).
Шаблон OneLink удалить нельзя. Если нужно удалить шаблон OneLink, обратитесь к своему менеджеру по работе с клиентами или напишите нам по адресу hello@appsflyer.com.
Для каждого мобильного приложения, зарегистрированного в учетной записи AppsFlyer, можно создать несколько шаблонов OneLink. Сведения о назначении приложения нескольким шаблонам OneLink приведены тут.
Важно!
Хотя мобильное приложение можно задать в нескольких шаблонах OneLink, в большинстве случаев необходимости в этом нет. Обычно приложение достаточно настроить ОДИН РАЗ в шаблоне OneLink.
Используйте эту настройку для создания нескольких пользовательских ссылок атрибуции, которые отличаются разными атрибутами, но ведут к одним и тем же местам назначения.
Страница списка OneLink
Страница списка OneLink находится внутри учетной записи. Это означает, что она используется всеми приложениями и содержит все шаблоны OneLink для учетной записи.
1. Чтобы открыть окно списка OneLink, вызовите панель управления любого из своих приложений, найдите раздел Engagement & Deep Linking (Вовлечение и диплинкинг) и выберите OneLink Configuration (Настройка OneLink).
Каждая сгенерированная ссылка OneLink имеет уникальный идентификатор (при условии, что определен поддомен OneLink): http://myapp.onelink.me/onelinkid.
Каждая ссылка OneLink также имеет собственное имя, заданное пользователем.
2. Чтобы создать новый шаблон OneLink, нажмите .
3. Чтобы открыть уже созданный шаблон OneLink, нажмите на соответствующее имя ссылки OneLink.

Примечание
Настроенные шаблоны OneLink удалить невозможно, так как все ссылки атрибуции, основанные на удаленном шаблоне OneLink, перестанут работать, и пользователи будут попадать на страницу 404 ("Страница не найдена").
Вместо этого можно просто отредактировать имеющиеся шаблоны OneLink.
После выбора одного из имеющихся шаблонов OneLink или создания нового открывается страница настройки OneLink
Страница настройки OneLink
На этой странице можно задать пункты назначения для телефонных аппаратов с ОС iOS, Android и Windows. Кроме того, можно задать пункты назначения с дополнительными параметрами. Ниже даны описания каждой настройки.
Имя шаблона OneLink
На этой странице можно задать имя ссылки OneLink. Желательно, чтобы это имя указывало на приложение, включенное в шаблон. Это необязательно, однако если имя не будет задано, шаблону будет присвоено стандартное имя "Untitled OneLink" (OneLink без названия).
Имя шаблона OneLink можно изменить в любое время.
Приложения для iOS
Выберите в раскрывающемся меню приложение для iOS, на которое нужно направить пользователя в магазине App Store.
Дополнительные параметры
-
Настраиваемая целевая страница
Чтобы направить пользователей устройств iOS не в App Store, а в другой пункт назначения, задайте URL-адрес в поле Custom iOS Landing Page (Настраиваемая целевая страница для iOS).
Чтобы настроить другие дополнительные параметры, предназначенные для пользователей iOS, установите переключатель Enable Universal Links for deep linking (Включить универсальные ссылки для глубинных ссылок) в положение On (Вкл.).
-
Префикс идентификатора приложения
Ключ-идентификатор в заголовке приложения
-
Тестовые приложения для iOS
Если при разработке приложения для iOS используется тестовое приложение, то его можно проверить с помощью OneLink.
Заполните поле префикса идентификатора приложения (App ID) (см. пункт 2) и поле идентификатора пакета для приложения iOS (Bundle ID), которые определены в XCode.
Примечание
Оба значения можно найти на веб-сайте developers.apple.com в разделе Identifiers >> App IDs. Просто нажмите на соответствующий зарегистрированный идентификатор App ID, как показано на рисунке.
- iPad
Если приложение для iOS включает отдельную версию для iPad, то на него можно направлять пользователей iPad. Чтобы направить пользователей iPad на нужное приложение в App Store, откройте в своей учетной записи раскрывающееся меню для iPad и выберите соответствующее приложение iOS.
Приложения для Android
Выберите в раскрывающемся меню приложение для Android, на которое нужно направить пользователя в магазине Google Play.
Custom Android APK URL (Пользовательский URL-адрес файла APK для Android)
- Если ваше приложение для Android находится не в магазине Google Play, а в другом месте, вставьте в этом окне ссылку на свое приложение, по которой будут направляться пользователи устройств Android.
- Enable App Links for deep linking (Включение ссылок на приложения для глубинного связывания)
Ссылки на приложения — это дополнительный метод глубинного связывания для устройств Android, который поддерживается в ОС Android начиная с версии 6.0. Подробные инструкции см. здесь.
Приложения для Windows Phone
Выберите в магазине Windows Phone приложение, на которое нужно направлять пользователей, вставьте его URL-адрес в поле Custom Windows Phone URL (Настраиваемый URL-адрес приложения Windows Phone).
Дополнительные настройки

Примечание
Поле поддомена диплинкинга (iOS9/Android 6 и выше) не должно содержать символ точки ("."). Например, MyApp допускается, а com.MyApp — нет.
Kindle Fire: введите код ASIN для магазина Amazon или особый URL-адрес пользователей Kindle Fire.
Website URL (URL-адрес веб-сайта): введите любой целевой URL-адрес для пользователей ПК.
Примечание
Описание двух первых дополнительных настроек см. в Руководстве по глубинным ссылкам.
Создание настраиваемых ссылок с помощью шаблона OneLink
После создания шаблона OneLink можно с его помощью формировать ссылки атрибуции с разнообразными параметрами. Такие ссылки атрибуции могут отличаться названиями исходных точек взаимодействия или кампаний (например, электронная почта, веб-сайт, баннеры и т. п.), однако основные перенаправления OneLink будут общими для всех ссылок (если они не были переопределены).
Ссылки атрибуции OneLink можно создать вручную в окне настройки пользовательских ссылок атрибуции. Дополнительные сведения см. здесь.
Кроме того, если нужно создать ссылки атрибуции OneLink автоматически или в большом количестве, можно использовать API OneLink REST.
Шаблон OneLink удалить нельзя. Если нужно удалить шаблон OneLink, обратитесь к своему менеджеру по работе с клиентами или напишите нам по адресу hello@appsflyer.com.
Тестирование перенаправления с помощью ссылок OneLink
Чтобы протестировать только что настроенный шаблон OneLink, выполните описанные ниже действия.
1. Создайте многоплатформенную пользовательскую ссылку атрибуции "test".
2. Выберите конфигурацию OneLink, для которой предназначена ссылка атрибуции.
3. Укажите названия исходной точки взаимодействия и кампании. Можно создать несколько разных ссылок для каждого типа тестирования в отдельности. Однако AppsFlyer рекомендует использовать для всех ссылок имя исходной точки взаимодействия test.
Совет
Для всех типов тестирования с помощью AppsFlyer обязательно используйте название исходной точки взаимодействия test (&pid=test) — тогда результаты тестирования можно будет увидеть в окне исходной точки взаимодействия test. Добавьте тип тестирования к параметру имени кампании (&c={test type}, например &c=redirections), чтобы различать между разными типами тестов по параметру названия кампании.
4. Сгенерируйте ссылку атрибуции и используйте длинный или короткий URL-адрес для тестирования.
Пример:
https://go.onelink.me/{AUTO_GENERATED}?pid=test&c=redirections
5. Для каждой версии ОС, зарегистрированной на странице настройки OneLink, выполните следующие действия:
- Отправьте тестовый URL-адрес на соответствующее устройство из белого списка в сообщении электронной почты, в виде QR-кода и т. д.
- Нажмите на тестируемый URL-адрес и убедитесь, что выполнено перенаправление устройства в заданный пункт назначения (Google Play, iTunes, веб-страница и т. д.).
- Установите мобильное приложение на устройстве и запустите его.
- Проверьте результат — на обзорной странице панели управления откройте окно канала взаимодействия "test" и найдите сведения о новом переходе по ссылке и установке приложения в данных о кампании, имя которой было задано в URL-адресе (например, "redirections").
Предупреждение
Успешное выполнение описанного выше теста означает только то, что приложение готово к выполнению перенаправлений с помощью OneLink. Описание тестирования глубинных ссылок см. в этой статье.
Переопределение пунктов назначения в шаблоне OneLink
Хотя перенаправления, заданные в шаблоне OneLink, являются общими для всех ссылок атрибуции, которые их используют, эти перенаправления можно изменить с помощью настраиваемых параметров. Если использовать в ссылках атрибуции описанные ниже параметры, то пользователи, переходящие по ссылке, вместо пунктов назначения, заданных в шаблоне, будут перенаправлены в пункты назначения, заданные в ссылке.
Параметры пунктов назначения
Имя параметра пункта назначения | Описание | Совет AppsFlyer |
---|---|---|
af_ios_url | Перенаправление пользователей iOS на другую веб-страницу вместо страницы приложения в iTunes. | Используйте его для перенаправлений на целевые страницы или в качестве резервного варианта на случай сбоя диплинкинга. |
af_android_url | Перенаправление пользователей устройств Android на другой URL-адрес вместо страницы приложения на Google Play. | Используйте его для перенаправлений на целевые страницы или в качестве резервного варианта на случай сбоя диплинкинга. |
af_r | Перенаправление пользователей на указанный URL-адрес во всех операционных системах и платформах | Используется для перенаправления на целевые страницы |
af_web_dp | Перенаправление пользователей ПК на другую веб-страницу вместо заданной в шаблоне OneLink. | Используется для получения данных атрибуции для пользователей ПК на других платформах (например, Google Analytics или Omniture). |
af_dp | Путь для действий в приложении, по которому пользователи направляются с помощью глубинной ссылки. | Используется для глубинных ссылок и ретаргетинга |
af_ios_fallback | Резервный URL-адрес для пользователей iOS 10.3 и последующих версий. | Используйте в случае нарушений процесса для пользователей iOS 10.3. |
af_param_forwarding | Если задано значение "false", ни один из параметров OneLink не передается на страницу, указанную для перенаправления. | Этот параметр можно использовать, чтобы URL-адрес на странице перенаправления выглядел аккуратнее, или в тех случаях, когда параметры OneLink могут вызвать проблемы в связи с обработкой параметров запроса на странице перенаправления. |
Предупреждение
Не используйте следующие символы в качестве части значений параметров пункта назначения (даже в кодировке URL). Их использование препятствует действиям перенаправления или диплинкинга OneLink.
Это следующие символы: []<>;(){}'`"
Пример
При нажатии на приведенную в примере ссылку пользователи устройств Android направляются на google.com, а не на заданную страницу приложения на веб-сайте Google Play. А пользователи устройств iOS направляются на apple.com.
https://go.onelink.me/{AUTO_GENERATED}pid=test&c=redirections&
af_android_url=http%3A%2F%2Fwww.google.com&
af_ios_url=http%3A%2F%2Fwww.apple.com
OneLink и социальные сети
Рекламодателям может понадобиться использовать OneLink для "вирусной" рекламы в социальных сетях, поскольку потенциальных пользователей, которые просматривают такую рекламу, невозможно заранее выявить в соответствии с типом используемых устройств.
К сожалению, ограничения, установленные, главным образом, в универсальных ссылках Apple, в сочетании с ограничениями некоторых социальных сетей, не позволяют использовать OneLink для глубинного связывания, а иногда и для обычной идентификации устройств, перенаправления и атрибуции.
В этой таблице показано, какие действия можно выполнять в популярных социальных сетях с помощью OneLink.
Социальная сеть | Перенаправление для устройств Android | Глубинные ссылки для устройств Android | Перенаправление для устройств iOS | Глубинные ссылки для устройств iOS |
---|---|---|---|---|
Y | При определенных условиях | Y | При определенных условиях | |
Facebook Messenger | Y | При определенных условиях | Y | При определенных условиях |
Snapchat | Y | При определенных условиях | Y | При определенных условиях |
Y | Y | Y | N | |
Line | Y | Y | Y | N |
N | N | N | N | |
Slack | Y | При определенных условиях | Y | При определенных условиях |
Y | При определенных условиях | Y | При определенных условиях | |
Да (см. WeChat — вопросы и ответы) |
N | N | N | |
Y | Y | Y | Y |
Обходные решения для социальных сетей
Чтобы обойти упомянутые выше ограничения для OneLink, сохранив возможность перенаправления устройств на сообщения в социальных сетях, рекомендуется использовать целевые страницы.
Схема действий пользователя:
- Создайте целевую страницу с кнопкой Download app (Загрузить приложение), связанной с OneLink.
- Опубликуйте ссылку на целевую страницу в приложении социальной сети.
- Пользователь нажимает на ссылку, ведущую на целевую страницу в публикации в приложении социальной сети.
- Пользователь перенаправляется на целевую страницу.
- На целевой странице должна быть кнопка Download app (Загрузить приложение), связанная с соответствующей ссылкой OneLink. Пользователь нажимает кнопку.
- После этого выполняется обычная процедура OneLink, в том числе глубинное связывание и атрибуция по идентификационным отпечаткам.
Примечание
Показатели конверсий для целевых страниц могут быть немного меньше, чем для исходных источников из-за того, что пользователям нужно нажимать на ссылку дважды.
Чтобы узнать больше об атрибуции пользователей мобильных устройств, переходящих с Facebook на целевые страницы, перейдите сюда.
Выполнение диплинкинга с публикаций в социальных сетях с помощью OneLink описано в руководстве по диплинкингу.
Использование OneLink с интегрированными сетями
OneLink используется главным образом не для рекламным сетей, а для собственных каналов взаимодействия.
OneLink редко требуется для рекламных сетей, поскольку там обычно используется реклама в приложениях. Это позволяет им определять платформу пользователя, идентификатор устройства и т. п., поэтому вполне достаточно самого приложения и ссылок атрибуции с учетом определенной платформы.
Однако в некоторых случаях рекламные сети не знают заранее, с какими платформами работают их пользователи, например если в такой сети запускается собственная почтовая рассылка или СМС-кампания.
Важно!
OneLink с интегрированными сетями требует использования длинной версии OneLink.
Настройка OneLink для использования с интегрированными сетями
- На панели управления своего приложения для Android откройте окно Integrated Partners(Интегрированные партнеры) и выберите соответствующую рекламную сеть.
- Скопируйте ссылку атрибуции этого приложения из окна настроек и сохраните ее во внешнем документе.
- Повторите действия 1 и 2 для приложения под iOS.
После этого сформируйте ссылку атрибуции.
- Проверьте, правильно ли настроена ссылка OneLink.
-
Создайте основной URL-адрес ссылки OneLink в окне Custom Attribution Link (Пользовательская ссылка атрибуции) и сохраните ее во внешнем документе. При создании основного URL-адреса назовите исходную точку взаимодействия "test".
- После нажатия кнопки "Generate Link" (Создать ссылку) вы увидите такой экран:
- Скопируйте длинную ссылку.
- В длинной ссылке замените медиаисточник "test" на точный идентификатор PID интегрированного партнера — в результате ссылка будет выглядеть так: https://greatapp.onelink.me/U8ru?pid=network_int&c=MyCampaign
-
Добавьте ВСЕ параметры из ОБЕИХ ссылок атрибуции.
Если такие ссылки атрибуции для приложений под iOS и Android совпадают, просто скопируйте параметры из одной из ссылок. Если же нет, то убедитесь, что добавлены все параметры из обеих ссылок.
Если все параметры для интегрированной сети добавлены правильно, то после нажатия на ссылку OneLink и перенаправления на соответствующую платформу нужные параметры будут отправлены в сеть в виде обратной передачи, когда пользователь установит приложение.
Пример
https://greatapp.onelink.me/3287867539?pid=network_int&c=email&
idfa{$IDFA}&gaid={$GAID}&clickid=$SITEID&
af_sub1=[pixel_code]&af_sub2=[creative]
В сети может использоваться либо параметр IDFA, либо параметр GAID — это зависит от платформы устройства пользователя. При этом другой параметр игнорируется.
Вопросы и ответы
Да. Если в текст файла в формате HTML вставить тег href с кодом target="_blank"
, то перенаправления в магазин Google Play не произойдет.
Да. В Instagram есть несколько ограничений.
- В Instagram текст сообщения отображается на странице таким образом, что ссылка в заголовке сообщения будет недоступна.
- Описания профилей Instagram не поддерживают интерактивные ссылки.
- Связывание с помощью ссылок в веб-профиле возможно, однако такая ссылка всегда направляет пользователя в магазин App Store, поскольку универсальные ссылки в Instagram не поддерживаются (только для iOS).
Решить эту проблему можно таким образом: OneLink распознает нажатие в WeChat и загружает специальную целевую страницу, где пользователю предлагается нажать кнопку выбора действия и выбрать вариант Open in Browser (Открыть в браузере). При этом выполняется переход по URL-адресу, заданному в настройках OneLink.
Если в профиле пользователя WeChat зарегистрирован язык интерфейса "китайский", то OneLink формирует локализованную версию целевой страницы.