---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/support/adfox/en/ad-inventory/video.md
  - https://yandex.com/support/adfox/ru/ad-inventory/video.md
  - href: ru/ad-inventory/video.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

# Реклама в видеоплеере

## Общие положения {#about}

VAST — это стандарт, описывающий процесс отображения баннеров видеоплеером и отправку статистики на рекламный сервер.

Для встраивания рекламы используются международные стандарты медиаиндустрии. В этой статье описываются конечные решения в рамках этих стандартов.

Показ рекламы выглядит следующим образом: плеер запрашивает видеобаннер, отображает содержимое VAST-ответа и отсылает статистику о показах и других событиях в Adfox (статистику также можно отправлять в сторонние системы с помощью пикселей). Это может происходить как напрямую между видеоплеером и Adfox, так и между видеоплеером, Adfox и сторонним рекламным сервером. При обращении к Adfox плеер получает VAST XML, [пример](https://yandex.ru/ads/adfox/168627/getCode?p1=bdcfe&p2=ekza&pfc=zymd&pfb=dkvcj).


{% cut "Схема прямого взаимодействия плеера с Adfox" %}


![](../_images/banners/direct-01.svg)

1. **Запрос за рекламой** — видеоплеер посылает запрос в Adfox для получения VAST.
1. **VAST-ответ** — Adfox присылает VAST, в котором содержатся ссылки на медиафайлы и события, необходимые для отображения и сбора статистики по баннеру.
1. **Отправка статистики** — по мере наступления событий при воспроизведении рекламы (ролик загружен, первая четверть и т. д.) плеер отправляет статистику о них в Adfox.


{% endcut %}

{% cut "Схема взаимодействия, включающая сторонний сервер рекламы (Wrapper)" %}


![](../_images/banners/wrapper-01.svg)

1. **Запрос за рекламой** — видеоплеер делает запрос в Adfox для получения VAST.
1. **VAST-редирект (Wrapper)** — Adfox отправляет в ответ VAST, в котором содержатся ссылки на события, а также URI стороннего сервера рекламы в тегах `<VASTAdTagURI></VASTAdTagURI>`.
    
    Пример Wrapper-ответа от Adfox:

    ```xml
    <?xml version="1.0" encoding="UTF-8"?>
    <VAST version="2.0">
    <Ad id="%campaignId%-%user1%">
    <Wrapper>
            <AdSystem>Adfox</AdSystem>
            <VASTAdTagURI>
            <![CDATA[ССЫЛКА НА СТОРОННИЙ СЕРВЕР РЕКЛАМЫ]]>
            </VASTAdTagURI>
            <Error>
            <![CDATA[%event20%]]>
            </Error>
            <Impression>
            <![CDATA[%event3%]]>
            </Impression>
            <Creatives>
            <Creative>
                    <Linear>
                            <TrackingEvents>
                            ...
                            </TrackingEvents>
                            <VideoClicks>
                            <ClickTracking>
                                    <!![CDATA[%request.reference_mrc%]]>
                            </ClickTracking>
                            </VideoClicks>
                    </Linear>
                    </Creative>
            </Creatives>
            <Extensions>
            ...
            </Extensions>
    </Wrapper>
    </Ad>
    </VAST>
    ```
    
1. **Запрос за рекламой** — после обработки VAST-ответа от Adfox видеоплеер делает запрос к стороннему серверу рекламы, используя URI, который Adfox прислал внутри тегов `<VASTAdTagURI></VASTAdTagURI>`.
1. **Отправка статистики** — по мере наступления событий при воспроизведении рекламы (ролик загружен, первая четверть и т. д.) плеер отправляет статистику о них в Adfox и на сторонний сервер рекламы путем отправки запросов по ссылкам из VAST.


{% endcut %}


> Wrapper-ответ содержит тег `Wrapper` со ссылкой на сторонний сервер рекламы. Сторонний сервер может отдать баннер Linear Ad или Wrapper, который ссылается на еще один сервер рекламы. В конечном счете последний сервер в цепочке должен отдать все необходимые файлы для отображения рекламы.

## Требования к рекламным материалам

<!-- source: ru/_includes/banners/specs/video-requirements.md -->
#|
|| Формат | MP4, WebM, MOV, QT, AVI ||
|| Рекомендуемый формат | MP4 ||
|| Частота кадров | не более 60 кадров/с ||
|| Количество видеодорожек | 1 ||
|| Аудиокодеки | AAC, MP3, Vorbis ||
|| Количество аудиодорожек | не более 1 ||
|| Минимальное разрешение (опционально), задается как в пикселях, так и в % | 1280 × 720 пикселей ||
|| Максимальный размер видеоролика,  
который будет загружен в интерфейс Adfox | 100 МБ ||
|#
<!-- endsource: ru/_includes/banners/specs/video-requirements.md -->


## Доступные предзаданные шаблоны {#system-templates}


{% note info %}

Перечисленные в этом разделе шаблоны доступны для баннеров с [типом представления XML](https://yandex.com/support/adfox/ru/ad-inventory/settings/banner-types.md#type-of-presentation).

{% endnote %}


### Linear Ads Video {#linear-ads-video}

Реклама на весь кадр, которая приостанавливает воспроизведение видеоконтента. Обычно это видеореклама, но могут использоваться статичные изображения, которые отображаются в определенное время. Такой тип рекламы может проигрываться до воспроизведения видеоконтента (pre-roll), в перерыве во время воспроизведения контента (mid-roll) или после воспроизведения видео (post-roll).

Тип содержимого — видеофайл.

##### Linear-Ad (Pre / Mid / Post-roll) VAST 3.0 Viewability
 
:   Шаблон с проверкой видимости. Если более 50% плеера находится в пределах области видимости, через 2 секунды срабатывает событие видимости. Статистика по событию доступна в отчетах.

##### Linear-Ad (Pre / Mid / Post-roll) VAST 2.0 Compatible No Click
 
:   Шаблон для видео без поддержки клика.

##### Linear-Ad (Pre / Mid / Post-roll) VAST 3.0
 
:   Шаблон с поддержкой клика.

### Linear Ads Audio {#linear-ads-audio}

Тип содержимого — аудиофайл.

##### Linear-Ad (Pre / Mid / Post-roll) Audio VAST 3.0
 
:   Шаблон для аудио без поддержки клика.

### Nonlinear Ads {#nonlinear-ads}

Наложенная реклама, отображаемая одновременно с воспроизведением основного видео. Обычно это статическое изображение, размещенное в проигрывателе и занимающее часть области плеера.

{% note alert %}

Шаблоны Overlay (VAST 3.0) Image, Overlay (VAST 3.0) HTML и Overlay (VAST 3.0) HTML Custom работают только со сторонними плеерами и не поддерживаются библиотекой [Yandex Video Ads SDK](https://yandex.ru/dev/video-sdk/).

{% endnote %}

##### Non-Linear Adfox Overlay Image VAST 3.0
 
:   Шаблон для показа изображения поверх видео. Тип содержимого — изображение.
    
    Параметры при добавлении в Adfox:
    
    - **Изображение** — файл или ссылка на изображение.
    - **Ширина** — ширина изображения.
    - **Высота** — высота изображения.
    - **Нижний отступ** — отступ от нижней границы плеера в процентах.
    - **URL перехода** — ссылка, на которую осуществляется переход при клике.
    - `box-shadow` — [CSS property](https://developer.mozilla.org/ru/docs/Web/CSS/box-shadow), описывающее стиль тени, отбрасываемой изображением на видео.
    
    Обязательные параметры — изображение, ширина и высота.
    
    [Пример VAST](https://yandex.ru/ads/adfox/354188/getCode?p1=cmnqu&p2=gxcw)

##### Non-Linear Adfox Overlay HTML VAST 3.0
 
:   Шаблон для отображения произвольного HTML поверх видео. Тип содержимого — HTML-код. Вся область баннера кликабельная.
    
    Параметры при добавлении в Adfox:
    
    - **HTML-код** — HTML-код креатива.
    - **Ширина** — ширина iframe-баннера.
    - **Высота** — высота iframe-баннера.
    - **Нижний отступ** — отступ от нижней границы плеера в процентах.
    - **URL перехода** — ссылка, на которую осуществляется переход при клике.
    - `box-shadow` — [CSS property](https://developer.mozilla.org/ru/docs/Web/CSS/box-shadow), описывающее стиль тени, отбрасываемой изображением на видео.
    
    Обязательные параметры — HTML-код, ширина и высота.
    
    [Пример VAST](https://yandex.ru/ads/adfox/354188/getCode?p1=cmnqv&p2=gxcw)

##### Non-Linear Adfox Overlay HTML Custom VAST 3.0
 
:   Шаблон для отображения произвольного HTML поверх видео. Тип содержимого — HTML-код. Шаблон с возможностью задавать кликабельные области.
    
    Параметры при добавлении в Adfox:
    
    - **HTML-код** — HTML-код креатива.
    - **Ширина** — ширина iframe-баннера.
    - **Высота** — высота iframe-баннера.
    - **Нижний отступ** — отступ от нижней границы плеера в процентах.
    - **URL перехода** — ссылка, на которую осуществляется переход при клике.
    - `box-shadow` — [CSS property](https://developer.mozilla.org/ru/docs/Web/CSS/box-shadow), описывающее стиль тени, отбрасываемой изображением на видео.
    
    Обязательные параметры — HTML-код, ширина и высота.
    
    [Пример VAST](https://yandex.ru/ads/adfox/354188/getCode?p1=cmnry&p2=gxcw)

### Wrapper (VAST-редирект) {#wrapper-vast-redirect}

Экземпляр VAST, который переадресует на другой URL для получения рекламы и содержит дополнительные пиксели. Используется для проброса сторонней рекламы и промера событий в Adfox.

VAST 2.0 Wrapper может ссылаться на содержимое VAST 3.0, а VAST 3.0 Wrapper может ссылаться на VAST 2.0.

Тип содержимого — ссылка на VAST XML.


## Доступные в Adfox предзаданные шаблоны InPage {#system-templates-inpage}

##### Linear-Ad (Pre / Mid / Post-roll) VAST 2.0 for InPage
 
:   Шаблон для содержимого типа «видеофайл».

##### Linear-Ad (Pre / Mid / Post-roll) VAST 3.0 for InPage Viewability
 
:   Шаблон для содержимого «видеофайл» c проверкой видимости.

##### Wrapper VAST 2.0 for InPage
 
:   Шаблон для содержимого «Wrapper VAST XML».

Подробнее об использовании шаблонов см. раздел [InPage video](https://yandex.com/support/adfox/ru/banners/specs/inpage.md).


## Получение ссылки на VAST XML {#getting-link-vast-xml}

Ссылку на VAST можно получить как и обычные [коды вставки](https://yandex.com/support/adfox/ru/ad-inventory/codes/get-code.md) Adfox.

Вместо кода будет ссылка следующего вида:

```
https://yandex.ru/ads/adfox/168627/getCode?p1=bigha&p2=eojh&puid1=&puid2=&puid3=
```


## Проверка ссылок {#checking-links}

Проверить ссылки можно на [специальной странице](https://banners.adfox.ru/files/vast_checker.html).


## Использование собственного плеера {#using-yandex-player}

1. Подключите библиотеку ADSDK внутри тега `<head>`.

    ```html
    <html xmlns="http://www.w3.org/1999/xhtml">
    <head>
        
    </head>
    </html>
    ```
    
1. Объявите переменную: объект с параметрами Adfox.

   ```javascript
   var adFoxParameters = {
       adFoxParameters: {
           ownerId: 168627,
           // ID родительского контейнера тега <video></video>
           containerId: 'videoParent',
           // Параметры Adfox
           params: {
               p1: 'bdcfe',
               p2: 'ekza',
               pfc: 'bupfm',
               pfb: 'frtqn'
           },
       }
    }
    ```
    
1. Для старта проигрывания вызовите метод `play`, передав в него конфигурацию Adfox.

   ```javascript
   ya.videoAd.play({
       // Видеоэлемент
       videoSlot: document.querySelector('#video'),
       // Элемент для показа контролов. Элемент не должен быть статически позиционирован.
       // Можно использовать родительский элемент видео.
       slot: document.querySelector('#videoParent'),
       // Конфиг загрузки и конфиг проигрывания рекламы.
       config: adFoxParameters,
   });
   ```

Инструкции по интеграции:

- [Стандартная интеграция](https://yandex.ru/dev/video-sdk/doc/dg/sdk-html5/full-docpage/)
- [Интеграция с Adfox](https://yandex.ru/dev/video-sdk/doc/dg/sdk-html5/adfox-docpage/)


## Рекламная метка {#ad-label}

Рекламная метка и указание на рекламодателя и (или) его сайт являются обязательными, если вы запускаете рекламу для показа на территории России. Подробнее о метке и о рекламном меню читайте в разделе [Рекламная метка и рекламное меню на баннерах в Adfox](https://yandex.com/support/adfox/ru/labeling/ad-label.md).

Чтобы добавить рекламную метку в плеер, где подключена библиотека [Yandex Video Ads SDK](https://yandex.ru/dev/video-sdk/doc/dg/concepts/about.html), в списке **Метка рекламы** в параметрах баннера выберите `Реклама` или `Соцреклама`. Рекламная метка будет отображаться автоматически.

Включите опцию **Добавить рекламное меню**, если вы заполнили информацию о рекламодателе в параметрах рекламной кампании. На баннер будет добавлено рекламное меню в виде значка ![](../_images/kebab.png) с информацией о рекламодателе и токеном (если в настройках баннера включена маркировка или указан сторонний токен).

<!-- source: ru/_includes/labeling/ad-label/mark.md -->
В рекламном меню находится ссылка на правила применения рекомендательных технологий. Она необходима, чтобы соблюсти требования п. 3 ч. 1 ст. 10.2-2 Федерального закона от 27.07.2006 N 149-ФЗ «Об информации, информационных технологиях и о защите информации».
<!-- endsource: ru/_includes/labeling/ad-label/mark.md -->


Если вы не используете библиотеку [Yandex Video Ads SDK](https://yandex.ru/dev/video-sdk/doc/dg/concepts/about.html) для показа рекламы, добавьте в плеер поддержку тега `extension` в формате:

```html
<Extensions>
        <Extension type="AdTitle">
                <![CDATA[
                        {
                                "show": %banner.ad_label%,
                                "domain": "%banner.domain:jsenc%",
                                "socialAdvertising": %banner.ad_label_social%
                        }
                ]]>
        </Extension>
        <Extension type="AdTune">
                <![CDATA[
                        {
                                "show": %banner.ad_tune%, 
                                "token": "%banner.token:jsenc%", 
                                "advertiserInfo": "%campaign.advertiser:jsenc%"
                        }
                ]]>
        </Extension>
</Extensions>
```

В зависимости от настроек рекламной метки в баннере макросы принимают следующие значения:

**Макрос** | **Значение**
----- | -----
`%banner.ad_label%` | `1` (метка отображается) или `0` (метка не отображается).
`%banner.domain:jsenc%` | Домен (отображается, если `%banner.ad_label%` принимает значение `1` и в параметрах баннера заполнено поле **Домен**) или пустое значение.
`%banner.ad_label_social%` | Метка «Соцреклама», `1` (отображается, если `%banner.ad_label%` принимает значение `1`) или `0` (не отображается).
`%banner.ad_tune%` | `1` (меню отображается) или `0` (меню не отображается).
`%banner.token:jsenc%` | Токен баннера.
`%campaign.advertiser:jsenc%` | Информация о рекламодателе.


Примеры тега `extension`:


{% cut "Отображается метка без домена и рекламное меню" %}


```html
<Extensions>
        <Extension type="AdTitle">
                <![CDATA[
                        {
                                "show": 1,
                                "domain": "",
                                "socialAdvertising": 0
                        }
                ]]>
        </Extension>
        <Extension type="AdTune">
                <![CDATA[
                        {
                                "show": 1, 
                                "token": "token", 
                                "advertiserInfo": "Информация о рекламодателе"
                        }
                ]]>
        </Extension>
</Extensions>
```


{% endcut %}

{% cut "Отображается метка с доменом и рекламное меню" %}


```html
<Extensions>
        <Extension type="AdTitle">
                <![CDATA[
                        {
                                "show": 1,
                                "domain": "example.ru",
                                "socialAdvertising": 0
                        }
                ]]>
        </Extension>
        <Extension type="AdTune">
                <![CDATA[
                        {
                                "show": 1, 
                                "token": "token", 
                                "advertiserInfo": "Информация о рекламодателе"
                        }
                ]]>
        </Extension>
</Extensions>
```


{% endcut %}

{% cut "Не отображаются метка, домен и рекламное меню" %}


```html
<Extensions>
        <Extension type="AdTitle">
                <![CDATA[
                        {
                                "show": 0,
                                "domain": "example.ru",
                                "socialAdvertising": 1
                        }
                ]]>
        </Extension>
        <Extension type="AdTune">
                <![CDATA[
                        {
                                "show": 0, 
                                "token": "token", 
                                "advertiserInfo": "Информация о рекламодателе"
                        }
                ]]>
        </Extension>
</Extensions>           
```


{% endcut %}

{% cut "Отображается метка «Соцреклама» без домена и рекламного меню" %}


```html
<Extensions>
        <Extension type="AdTitle">
                <![CDATA[
                        {
                                "show": 1,
                                "domain": "",
                                "socialAdvertising": 1
                        }
                ]]>
        </Extension>
        <Extension type="AdTune">
                <![CDATA[
                        {
                                "show": 0, 
                                "token": "token", 
                                "advertiserInfo": "Информация о рекламодателе"
                        }
                ]]>
        </Extension>
</Extensions>           
```


{% endcut %}



## События {#events}

Предзаданные шаблоны в Adfox содержат контейнер `<TrackingEvents>`, внутри которого лежат теги `<Tracking>`. Каждый элемент `<Tracking>`содержит URI Adfox, по которому видеоплеер должен делать запрос, когда наступает определенное событие. Название события передается в атрибуте `event`.

Список событий:

- Начало просмотра (start).
- Ролик выбран (creativeView).
- Ролик загружен (impression).
- Первая четверть просмотра (firstQuartile).
- Середина просмотра (midpoint).
- Третья четверть просмотра (thirdQuartile).
- Полный просмотр (complete).
- Выключить звук (mute).
- Включить звук (unmute).
- Пауза (pause).
- Просмотр сначала (rewind).
- Продолжение просмотра (resume).
- Переход в полный экран (fullscreen).
- Развернуть (expand).
- Свернуть (collapse).
- Перейти к следующему ролику (acceptInvitationLinear).
- Клик по кнопке **Закрыть**, уход пользователя (close).
- Клик по плашке **Пропустить рекламу** (skip).
- Клик по плашке **Перейти на сайт рекламодателя** (addclick).
- Ошибка (Error).
- Прогресс (progress) — доступен начиная с VAST 3.0.


## Ответ в случае отсутствия рекламы {#response-no-ad}

Когда нет подходящей рекламы для показа, Adfox возвращает следующий XML:

- Тип баннера InStream:

    ```xml
    <?xml version=”1.0”?><nobanner></nobanner>
    ```
    
- Тип баннера InPage:

    ```xml
    <?xml version=”1.0”?><VAST version="2.0"/>
    ```

Чтобы добавить [баннер по умолчанию](https://yandex.com/support/adfox/ru/banners/default-banner.md) для плеерной рекламы VAST, у вас должна быть ссылка запроса рекламы. Поместите эту ссылку между квадратными скобками в блок `VASTAdTagURI`:

```xml
<?xml version="1.0" encoding="UTF-8"?>
<VAST version="2.0">
    <Ad id="%placeId%">
        <Wrapper>
            <AdSystem>Adfox.ru</AdSystem>
            <VASTAdTagURI>
                <![CDATA[//yandex.ru/ads/adfox/XXXXXX/getCode?p1=xxx&p2=xxx&pfc=a&pfb=a&plp=a&pli=a&pop=a&puid1=%userValue1%]]>
            </VASTAdTagURI>
            <Impression></Impression>
            <Creatives></Creatives>
        </Wrapper>
    </Ad>
</VAST>
```

При необходимости передавать в пробрасываемый код запроса дополнительные параметры используйте макросы:

- для значений пользовательских характеристик: `puidN` со значением `%request.puidN%`, где `N` — номер характеристики. Пример: `&puid1=%request.puid1%`;
- для передачи referer: `dl` со значением `%request.referrer:urlenc%`. Пример: `&dl=%request.referrer:urlenc%`.
    

Полученный код скопируйте и установите в поле **XML-код баннера по умолчанию** площадки и/или типа баннера.


<!-- source: ru/_includes/feedback.md -->
## Обратиться в службу поддержки



<a href="https://yandex.ru/chat/#/user/48724607-a983-9631-79e6-aad155a88db3"> <!--ссылка, куда ведет кнопка. Если внутренняя ссылка, пишем без .md и .html --> 
  <span class="button">Написать в чат</span> <!--текст на кнопке--> 
</a>

<a href="ru/form"> <!--ссылка, куда ведет кнопка. Если внутренняя ссылка, пишем без .md и .html --> 
  <span class="button">Написать письмо</span> <!--текст на кнопке--> 
</a>



<!-- source: ru/_includes/styles/button.md -->

<!-- endsource: ru/_includes/styles/button.md -->
<!-- endsource: ru/_includes/feedback.md -->