Нацеливание
Нацеливание позволяет увидеть баннер, добавленный в Adfox, независимо от выставленных ограничений и таргетингов. Эта функция полезна для:
- тестирования размещения баннера на сайте, в приложении или на Smart TV;
- снятия скриншотов креатива;
- отладки кода баннера или интеграции SDK или плеера;
- проверки работы кампании «как у реального пользователя».
Нацелиться можно на:
- флайт в суперкампании;
- баннер;
- рекламную кампанию (на вкладке OLD).
Способы нацеливания
Выберите способ в зависимости от того, где вы хотите проверить показ баннера.
|
Способ нацеливания |
Где работает |
Когда использовать |
|
В браузере |
Десктопные браузеры с поддержкой cookie |
Быстрая проверка баннера на сайте в текущем браузере |
|
Через URL-параметры |
Любые браузеры, включая Safari; S2S-интеграции |
Cookie недоступны или заблокированы; нужно передать ссылку коллегам |
|
На устройстве |
Мобильные приложения (In-App), Smart TV, CTV |
Проверка баннера в приложении или на телевизоре |
Нацеливание в браузере
Нацеливание через браузер устанавливает cookie. Adfox использует их, чтобы определить, что именно вам нужно показать нацеленный объект.
Как это работает:
- Выберите Нацелиться в браузере на странице объекта или в списке кампаний. В текущем браузере установится cookie для нацеливания.
- Перейдите на сайт, где размещен баннер: нацеленный объект будет показываться в течение 15 минут. Вместо нацеливания в текущем браузере вы можете скопировать ссылку нацеливания и передать ее коллегам.
Ссылку можно сгенерировать в течение 24 часов, количество вызовов не ограничено. Нацеливание действует 15 минут после генерации ссылки.
Важно
Нацеливание через cookie не работает в браузерах, которые блокируют запись cookie (Safari, браузеры с усиленной приватностью). В этих случаях пользуйтесь нацеливанием через URL-параметры.
Нацеливание через URL-параметры
Нацеливание через URL-параметры не требует cookie — параметры добавляются прямо в адрес страницы. Этот способ подходит для браузеров без поддержки cookie (Safari, браузеры с усиленной приватностью) и для S2S-интеграций.
Как это работает:
-
Выберите Нацелиться через URL-параметры на странице объекта или в списке кампаний.
-
В открывшемся окне укажите URL страницы, на которой размещен баннер. Ниже появится ссылка для предпросмотра с параметрами нацеливания, например:
https://example.com?adf_aimed_campaign_id=12345&adf_aimed_banner_id=67890 -
Скопируйте ссылку и откройте в нужном браузере — или передайте коллегам. Также можно нажать Перейти по ссылке, чтобы сразу открыть страницу с нацеленным объектом.
Совет
Если вы уже знаете URL страницы, можете самостоятельно добавить параметры
?adf_aimed_campaign_id=XXX&adf_aimed_banner_id=YYYк адресу.
Нацеливание на устройстве
Нацеливание на устройстве работает с помощью Device ID и позволяет проверить показ баннера в мобильном приложении или на Smart TV — там, где нет браузера и cookie.
Поддерживаемые типы идентификаторов
|
Платформа |
Идентификатор |
Параметр движка |
|
iOS (iPhone, iPad) |
IDFA |
|
|
iOS (iPhone, iPad) |
IDFV |
|
|
Android |
GAID |
|
|
Android (включая Android TV) |
App Set ID |
|
|
Android без Google Play (Xiaomi, OPPO, Vivo) |
OAID (MSA) |
|
|
Huawei (без Google Play) |
OAID (HMS) |
|
|
LG Smart TV (webOS) |
LGUDID |
|
|
Samsung Smart TV |
DUID |
|
|
Samsung Smart TV |
TIFA |
|
|
Samsung Smart TV |
Tizen UUID (per-app) |
|
|
Samsung Smart TV |
Extended DUID |
|
|
Универсальный fallback |
Generic UUID |
|
|
Любая платформа |
Любой ID устройства |
|
Как нацелиться по Device ID
-
Выберите Нацелиться на устройстве на странице объекта или в списке кампаний.
-
В открывшемся окне введите идентификатор устройства или выберите из списка сохраненных.
В Adfox хранится до 5 последних Device ID — при следующем нацеливании можно выбрать устройство из списка, не вводя ID заново. Рядом с Device ID, на который уже выполнено нацеливание, видна метка Есть нацеливание.
-
Нажмите Сохранить.
-
Откройте приложение или включите контент на Smart TV — нацеленный баннер появится на устройстве.
Где найти Device ID на устройстве
Apple не показывает IDFA напрямую в настройках. Чтобы узнать IDFA:
-
Установите бесплатное приложение из App Store — например, My Device ID by AppsFlyer или FindMyIDFA.
-
Откройте приложение — IDFA отобразится на экране. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox.
Убедитесь, что на устройстве включено отслеживание: Настройки → Конфиденциальность и безопасность → Отслеживание → Разрешить запросы на отслеживание.
Если пользователь не дал разрешение на ATT (App Tracking Transparency) и IDFA недоступен, используйте IDFV (Identifier for Vendor). Это идентификатор, который iOS присваивает группе приложений одного разработчика на устройстве. В отличие от IDFA, он не требует разрешения пользователя на отслеживание и доступен всегда, пока на устройстве установлено хотя бы одно приложение разработчика.
IDFV не отображается в настройках устройства — его нельзя посмотреть
вручную, как IDFA. Идентификатор доступен только программно через
свойство UIDevice.current.identifierForVendor в iOS SDK.
Чтобы получить IDFV:
-
Обратитесь к разработчику приложения — он может вызвать API получения IDFV и передать вам значение.
-
Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox. IDFV передается в формате строки из 36 символов вида
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.
Важно
IDFV сбрасывается, если пользователь удалил все приложения вендора с устройства. После переустановки IDFV будет другим.
-
Откройте раздел Настройки на устройстве.
-
Перейдите в Google → Реклама или Конфиденциальность → Реклама на некоторых устройствах. На Samsung: Настройки → Безопасность и конфиденциальность → Другие настройки конфиденциальности → Реклама.
-
Рекламный идентификатор (GAID) отобразится на экране. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox.
Совет
Если не получается найти раздел, введите «реклама» или «ads» в поиске по настройкам устройства.
Используйте App Set ID, если вам нужно проверить показ в приложении, где пользователь отключил персонализированную рекламу и GAID отключен или сброшен. App Set ID — идентификатор, который Google Play Services присваивают группе приложений одного разработчика на устройстве.
App Set ID не отображается в настройках устройства — его нельзя посмотреть
вручную, как GAID или IDFA. Идентификатор доступен только программно
через App Set ID API (com.google.android.gms.appset).
Чтобы получить App Set ID:
-
Обратитесь к разработчику приложения — он может вернуть значение через вызов
AppSetIdClient.getAppSetIdInfo(). -
Скопируйте полученное значение и вставьте в поле с идентификатором устройства в Adfox.
Важно
App Set ID одинаковый только для приложений одного разработчика на устройстве. Если вы тестируете нацеливание в чужом приложении, App Set ID будет отличаться от вашего тестового.
OAID (Open Advertising ID) — рекламный идентификатор для Android-устройств, на которых нет сервисов Google Play. Применяется на Xiaomi, OPPO, Vivo, Realme, Meizu и других. Стандарт OAID разработан альянсом MSA (Mobile Security Alliance).
Важно
На устройствах с Google Play (даже от китайских вендоров) приоритетным остается GAID. Используйте OAID, только если GAID недоступен.
OAID не отображается в стандартных настройках Android. На некоторых устройствах его можно посмотреть так:
Настройки → Пароли и безопасность → Конфиденциальность → Реклама → Сбросить рекламный ID (значение видно над кнопкой).
Настройки → Конфиденциальность → Системные службы → Реклама OAID.
Настройки → Другие настройки → Конфиденциальность → Реклама.
Если не получается найти раздел, введите «реклама» или «OAID» в поиске по настройкам. Если OAID не виден в настройках, его нужно получить программно через MSA OAID SDK — обратитесь к разработчику приложения.
Huawei OAID — это рекламный идентификатор для устройств Huawei, работающих на HMS Core (Huawei Mobile Services) без Google Play. Такие устройства выпускаются с 2019 года: Mate 30, P40, Mate 40, Nova 8 и более новые модели.
Совет
На устройствах Huawei с Google Play доступен еще и GAID. Какой идентификатор использовать, зависит от того, под каким SDK собрано приложение.
Чтобы посмотреть Huawei OAID на устройстве:
-
Откройте раздел Настройки.
-
Перейдите в Конфиденциальность → Реклама и Huawei ID (на части моделей: Параметры → Конфиденциальность → Реклама).
-
Рекламный идентификатор появится на экране. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox.
Если идентификатор не отображается в настройках — например, на старых моделях с Google Play — его нужно получить программно через HMS Core Identifier Service (обратитесь к разработчику приложения).
Важно
При сбросе рекламного ID в настройках значение Huawei OAID меняется — после сброса нужно получать ID заново.
Можно посмотреть через меню телевизора (DUID):
-
Нажмите Меню на пульте.
-
Перейдите в раздел Поддержка → Обращение в Samsung или Настройки → Поддержка → Об этом телевизоре.
-
На экране отобразится идентификатор устройства (DUID) — 12-символьный буквенно-цифровой код. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox.
Рекламный идентификатор (TIFA) доступен программно через Samsung AdInfo API. Если ваше приложение использует Samsung Ads SDK, TIFA передается автоматически.
Помимо DUID и TIFA, на Samsung Smart TV доступен Tizen UUID. Это уникальный идентификатор, который Tizen генерирует для каждого приложения на устройстве отдельно (per-app UUID). Используйте Tizen UUID, если в приложении не реализована работа с TIFA, или если пользователь сбросил TIFA и нужен стабильный идентификатор для теста.
Tizen UUID не отображается в меню телевизора — его нельзя посмотреть вручную. Идентификатор доступен только программно через Tizen Device API (tizen.systeminfo.getCapability("http://tizen.org/system/tizenid")) или через GetUuid() в Tizen TV API.
Чтобы получить Tizen UUID:
-
Обратитесь к разработчику приложения — он может вызвать API получения UUID и передать вам значение.
-
Скопируйте полученное значение и вставьте в поле с идентификатором устройства в Adfox.
Важно
Tizen UUID разный для каждого приложения на одном телевизоре. Идентификатор, полученный из тестового приложения, не подойдёт для проверки показа в другом приложении.
LGUDID доступен программно через webOS Device Unique ID API. Для получения идентификатора приложение выполняет запрос: luna://com.webos.service.sm → deviceid/getIDs → idType: ['LGUDID']. После этого возвращается UUID-формат: 095f142a-xxxx-ac5d-xxxx-92c8be18xxxx.
Если вы интегрируете LG SDK, попросите разработчика приложения предоставить LGUDID с тестового телевизора.
Особенности нацеливания
Включение нацеливания
- Нацелиться на несколько кампаний или баннеров разных рекламных кампаний нельзя. Действует последнее нацеливание на объект.
- Нацеливание работает для объектов со статусом активный, в том числе для объектов с датой старта в будущем и с любым набором таргетирований и ограничений на любом уровне.
- Нацеленный объект показывается только по тем кодам вставки, на которых он размещен. Если по одному коду могут вернуться несколько баннеров нацеленной кампании, баннеры будут показываться случайным образом.
Статистика
Статистика (загрузки, показы, переходы, события) по нацеленному объекту в отчетах не учитывается.
Завершение нацеливания
- Принудительно выключить нацеливание нельзя, требуется истечение времени нацеливания.
- После завершения времени нацеливания для пользователя, нацеленного на объект, открутка продолжится в обычном режиме: будут работать таргетирования и ограничения, продолжит учитываться статистика.
Примечание
Для всех остальных пользователей (не нацеленных на объект) открутка баннеров продолжается в обычном режиме.