Нацеливание

Нацеливание позволяет увидеть баннер, добавленный в Adfox, независимо от выставленных ограничений и таргетингов. Эта функция полезна для:

  • тестирования размещения баннера на сайте, в приложении или на Smart TV;
  • снятия скриншотов креатива;
  • отладки кода баннера или интеграции SDK или плеера;
  • проверки работы кампании «как у реального пользователя».

Нацелиться можно на:

  • флайт в суперкампании;
  • баннер;
  • рекламную кампанию (на вкладке OLD).

Способы нацеливания

Выберите способ в зависимости от того, где вы хотите проверить показ баннера.

Способ нацеливания

Где работает

Когда использовать

В браузере

Десктопные браузеры с поддержкой cookie

Быстрая проверка баннера на сайте в текущем браузере

Через URL-параметры

Любые браузеры, включая Safari; S2S-интеграции

Cookie недоступны или заблокированы; нужно передать ссылку коллегам

На устройстве

Мобильные приложения (In-App), Smart TV, CTV

Проверка баннера в приложении или на телевизоре

Нацеливание в браузере

Нацеливание через браузер устанавливает cookie. Adfox использует их, чтобы определить, что именно вам нужно показать нацеленный объект.

Как это работает:

  1. Выберите Нацелиться в браузере на странице объекта или в списке кампаний. В текущем браузере установится cookie для нацеливания.
  2. Перейдите на сайт, где размещен баннер: нацеленный объект будет показываться в течение 30 минут. Вместо нацеливания в текущем браузере вы можете скопировать ссылку нацеливания и передать ее коллегам.

Ссылку можно сгенерировать в течение 24 часов, количество вызовов не ограничено. Нацеливание действует 30 минут после генерации ссылки.

Важно

Нацеливание через cookie не работает в браузерах, которые блокируют запись cookie (Safari, браузеры с усиленной приватностью). В этих случаях пользуйтесь нацеливанием через URL-параметры.

Нацеливание через URL-параметры

Нацеливание через URL-параметры не требует cookie — параметры добавляются прямо в адрес страницы. Этот способ подходит для браузеров без поддержки cookie (Safari, браузеры с усиленной приватностью) и для S2S-интеграций.

Как это работает:

  1. Выберите Нацелиться через URL-параметры на странице объекта или в списке кампаний.

  2. В открывшемся окне укажите URL страницы, на которой размещен баннер. Ниже появится ссылка для предпросмотра с параметрами нацеливания, например: https://example.com?adf_aimed_campaign_id=12345&adf_aimed_banner_id=67890

  3. Скопируйте ссылку и откройте в нужном браузере — или передайте коллегам. Также можно нажать Перейти по ссылке, чтобы сразу открыть страницу с нацеленным объектом.

    Совет

    Если вы уже знаете URL страницы, можете самостоятельно добавить параметры ?adf_aimed_campaign_id=XXX&adf_aimed_banner_id=YYY к адресу.

Нацеливание на устройстве

Нацеливание на устройстве работает с помощью Device ID и позволяет проверить показ баннера в мобильном приложении или на Smart TV — там, где нет браузера и cookie.

Внимание

Чтобы нацеливание сработало, приложение или SDK должны передавать идентификатор устройства в рекламном запросе к Adfox в соответствующем GET-параметре. Например, если вы настроили нацеливание по GAID, в запросе должен присутствовать параметр &google_aid=38400000-8cf0-11bd-b23e-10b96e40000d.

Если параметр не передается или передается значение, которое отличается от настроек в интерфейсе, нацеливание не сработает. Уточните у разработчика приложения, какой именно идентификатор передается в запросе — используйте тот же тип при настройке нацеливания.

Поддерживаемые типы идентификаторов

Платформа

ID

Параметр движка

Формат

iOS (iPhone, iPad)

IDFA

&idfa=...

32 hex-символа uppercase или lowercase, с дефисами или без.

Пример

AEBE52E7-03EE-455A-B3C4-E57283966239

iOS (iPhone, iPad)

IDFV

&ifv=...

32 hex-символа uppercase или lowercase, с дефисами или без.

Пример

5A7D2D91-E1F2-4B3A-9C8D-1F6E4A2B5C3D

Android (включая Android TV)

GAID

&google_aid=...

32 hex-символа uppercase или lowercase, с дефисами или без.

Пример

38400000-8cf0-11bd-b23e-10b96e40000d

Android (включая Android TV)

App Set ID

&app_set_id=...

32 hex-символа UUID v4, lowercase, с дефисами или без.

Пример

f81d4fae-7dec-11d0-a765-00a0c91e6bf6

Android без Google Play (Xiaomi, OPPO, Vivo)

OAID

&oaid=...

32 hex-символа uppercase или lowercase, с дефисами или без.

Пример

a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6

Huawei без Google Play

Huawei OAID

&huawei_oaid=...

32 hex-символа uppercase или lowercase, с дефисами или без.

Пример

3c4e6a2f8b1d5e9a7c3f1b4d8e2a6c5f

LG Smart TV (webOS)

LGUDID

&webos-id=...

32 hex-символа UUID v4, lowercase, с дефисами или без.

Пример

095f142a-ac5d-4e3b-8f2a-92c8be18d7f6

Samsung Smart TV

DUID

&tizen-duid=...

32 hex-символа UUID v4, lowercase, с дефисами или без.

Пример

89f45b0f5b7ac1fe727fa04792b07c3e

Samsung Smart TV

TIFA

&tizen-tifa=...

32 hex-символа UUID v4, lowercase, с дефисами или без.

Пример

00000000-34ab-cdef-1234-56789abcdef0

Samsung Smart TV

Tizen UUID

&tizen-id=...

28 символов lowercase и uppercase, возможны символы +, - и /, в конце может быть не больше трех символов =.

Пример

DXlq4SiuR124eayZ31/lLwwww===

Samsung Smart TV

Extended DUID

&ext_duid=...

32 hex-символа UUID v4, lowercase, с дефисами или без.

Пример

aebe52e7-03ee-455a-b3c4-e57283966239 или aebe52e703ee455ab3c4e57283966239

Любая платформа

Универсальный UUID

&uuid=...

32 hex-символа uppercase или lowercase, с дефисами или без.

Пример

AEBE52E7-03EE-455A-B3C4-E57283966239, AEBE52E703EE455AB3C4E57283966239 или aebe52e703ee455ab3c4e57283966239

Любая платформа

Device ID

&device-id=...

32 hex-символа uppercase или lowercase, с дефисами или без.

Пример

AEBE52E7-03EE-455A-B3C4-E57283966239, AEBE52E703EE455AB3C4E57283966239 или aebe52e703ee455ab3c4e57283966239

20 или 24 символа uppercase или lowercase.

Пример

FC32D205fefF2f34FFFe или bc49ed40De6CFe5b7315Cb94

Как нацелиться по Device ID

  1. Выберите Нацелиться на устройстве на странице объекта или в списке кампаний.

  2. В открывшемся окне введите идентификатор устройства или выберите из списка сохраненных.

    В Adfox хранится до 10 последних Device ID — при следующем нацеливании можно выбрать устройство из списка, не вводя ID заново. Рядом с Device ID, на который уже выполнено нацеливание, видна метка Есть нацеливание.

  3. Нажмите Сохранить.

  4. Откройте приложение или включите контент на Smart TV — нацеленный баннер появится на устройстве.

Где найти Device ID на устройстве

Apple не показывает IDFA напрямую в настройках. Чтобы узнать IDFA:

  1. Установите бесплатное приложение из App Store — например, My Device ID by AppsFlyer или FindMyIDFA.

  2. Откройте приложение — IDFA отобразится на экране. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox.

Убедитесь, что на устройстве включено отслеживание: Настройки → Конфиденциальность и безопасность → Отслеживание → Разрешить запросы на отслеживание.

Если пользователь не дал разрешение на ATT (App Tracking Transparency) и IDFA недоступен, используйте IDFV (Identifier for Vendor). Это идентификатор, который iOS присваивает группе приложений одного разработчика на устройстве. В отличие от IDFA, он не требует разрешения пользователя на отслеживание и доступен всегда, пока на устройстве установлено хотя бы одно приложение разработчика.

IDFV не отображается в настройках устройства — его нельзя посмотреть вручную, как IDFA. Идентификатор доступен только программно через свойство UIDevice.current.identifierForVendor в iOS SDK.

Чтобы получить IDFV:

  1. Обратитесь к разработчику приложения — он может вызвать API получения IDFV и передать вам значение.

  2. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox. IDFV передается в формате строки из 36 символов.

Важно

IDFV сбрасывается, если пользователь удалил все приложения вендора с устройства. После переустановки IDFV будет другим.

  1. Откройте раздел Настройки на устройстве.

  2. Перейдите в раздел с рекламным идентификатором. Путь зависит от версии Android и производителя:

    • Android 14 и выше (Pixel и другие): Настройки → Все сервисы → Конфиденциальность и безопасность → Реклама.
    • Android 12 и 13: Настройки → Конфиденциальность → Реклама.
    • Android 11 и ниже (или Xiaomi, некоторые другие оболочки): Настройки → Google → Реклама.
    • Samsung (One UI): Настройки → Безопасность и конфиденциальность → Другие настройки конфиденциальности → Реклама.

  3. Рекламный идентификатор (GAID) отобразится на экране. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox.

Совет

Если не получается найти раздел, введите «реклама» или «ads» в поиске по настройкам устройства.

Важно

Начиная с версии Android 12, пользователь может удалить рекламный идентификатор, а не только сбросить. Если GAID удален, приложения получают нулевое значение: 00000000-0000-0000-0000-000000000000. В этом случае используйте App Set ID.

На устройствах Android TV (телевизоры, приставки), в отличие от мобильных устройств, рекламный идентификатор находится в другом месте:

  1. Перейдите на главный экран Android TV.

  2. В верхней части экрана нажмите значок Настройки.

  3. Выберите Устройство → Настройки → Об устройстве.

  4. Нажмите Юридическая информация → Реклама.

  5. Рекламный идентификатор отобразится в нижней части экрана — рядом с текстом «Этот идентификатор устройства».

  6. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox.

Совет

На некоторых устройствах (в зависимости от производителя и версии ОС) путь может отличаться. Если раздел не удается найти, попробуйте перейти в Настройки → О программе → Юридическая информация → Реклама.

Важно

В этом же разделе можно сбросить или удалить идентификатор. После удаления устройству не будет присвоен новый ID — приложения получат нулевое значение.

Используйте 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:

  1. Обратитесь к разработчику приложения — он может вернуть значение через вызов AppSetIdClient.getAppSetIdInfo().

  2. Скопируйте полученное значение и вставьте в поле с идентификатором устройства в 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. На некоторых устройствах его можно посмотреть так:

Настройки → Конфиденциальность → Системные службы → Реклама OAID.

Настройки → Другие настройки → Конфиденциальность → Реклама.

Обратитесь к разработчику приложения или введите «реклама» или «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 на устройстве:

  1. Откройте раздел Настройки.

  2. Перейдите в Конфиденциальность → Реклама (точный путь зависит от версии EMUI или HarmonyOS).

  3. Рекламный идентификатор появится на экране. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox.

Если идентификатор не отображается в настройках — например, на старых моделях с Google Play — его нужно получить программно через HMS Core Identifier Service (обратитесь к разработчику приложения).

Важно

При сбросе рекламного ID в настройках значение Huawei OAID меняется — после сброса нужно получать ID заново.

Можно посмотреть через меню телевизора (DUID):

  1. Нажмите Меню на пульте.

  2. Перейдите в раздел Поддержка → Обращение в Samsung или Настройки → Поддержка → Об этом телевизоре.

  3. На экране отобразится идентификатор устройства (DUID). Скопируйте значение и вставьте в поле с идентификатором устройства в 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:

  1. Обратитесь к разработчику приложения — он может вызвать API получения UUID и передать вам значение.

  2. Скопируйте полученное значение и вставьте в поле с идентификатором устройства в Adfox.

Важно

Tizen UUID разный для каждого приложения на одном телевизоре. Идентификатор, полученный из тестового приложения, не подойдёт для проверки показа в другом приложении.

LG Smart TV работает на платформе webOS. Для идентификации устройств используется LGUDID (LG Unique Device ID) — уникальный идентификатор, доступный программно через webOS Device Unique ID API. Для получения идентификатора приложение выполняет запрос: luna://com.webos.service.sm → deviceid/getIDs → idType: ['LGUDID']. После этого возвращается UUID-формат: 095f142a-xxxx-ac5d-xxxx-92c8be18xxxx.

Если вы интегрируете LG SDK, попросите разработчика приложения предоставить LGUDID с тестового телевизора.

Важно

Идентификаторы из раздела «Информация о ТВ» (ESN, Widevine, VSN) — это не LGUDID. Они не подходят для нацеливания в Adfox.

Особенности нацеливания

Включение нацеливания

  • Нацелиться на несколько кампаний или баннеров разных рекламных кампаний нельзя. Действует последнее нацеливание на объект.
  • Нацеливание работает для объектов со статусом активный, в том числе для объектов с датой старта в будущем и с любым набором таргетирований и ограничений на любом уровне.
  • Нацеленный объект показывается только по тем кодам вставки, на которых он размещен. Если по одному коду могут вернуться несколько баннеров нацеленной кампании, баннеры будут показываться случайным образом.

Статистика

Статистика (загрузки, показы, переходы, события) по нацеленному объекту в отчетах не учитывается.

Завершение нацеливания

  • Принудительно выключить нацеливание нельзя, требуется истечение времени нацеливания.
  • После завершения времени нацеливания для пользователя, нацеленного на объект, открутка продолжится в обычном режиме: будут работать таргетирования и ограничения, продолжит учитываться статистика.

Примечание

Для всех остальных пользователей (не нацеленных на объект) открутка баннеров продолжается в обычном режиме.

Обратиться в службу поддержки

Написать в чат

Написать письмо

Предыдущая
Копирование кампаний
Следующая
Открутка кампаний