--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/support/adfox/en/campaigns/bind.md - https://yandex.com/support/adfox/ru/campaigns/bind.md - href: ru/campaigns/bind.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/adfox/ru/llms.txt # Нацеливание Нацеливание позволяет увидеть баннер, добавленный в Adfox, независимо от выставленных ограничений и таргетингов. Эта функция полезна для: - тестирования размещения баннера на сайте, в приложении или на Smart TV; - снятия скриншотов креатива; - отладки кода баннера или интеграции SDK или плеера; - проверки работы кампании «как у реального пользователя». Нацелиться можно на: - флайт в суперкампании; - баннер; - рекламную кампанию (на вкладке **OLD**). ## Способы нацеливания {#methods} Выберите способ в зависимости от того, где вы хотите проверить показ баннера. #| || **Способ нацеливания** | **Где работает** | **Когда использовать** || || В браузере | Десктопные браузеры с поддержкой cookie | Быстрая проверка баннера на сайте в текущем браузере || || Через URL-параметры | Любые браузеры, включая Safari; S2S-интеграции | Cookie недоступны или заблокированы; нужно передать ссылку коллегам || || На устройстве | Мобильные приложения (In-App), Smart TV, CTV | Проверка баннера в приложении или на телевизоре || |# ### Нацеливание в браузере {#browser} Нацеливание через браузер устанавливает cookie. Adfox использует их, чтобы определить, что именно вам нужно показать нацеленный объект. Как это работает: 1. Выберите **Нацелиться в браузере** на странице объекта или в списке кампаний. В текущем браузере установится cookie для нацеливания. 1. Перейдите на сайт, где размещен баннер: нацеленный объект будет показываться в течение 30 минут. Вместо нацеливания в текущем браузере вы можете скопировать ссылку нацеливания и передать ее коллегам. Ссылку можно сгенерировать в течение 24 часов, количество вызовов не ограничено. Нацеливание действует 30 минут после генерации ссылки. {% note warning %} Нацеливание через cookie не работает в браузерах, которые блокируют запись cookie (Safari, браузеры с усиленной приватностью). В этих случаях пользуйтесь нацеливанием через URL-параметры. {% endnote %} ### Нацеливание через URL-параметры {#url} Нацеливание через URL-параметры не требует cookie — параметры добавляются прямо в адрес страницы. Этот способ подходит для браузеров без поддержки cookie (Safari, браузеры с усиленной приватностью) и для S2S-интеграций. Как это работает: 1. Выберите **Нацелиться через URL-параметры** на странице объекта или в списке кампаний. 1. В открывшемся окне укажите URL страницы, на которой размещен баннер. Ниже появится ссылка для предпросмотра с параметрами нацеливания, например: `https://example.com?adf_aimed_campaign_id=12345&adf_aimed_banner_id=67890`. 1. Скопируйте ссылку и откройте в нужном браузере — или передайте коллегам. Также можно нажать **Перейти по ссылке**, чтобы сразу открыть страницу с нацеленным объектом. {% note tip %} Если вы уже знаете URL страницы, можете самостоятельно добавить параметры `?adf_aimed_campaign_id=XXX&adf_aimed_banner_id=YYY` к адресу. {% endnote %} ### Нацеливание на устройстве {#device-id} Нацеливание на устройстве работает с помощью Device ID и позволяет проверить показ баннера в мобильном приложении или на Smart TV — там, где нет браузера и cookie. {% note alert %} Чтобы нацеливание сработало, приложение или SDK должны передавать идентификатор устройства в рекламном запросе к Adfox в соответствующем GET-параметре. Например, если вы настроили нацеливание по GAID, в запросе должен присутствовать параметр `&google_aid=38400000-8cf0-11bd-b23e-10b96e40000d`. Если параметр не передается или передается значение, которое отличается от настроек в интерфейсе, нацеливание не сработает. Уточните у разработчика приложения, какой именно идентификатор передается в запросе — используйте тот же тип при настройке нацеливания. {% endnote %} #### Поддерживаемые типы идентификаторов #| || **Платформа** | **ID** | **Параметр движка** | **Формат** || || iOS (iPhone, iPad) | IDFA | `&idfa=...` | 32 hex-символа uppercase или lowercase, с дефисами или без. {% cut "Пример" %} `AEBE52E7-03EE-455A-B3C4-E57283966239` {% endcut %} || || iOS (iPhone, iPad) | IDFV | `&ifv=...` | 32 hex-символа uppercase или lowercase, с дефисами или без. {% cut "Пример" %} `5A7D2D91-E1F2-4B3A-9C8D-1F6E4A2B5C3D` {% endcut %} || || Android (включая Android TV) | GAID | `&google_aid=...` | 32 hex-символа uppercase или lowercase, с дефисами или без. {% cut "Пример" %} `38400000-8cf0-11bd-b23e-10b96e40000d` {% endcut %} || || Android (включая Android TV) | App Set ID | `&app_set_id=...` | 32 hex-символа UUID v4, lowercase, с дефисами или без. {% cut "Пример" %} `f81d4fae-7dec-11d0-a765-00a0c91e6bf6` {% endcut %} || || Android без Google Play (Xiaomi, OPPO, Vivo) | OAID | `&oaid=...` | 32 hex-символа uppercase или lowercase, с дефисами или без. {% cut "Пример" %} `a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6` {% endcut %} || || Huawei без Google Play | Huawei OAID | `&huawei_oaid=...` | 32 hex-символа uppercase или lowercase, с дефисами или без. {% cut "Пример" %} `3c4e6a2f8b1d5e9a7c3f1b4d8e2a6c5f` {% endcut %} || || LG Smart TV (webOS) | LGUDID | `&webos-id=...` | 32 hex-символа UUID v4, lowercase, с дефисами или без. {% cut "Пример" %} `095f142a-ac5d-4e3b-8f2a-92c8be18d7f6` {% endcut %} || || Samsung Smart TV | DUID | `&tizen-duid=...` | 32 hex-символа UUID v4, lowercase, с дефисами или без. {% cut "Пример" %} `89f45b0f5b7ac1fe727fa04792b07c3e` {% endcut %} || || Samsung Smart TV | TIFA | `&tizen-tifa=...` | 32 hex-символа UUID v4, lowercase, с дефисами или без. {% cut "Пример" %} `00000000-34ab-cdef-1234-56789abcdef0` {% endcut %} || || Samsung Smart TV | Tizen UUID | `&tizen-id=...` | 28 символов lowercase и uppercase, возможны символы `+`, `-` и `/`, в конце может быть не больше трех символов `=`. {% cut "Пример" %} `DXlq4SiuR124eayZ31/lLwwww===` {% endcut %} || || Samsung Smart TV | Extended DUID | `&ext_duid=...` | 32 hex-символа UUID v4, lowercase, с дефисами или без. {% cut "Пример" %} `aebe52e7-03ee-455a-b3c4-e57283966239` или `aebe52e703ee455ab3c4e57283966239` {% endcut %} || || Любая платформа | Универсальный UUID | `&uuid=...` | 32 hex-символа uppercase или lowercase, с дефисами или без. {% cut "Пример" %} `AEBE52E7-03EE-455A-B3C4-E57283966239`, `AEBE52E703EE455AB3C4E57283966239` или `aebe52e703ee455ab3c4e57283966239` {% endcut %} || || Любая платформа | Device ID | `&device-id=...` | 32 hex-символа uppercase или lowercase, с дефисами или без. {% cut "Пример" %} `AEBE52E7-03EE-455A-B3C4-E57283966239`, `AEBE52E703EE455AB3C4E57283966239` или `aebe52e703ee455ab3c4e57283966239` {% endcut %} 20 или 24 символа uppercase или lowercase. {% cut "Пример" %} `FC32D205fefF2f34FFFe` или `bc49ed40De6CFe5b7315Cb94` {% endcut %} || |# #### Как нацелиться по Device ID 1. Выберите **Нацелиться на устройстве** на странице объекта или в списке кампаний. 1. В открывшемся окне введите идентификатор устройства или выберите из списка сохраненных. В Adfox хранится до 10 последних Device ID — при следующем нацеливании можно выбрать устройство из списка, не вводя ID заново. Рядом с Device ID, на который уже выполнено нацеливание, видна метка **Есть нацеливание**. 1. Нажмите **Сохранить**. 1. Откройте приложение или включите контент на Smart TV — нацеленный баннер появится на устройстве. #### Где найти Device ID на устройстве {% list tabs radio %} - IDFA (iPhone или iPad) Apple не показывает IDFA напрямую в настройках. Чтобы узнать IDFA: 1. Установите бесплатное приложение из App Store — например, **My Device ID by AppsFlyer** или **FindMyIDFA**. 1. Откройте приложение — IDFA отобразится на экране. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox. Убедитесь, что на устройстве включено отслеживание: **Настройки** → **Конфиденциальность и безопасность** → **Отслеживание** → **Разрешить запросы на отслеживание**. - IDFV (iPhone или iPad) Если пользователь не дал разрешение на ATT (App Tracking Transparency) и IDFA недоступен, используйте IDFV (Identifier for Vendor). Это идентификатор, который iOS присваивает группе приложений одного разработчика на устройстве. В отличие от IDFA, он не требует разрешения пользователя на отслеживание и доступен всегда, пока на устройстве установлено хотя бы одно приложение разработчика. IDFV не отображается в настройках устройства — его нельзя посмотреть вручную, как IDFA. Идентификатор доступен только программно через свойство `UIDevice.current.identifierForVendor` в iOS SDK. Чтобы получить IDFV: 1. Обратитесь к разработчику приложения — он может вызвать API получения IDFV и передать вам значение. 1. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox. IDFV передается в формате строки из 36 символов. {% note warning %} IDFV сбрасывается, если пользователь удалил все приложения вендора с устройства. После переустановки IDFV будет другим. {% endnote %} - GAID (Android-смартфон или планшет) 1. Откройте раздел **Настройки** на устройстве. 1. Перейдите в раздел с рекламным идентификатором. Путь зависит от версии Android и производителя: - Android 14 и выше (Pixel и другие): **Настройки** → **Все сервисы** → **Конфиденциальность и безопасность** → **Реклама**. - Android 12 и 13: **Настройки** → **Конфиденциальность** → **Реклама**. - Android 11 и ниже (или Xiaomi, некоторые другие оболочки): **Настройки** → **Google** → **Реклама**. - Samsung (One UI): **Настройки** → **Безопасность и конфиденциальность** → **Другие настройки конфиденциальности** → **Реклама**. 1. Рекламный идентификатор (GAID) отобразится на экране. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox. {% note tip %} Если не получается найти раздел, введите «реклама» или «ads» в поиске по настройкам устройства. {% endnote %} {% note warning %} Начиная с версии Android 12, пользователь может удалить рекламный идентификатор, а не только сбросить. Если GAID удален, приложения получают нулевое значение: `00000000-0000-0000-0000-000000000000`. В этом случае используйте App Set ID. {% endnote %} - GAID (Android TV) На устройствах Android TV (телевизоры, приставки), в отличие от мобильных устройств, рекламный идентификатор находится в другом месте: 1. Перейдите на главный экран Android TV. 1. В верхней части экрана нажмите значок **Настройки**. 1. Выберите **Устройство** → **Настройки** → **Об устройстве**. 1. Нажмите **Юридическая информация** → **Реклама**. 1. Рекламный идентификатор отобразится в нижней части экрана — рядом с текстом «Этот идентификатор устройства». 1. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox. {% note tip %} На некоторых устройствах (в зависимости от производителя и версии ОС) путь может отличаться. Если раздел не удается найти, попробуйте перейти в **Настройки** → **О программе** → **Юридическая информация** → **Реклама**. {% endnote %} {% note warning %} В этом же разделе можно сбросить или удалить идентификатор. После удаления устройству не будет присвоен новый ID — приложения получат нулевое значение. {% endnote %} - App Set 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()`. 1. Скопируйте полученное значение и вставьте в поле с идентификатором устройства в Adfox. {% note warning %} App Set ID одинаковый только для приложений одного разработчика на устройстве. Если вы тестируете нацеливание в чужом приложении, App Set ID будет отличаться от вашего тестового. {% endnote %} - OAID (Android без Google Play) OAID (Open Advertising ID) — рекламный идентификатор для Android-устройств, на которых нет сервисов Google Play. Применяется на Xiaomi, OPPO, Vivo, Realme, Meizu и других. Стандарт OAID разработан альянсом MSA (Mobile Security Alliance). {% note warning %} На устройствах с Google Play (даже от китайских вендоров) приоритетным остается GAID. Используйте OAID, только если GAID недоступен. {% endnote %} OAID не отображается в стандартных настройках Android. На некоторых устройствах его можно посмотреть так: {% list tabs %} - OPPO (ColorOS) **Настройки** → **Конфиденциальность** → **Системные службы** → **Реклама OAID**. - Vivo (Funtouch OS / OriginOS) **Настройки** → **Другие настройки** → **Конфиденциальность** → **Реклама**. - Xiaomi (MIUI) Обратитесь к разработчику приложения или введите «реклама» или «OAID» в поиске по настройкам. {% endlist %} {% note tip %} Если не получается найти раздел, введите «реклама» или «OAID» в поиске по настройкам. Если OAID не виден в настройках, его нужно получить программно через **MSA OAID SDK** — обратитесь к разработчику приложения. {% endnote %} - Huawei OAID (Huawei без Google Play) Huawei OAID — это рекламный идентификатор для устройств Huawei, работающих на HMS Core (Huawei Mobile Services) без Google Play. Такие устройства выпускаются с 2019 года: Mate 30, P40, Mate 40, Nova 8 и более новые модели. {% note tip %} На устройствах Huawei с Google Play доступен еще и GAID. Какой идентификатор использовать, зависит от того, под каким SDK собрано приложение. {% endnote %} Чтобы посмотреть Huawei OAID на устройстве: 1. Откройте раздел **Настройки**. 1. Перейдите в **Конфиденциальность** → **Реклама** (точный путь зависит от версии EMUI или HarmonyOS). 1. Рекламный идентификатор появится на экране. Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox. Если идентификатор не отображается в настройках — например, на старых моделях с Google Play — его нужно получить программно через **HMS Core Identifier Service** (обратитесь к разработчику приложения). {% note warning %} При сбросе рекламного ID в настройках значение Huawei OAID меняется — после сброса нужно получать ID заново. {% endnote %} - DUID/TIFA (Samsung Smart TV) Можно посмотреть через меню телевизора (DUID): 1. Нажмите **Меню** на пульте. 1. Перейдите в раздел **Поддержка** → **Обращение в Samsung** или **Настройки** → **Поддержка** → **Об этом телевизоре**. 1. На экране отобразится идентификатор устройства (DUID). Скопируйте значение и вставьте в поле с идентификатором устройства в Adfox. Рекламный идентификатор (TIFA) доступен программно через **Samsung AdInfo API**. Если ваше приложение использует [Samsung Ads SDK](https://developer.samsung.com/SmartTV/develop/api-references/samsung-product-api-references/adinfo-api.html), TIFA передается автоматически. - Tizen UUID (Samsung Smart TV) Помимо 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 и передать вам значение. 1. Скопируйте полученное значение и вставьте в поле с идентификатором устройства в Adfox. {% note warning %} Tizen UUID разный для каждого приложения на одном телевизоре. Идентификатор, полученный из тестового приложения, не подойдёт для проверки показа в другом приложении. {% endnote %} - LGUDID (LG Smart TV, webOS) LG Smart TV работает на платформе webOS. Для идентификации устройств используется LGUDID (LG Unique Device ID) — уникальный идентификатор, доступный программно через [webOS Device Unique ID API](https://webostv.developer.lge.com/develop/references/device-unique-id). Для получения идентификатора приложение выполняет запрос: `luna://com.webos.service.sm → deviceid/getIDs → idType: ['LGUDID']`. После этого возвращается UUID-формат: `095f142a-xxxx-ac5d-xxxx-92c8be18xxxx`. Если вы интегрируете LG SDK, попросите разработчика приложения предоставить LGUDID с тестового телевизора. {% note warning %} Идентификаторы из раздела «Информация о ТВ» (ESN, Widevine, VSN) — это не LGUDID. Они не подходят для нацеливания в Adfox. {% endnote %} {% endlist %} ## Особенности нацеливания {#bind-features} ### Включение нацеливания {#start} - Нацелиться на несколько кампаний или баннеров разных рекламных кампаний нельзя. Действует последнее нацеливание на объект. - Нацеливание работает для объектов со статусом **активный**, в том числе для объектов с датой старта в будущем и с любым набором таргетирований и ограничений на любом уровне. - Нацеленный объект показывается только по тем кодам вставки, на которых он размещен. Если по одному коду могут вернуться несколько баннеров нацеленной кампании, баннеры будут показываться случайным образом. ### Статистика {#statistics} Статистика (загрузки, показы, переходы, события) по нацеленному объекту в отчетах не учитывается. ### Завершение нацеливания {#finish} - Принудительно выключить нацеливание нельзя, требуется истечение времени нацеливания. - После завершения времени нацеливания для пользователя, нацеленного на объект, открутка продолжится в обычном режиме: будут работать таргетирования и ограничения, продолжит учитываться статистика. {% note info %} Для всех остальных пользователей (не нацеленных на объект) открутка баннеров продолжается в обычном режиме. {% endnote %} ## Обратиться в службу поддержки Написать в чат Написать письмо