---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://www.yandex.com/support/partner/en/web/units/tag-features.md
- https://www.yandex.com/support/partner/ru/web/units/tag-features.md
---
> **Documentation Index:** Fetch the complete configuration index at https://www.yandex.com/support/partner/ru/llms.txt
# Возможности кода рекламного блока
Вы можете использовать дополнительные функции и изменять некоторые настройки, работая непосредственно с кодом рекламного блока.
За вызов рекламы в коде отвечает функция `Ya.Context.AdvManager.render`.
{% note alert %}
- Мы не рекомендуем неопытным пользователям самостоятельно вносить изменения в код вызова рекламных блоков. Изменение любых переменных и функций, кроме описанных на данной странице, может привести к ошибкам в работе блоков Рекламной сети и, следовательно, к снижению дохода.
- Код блока нельзя использовать в качестве альтернативного кода в других рекламных системах.
{% endnote %}
## Срезы статистики {#statId}
В коде блока вы можете дополнительно задать идентификатор среза и собирать отдельную статистику по срезам. Идентификатор среза задается в отдельной переменной:
Имя переменной | Описание | Тип данных
----- | ----- | -----
`statId` | Идентификатор среза | Число от 1 до 1 000 000 000
Задайте идентификатор среза в коде вызова рекламы при размещении на сайте, например:
```javascript
Ya.Context.AdvManager.render({
blockId: "R-A-123456-1",
renderTo: "yandex_rtb_R-A-123456-1",
statId: 34567, // идентификатор среза
});
```
Идентификатор среза для блока `R-A-123456-1` в примере — `34567`. Его можно указывать и в других блоках, тогда вы сможете просмотреть для этих блоков сгруппированную статистику. Размещая блок `R-A-123456-1` на других страницах, вы можете указать другой идентификатор среза, чтобы просматривать статистику отдельно для каждого места размещения.
## Ограничение высоты в баннерах {#max-height}
По умолчанию комбинаторные объявления формата [Адаптивный](https://www.yandex.com/support/partner/ru/web/units/formats/main.md#adaptive) полностью занимают обрамляющий контейнер. Регулировать высоту блока можно с помощью параметров `height` (высота) и `max-height` (максимальная высота).
Рекомендуемые значения максимальной высоты блоков:
- в мобильной версии сайта — не менее 70 и не более 90 vh;
- в десктопной версии сайта при размещении на боковых панелях — не менее 40 и не более 60 vh.
Пример кода рекламного блока с максимальной высотой:
```html
```
## Настройка темы {#theme}
Тема (светлая или темная) задается в интерфейсе Рекламной сети Яндекса при создании или редактировании блока. Также вы можете управлять темой блока через код вставки с помощью параметра `darkTheme`:
- `darkTheme: false` — применяется светлая тема;
- `darkTheme: true` — применяется темная тема. Блоки в темной теме отличаются не только фоном, но и цветом текста, рамки, кнопок и других элементов рекламы.
При добавлении параметра `darkTheme` настройки темы, заданные в интерфейсе, игнорируются.
Управление темой блока через код будет удобным для сайтов с динамической темой. Например, с помощью JavaScript можно задавать разные значения параметра `darkTheme`: в зависимости от времени суток, выбранной пользователем темы сайта или браузера.
Пример кода рекламного блока с темной темой:
```javascript
Ya.Context.AdvManager.render({
blockId: "R-A-123456-1",
renderTo: "yandex_rtb_R-A-123456-1",
darkTheme: true
});
```
{% cut "Пример рекламного блока Top Ad с темной темой" %}
{% endcut %}
## Размещение Floor Ad или Top Ad одновременно с Лентой {#feed}
Одновременно показывать [Ленту](https://www.yandex.com/support/partner/ru/web/units/types/feed.md), [Floor Ad](https://www.yandex.com/support/partner/ru/web/units/types/floor-ad.md) и [Top Ad](https://www.yandex.com/support/partner/ru/web/units/types/top-ad.md) на одном экране нельзя. Настройте callback-функцию `observer`, чтобы удалить Floor Ad или Top Ad в момент, когда Лента попадет в зону видимости.
**Пример кода вызова рекламы с функцией observer**
```javascript
```
## Callback-функции в коде вызова рекламы {#rtb-code-tuning-callback}
В код вызова рекламы можно добавить сallback-функции:
#### onClose
: Чтобы узнать, в какой момент реклама была закрыта, при размещении блока добавьте callback-функцию `onClose`. Функция доступна для полноэкранного блока и блоков Top Ad, Floor Ad.
Вы можете задать действие, которое будет вызвано после закрытия баннера, в соответствии с вашей бизнес-логикой. Например, таким действием может быть вызов другого рекламного блока. Для этого впишите код с действием в `onClose`.
{% cut "Пример кода вызова рекламы с функцией onClose" %}
```javascript
```
{% endcut %}
{% cut "Пример кода вызова для второго блока" %}
```javascript
```
{% endcut %}
## Эксперименты над рекламой c Varioqub {#varioqub}
Эксперименты над рекламой, размещенной на сайте, можно проводить с помощью Varioqub. Этот инструмент позволяет создавать эксперимент со множеством вариантов и менять не только элементы и верстку сайта, но и сравнивать между собой разные рекламные блоки и их настройки. В результате эксперимента доступна статистика по показателям, которые помогают определить, какой вариант является наиболее эффективным с точки зрения монетизации и пользовательских метрик. Подробнее читайте в Справке [Эксперименты Varioqub](https://yandex.ru/support/varioqub/ads.html).
## Сбор контекста страницы для таргетинга рекламы {#page-context}
Для анализа контекста используется только текстовое содержимое страницы, видимое пользователю. Функциональность не предназначена для сбора персональных данных посетителей сайта. Код вставки не анализирует скрытые поля, формы ввода, пароли, платежные данные или другую информацию, недоступную пользователю на странице.
Собранный контекст применяется только для тематического таргетинга рекламы: например, для определения категории страницы, ключевых тем или общего содержания материала.
#### Рекомендация по использованию {#page-context-recommendations}
Мы рекомендуем отключать сбор контекста страницы, если рекламный блок размещается на страницах, где в открытом виде может находиться приватная, чувствительная или иная информация, которую вы не хотите использовать для подбора рекламы.
Например, это могут быть страницы личных кабинетов, страницы с пользовательскими сообщениями, заказами, обращениями в поддержку, медицинской, финансовой или другой конфиденциальной информацией.
#### Отключение сбора контекста {#page-context-disable}
Сбор контекста страницы можно отключить с помощью параметра `disableGrab` в коде вставки:
```js
Ya.Context.AdvManager.render({
blockId: "R-A-123456-1",
renderTo: "yandex_rtb_R-A-123456-1",
disableGrab: true
});
```
После отключения рекламный блок продолжит работать, но текст страницы не будет анализироваться и использоваться для контекстного таргетинга рекламы.
## Обратиться в службу поддержки
Если вы не нашли нужную информацию, проверьте список частых вопросов или напишите нам.
{% cut "Я установил код, но объявления не показываются" %}
Проблемы с показом объявлений могут возникнуть по нескольким причинам:
- **Рекламный код был только что установлен**. [Роботу Рекламной сети Яндекса](https://www.yandex.com/support/partner/ru/technologies/robot.md) требуется некоторое время, чтобы проиндексировать страницу и привязать рекламные объявления.
- **Код вызова рекламы установлен неправильно**. Проверьте, что код JavaScript для вызова рекламных блоков установлен верно. Не изменяйте код при копировании. При копировании кода ваш текстовый редактор может прерывать и переносить длинные строки — JavaScript-код с такими строками может работать некорректно.
- **Неверный код для сайта**. Убедитесь, что установленный код вызова рекламных блоков создан именно для этого сайта, а не для одного из других ваших сайтов.
- **Сайт запрещен для индексирования**. Сайт должен быть доступен для индексирования [роботом Рекламной сети Яндекса](https://www.yandex.com/support/partner/ru/technologies/robot.md) — `YandexDirect`. Если индексирование сайта или его отдельных страниц запрещено (например, в файле `robots.txt`), то робот не сможет проиндексировать содержимое страниц и подобрать для них релевантные объявления.
- **Текст закрыт тегом `