--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/support/adfox/en/targeting/puid.md - https://yandex.com/support/adfox/ru/targeting/puid.md - href: ru/targeting/puid.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 # Дополнительные таргетинги Дополнительные таргетинги — это модуль, позволяющий настроить специальные виды таргетингов. Помимо уже существующих вариантов таргетирования (по времени, по частоте, по географии и т. д.), администратор аккаунта может задать до 63 дополнительных характеристик с произвольными значениями и таргетировать по ним свои кампании. Если значения для стандартных видов таргетирования Adfox определяет самостоятельно, то значения характеристики для дополнительного таргетинга нужно передавать в код вставки со страницы сайта. Что именно передавать и как настраивать дополнительные таргетинги в системе Adfox, рассмотрим ниже. Чтобы настроить передачу значений в код вставки, обратитесь к разработчикам вашего сайта. ## Добавление характеристик {#add-puid} Дополнительные характеристики настраиваются на вкладке **Настройки** → **Дополнительные таргетинги**. #### Шаг 1. Добавьте характеристику таргетирования {#step-1} 1. В строке с нужной характеристикой нажмите ![](../_images/parameters.svg) **Параметры**. Откроется окно с настройками. 1. Включите использование характеристики. 1. Задайте параметры: - **Название** — название характеристики на вкладке **Дополнительные таргетинги**. Максимальная длина — 256 символов. - **Наименование таргетирования** — название таргетирования по этой характеристике в настройках рекламной кампании. - **Наименование отчёта** — название отчета по этой характеристике в списке отчетов. 1. Нажмите кнопку **Изменить**. #### Шаг 2. Добавьте значения для новой характеристики {#step-2}   После того, как вы добавили характеристику, на вкладке **Дополнительные таргетинги** в строке с ней появятся кнопки ![](../_images/button-value.png =20x)**Значения** и ![](../_images/button-value-group.png =20x)**Группы значений**. Чтобы добавить значения: 1. В строке с характеристикой нажмите ![](../_images/button-value.png =20x) → **Добавить**. Откроется окно с настройками. 1. Задайте параметры: - **Идентификатор (передается в код вставки)** — параметр, передаваемый в код вставки. Идентификатор должен состоять только из латинских букв, цифр и символов `%+.=/()-`, максимальная длина — 65 символов. - **Значение (выводится в интерфейсах)** — название значения в настройках таргетирования рекламной кампании и в отчетах. Максимальная длина — 256 символов. - **Отключить значение там, где есть выключенные значения (таргетинг задан)** — опция отключает показ рекламы, настроенный ранее, пользователям, которые соответствуют этому значению. Это касается только тех рекламных кампаний, которые были созданы до добавления значения. В новых рекламных кампаниях это значение по умолчанию будет включено в таргетирование. 1. Нажмите кнопку **Добавить**. {% note alert %} Максимально допустимое количество значений для одной характеристики — 10 000. {% endnote %} Вы можете объединить значения в группы. Тогда при настройке таргетирования для рекламной кампании вы сможете выбирать все необходимые значения одним кликом. Например, вы добавили характеристику «возраст» и указали для нее значения от 15 до 35. Обычно вы настраиваете таргетирование по возрастному диапазону: 15–20, 21–25, 26–30 и 31–35 лет. Создайте четыре соответствующие группы и включите в них нужные значения. Тогда при настройке рекламной кампании вам не нужно перечислять все значения в таргетируемом диапазоне, достаточно выбрать группу — все нужные значения включатся автоматически. Чтобы добавить группу значений: 1. В строке с характеристикой нажмите ![](../_images/button-value-group.png =20x) → **Добавить**. 1. В открывшемся окне нажмите **Добавить** и укажите название группы. 1. Перейдите на вкладку **Значения** и выберите нужные значения для этой группы. 1. Нажмите **Изменить**. Группа появится в настройках таргетирования для рекламной кампании. ## Настройка дополнительного таргетирования {#target-puid} Таргетирование задается на вкладке **Таргетирование** → **Дополнительные таргетинги**. Выберите из списка характеристику, отметьте все необходимые значения и нажмите кнопку **Изменить**. После этого можно выбрать из списка следующую характеристику и повторить настройки. Если для характеристики добавлены группы значений, управлять списком значений можно включая и выключая только группы. Опция **<неизвестное, не задано>** определяет, показывать ли баннеры в тех случаях, когда в Adfox не передается вообще никакого значения или передается значение, отсутствующее в списке значений характеристики. ## Изменение кода вставки {#embed-code} Если характеристики дополнительного таргетирования были включены уже после установки кодов вставки на сайт, необходимо добавить новые параметры в код вставки или же заново получить коды в интерфейсе. ### Добавление параметров в код вставки В объект `params` добавьте параметр `puidN: value`, где: - `N` — номер характеристики от 1 до 63; - `value` — значение для таргетирования из поля **Идентификатор**. Например, для характеристики «Станция метро» в справочнике может быть добавлено значение: #| || **Идентификатор (передается в код вставки)** | **Значение (выводится в интерфейсах)** || || `004ca1aa93adb0164440a7501a47c86` | Сходненская (Таганско-Краснопресненская) || |# В код вставки необходимо передать значение из поля **Идентификатор**: ```javascript params: { puid1: '004ca1aa93adb0164440a7501a47c86' } ``` Если в запросе придет этот идентификатор, в отчетах Adfox он будет отображаться как «Сходненская (Таганско-Краснопресненская)». {% note info %} Длина передаваемой переменной `puid` не должна превышать общий допустимый браузером лимит на длину строки HTTP-запроса. {% endnote %} К одному параметру можно передавать несколько значений через разделитель `:` (двоеточие). Если рекламная кампания старгетирована хотя бы на одно из полученных значений, она будет показана. Пример 1 — добавление puid1 с одним значением и puid2 с несколькими значениями через разделитель двоеточие: ```javascript params: { pp: 'g', ps: 'bnfx', p2: 'evbi', puid1: 'woman', puid2: '16:17:18:19' } ``` {% cut "Добавление параметров в код мобильных приложений" %} С помощью объекта `AdRequest` передайте параметр `adf_puidN`, где `N` — номер характеристики от 1 до 63 и значение для таргетирования. Пример (Android): ```java Map parameters = new HashMap(); parameters.put("adf_puid1", "value"); ``` Пример (iOS): ```java NSMutableDictionary *parameters = [[NSMutableDictionary alloc] init]; parameters[@"adf_puid1"] = @"value"; ``` {% endcut %} {% cut "Добавление параметров для XML-кодов" %} Добавьте параметр со значением как `name=value&` или `name=value&` (в зависимости от выбранного разделителя параметров), где `name` — название параметра (puidN), а `value` — значение без кавычек. Пример добавления puid1 с одним значением и puid2 с несколькими значениями через разделитель двоеточие: ```javascript yandex.ru/ads/adfox/166283/getCode?pp=g&ps=bnfx&p2=evbi&pr=&dl=&puid1=woman&puid2=16:17:18:19 ``` Приведенный выше код будет показывать кампании, старгетированные на посетителей женского пола 16-ти лет. {% endcut %} ## Отчеты {#reports} Если со страницы сайта к параметру передавалось одно значение, оно же будет записано в лог и на основании этого записанного значения будет построен отчет. Если со страницы сайта к параметру передавалось одновременно несколько значений, отчет строится по следующей схеме: - В лог запишется то значение, которое имеет наибольшее valueID — системный идентификатор значения характеристики. - Если кампания не была старгетирована на это значение, но могла показаться по любому другому из пришедших в запросе значений, в отчете появится то значение, которое имело наибольший valueID и было записано в лог. Но это не означает, что кампания была показана неправильно по настройкам таргетирования. Пример: В запросе передаются значения к `puid1=g38:m38:m42:m21`. Для характеристики № 1 мы имеем справочник значений: **valueID** | **Идентификатор (передается в код вставки)** | **Значение (выводится в интерфейсе)** ----- | ----- | ----- 25190 | g38 | Мультфильмы для детей 25192 | m38 | Мультфильмы наши 25195 | m42 | Мультфильмы мультсериалы **valueID = 0** — имеют неизвестные значения, переданные в код запроса. Есть рекламная кампания, которая старгетирована на неизвестное значение, если первые три значения выключены. При таком запросе рекламная кампания показывается, так как в запросе приходит неизвестное значение. В лог запишется одно из пришедших значений, а именно m42, так как оно имеет наибольший valueID. В отчете по этой рекламной кампании показ засчитается на значение «Мультфильмы мультсериалы». Ошибки в показе рекламной кампании при этом нет, так как в запросе было передано значение, разрешенное к показу. ## Обратиться в службу поддержки Написать в чат Написать письмо