> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/publishers/ru/vast/vast-tag.md).

# VAST Tag

## Пример XML

```xml
<?xml version="1.0" encoding="UTF-8"?>
<VAST version="3.0">
    <Ad id="1111111">
        <InLine>
            <AdSystem>Exoclick</AdSystem>
            <AdTitle/>
            <Impression id="exotr">
                <![CDATA[https://syndication.myadserver.com/vregister.php?a=vimp&tracking_event=impression&idzone=22222&data=abcd]]></Impression>
            <Error>
                <![CDATA[https://syndication.myadserver.com/vregister.php?a=vview&errorcode=[ERRORCODE]&idzone=22222]]></Error>
            <Creatives>
                <Creative sequence="1" id="12345">
                    <Linear skipoffset="00:00:05">
                        <Duration>00:00:20.54</Duration>
                        <TrackingEvents>
                            <Tracking id="prog_1" event="progress" offset="00:00:10.000">
                                <![CDATA[https://syndication.myadserver.com/vregister.php?a=vview&tracking_event=progress&progress=00:00:10.000&idzone=22222&data=abcd]]></Tracking>
                        </TrackingEvents>
                        <VideoClicks>
                            <ClickThrough>
                                <![CDATA[https://syndication.myadserver.com/click.php?data=abcd]]></ClickThrough>
                        </VideoClicks>
                        <MediaFiles>
                            <MediaFile delivery="progressive" type="video/mp4">
                                <![CDATA[https://static.myadserver.com/library/12345/myvideo.mp4]]></MediaFile>
                        </MediaFiles>
                        <Icons>
                            <Icon>
                                <IconClicks>
                                    <IconClickThrough>exoclick.com</IconClickThrough>
                                </IconClicks>
                            </Icon>
                        </Icons>
                    </Linear>
                </Creative>
            </Creatives>
            <Extensions>
                <Extension>
                    <TitleCTA>
                        <MobileText>Подробнее</MobileText>
                        <PCText>Подробнее</PCText>
                        <DisplayUrl><![CDATA[]]></DisplayUrl>
                        <Tracking><![CDATA[https://syndication.myadserver.com/click.php?data=abcd]]></Tracking>
                    </TitleCTA>
                </Extension>
                <Extension>
                    <DSA>
                        <Behalf>Exoclick SL</Behalf>
                        <Paid>Exoclick SL</Paid>
                        <WhyThisAd>Время суток. Ваше общее местоположение (например, страна или регион). Веб-сайты или приложения, которые вы могли посещать.</WhyThisAd>
                        <ClickThrough>
                            <![CDATA[ https://a.magsrv.com/about-this-ad.html?data=eyJhZHZlcnRpc2VyX25hbWUiOiJFeG9jbGljayBTTCJ9 ]]>
                        </ClickThrough>
                    </DSA>
                </Extension>
            </Extensions>
        </InLine>
    </Ad>
</VAST>
```

## Свойства

| Параметр                                 | Пояснение                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `<?xml version="1.0" encoding="UTF-8"?>` | XML-пролог с указанными версией и кодировкой.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `Реклама`                                | Корневой элемент объявления, представляющий одну рекламу. Он содержит всю информацию, необходимую видеоплееру для отображения и отслеживания креатива объявления. **Exoclick в настоящее время поддерживает одно объявление на один ответ VAST, поскольку это распространенная практика.** Атрибут "id" объявления представляет идентификатор торговой кампании.                                                                                                                                                                                                                                                                                                                                                                  |
| `Встроенный`                             | Элемент, содержащий все файлы и URI, необходимые для воспроизведения и отслеживания рекламы.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `Система рекламы`                        | Элемент, содержащий описательное имя системы, которая обслуживает рекламу, которое должна предоставлять каждая сторона, обслуживающая рекламу.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `Заголовок рекламы`                      | **Не предоставляется.**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `Показы`                                 | Элемент, содержащий URI отслеживания показов для рекламы. Показы `id` атрибут представляет идентификатор рекламного сервера для показа.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `Ошибка`                                 | Элемент, содержащий URI, который плеер использует для уведомления рекламного сервера при возникновении ошибок во время воспроизведения рекламы. Если URI содержит макрос \[ERRORCODE], видеоплеер должен подставить код ошибки.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `Креативы`                               | Контейнерный элемент для одного или нескольких `<Creative>` элемент, используемый для предоставления файлов креатива для рекламы. Для рекламы InLine, `<Creatives>` элемент вкладывает все файлы, необходимые для выполнения и отслеживания рекламы.                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `Креатив`                                | Каждый элемент содержит вложенные элементы, описывающие тип показываемой рекламы, используя вложенные подэлементы для `Линейный` или `Нелинейный` объявлений. Exoclick предоставляет только один `<Creative>` элемент на каждый ответ VAST. Креатив `последовательность` атрибут представляет последовательность, поэтому для одного креатива значение "sequence" будет 1. Креатив Exoclick `id` атрибут представляет идентификатор выигравшего креатива.                                                                                                                                                                                                                                                                         |
| `Линейный`                               | Задает видеорекламу, которая воспроизводится линейно в потоковом контенте, то есть до, во время перерыва или после потокового контента. Линейный креатив должен содержать как минимум, `<Duration>` элемент для указания предполагаемой длительности показа и `<MediaFiles>` элемент, используемый для предоставления необходимых видеофайлов для показа рекламы. Exoclick также предоставляет `События отслеживания`, `Клики по видео` и `Иконки` (необязательно). Линейный `смещение пропуска` атрибут определяет, когда элементы управления пропуском становятся доступны конечному пользователю.                                                                                                                              |
| `Длительность`                           | Элемент для обозначения предполагаемой длительности воспроизведения линейного компонента рекламы. Значение времени может быть в формате `HH:MM:SS`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `Медиафайлы`                             | Контейнерный элемент для одного или нескольких `<MediaFile>` элементы, каждый из которых содержит `CDATA` URI в обертке CDATA к медиафайлу, который будет загружен или передан потоком для линейного креатива. Линейные креативы обычно являются видеофайлами, но также могут использоваться статические изображения. Exoclick поддерживает только один `MediaFile` и не поддерживаются MediaFile для разных устройств или с разным битрейтом.                                                                                                                                                                                                                                                                                    |
| `MediaFile`                              | Элемент содержит URI к обслуживаемому медиафайлу. MediaFile `способ доставки` атрибут — либо `прогрессивная` для протоколов прогрессивной загрузки (таких как HTTP) или `потоковая` для потоковых протоколов. MediaFile `тип` атрибут — MIME-тип контейнера файла, например `video/mp4` для MP4.                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `Клики по видео`                         | Элемент, который используется для указания того, что должен делать видеоплеер, если пользователь щелкнет прямо в области видеоплеера, пока реклама отображается. Когда `<VideoClicks>` элемент предоставлен, он содержит один дочерний `<ClickThrough>` элемент с URI (или `<ClickTracking>` в случае Wrapper).                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `Переход по клику`                       | Это URI клика, который перенаправляет на сайт рекламодателя, когда зритель рекламы нажимает на объявление. Переход по клику `переход по клику` доступен только в `Встроенный` формате и используется, когда линейный рекламный блок не может обработать переход по клику.                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `События отслеживания`                   | Элемент, используемый для отправки информации отслеживания обратно на рекламный сервер. Этот `<TrackingEvents>` элемент может содержать один или несколько `<Tracking>` элементов. Атрибут event для `<Tracking>` элемента позволяет рекламному серверу включать отдельные URI отслеживания для событий, которые он хочет отслеживать. Атрибут "event" отслеживания — Exoclick готов к `показам`, `прогрессу`, `завершению`, но в большинстве случаев только `прогрессу` возвращается. Отслеживание `смещение` атрибут — когда прогресс линейного креатива достиг указанного значения, срабатывает включенный URI. Если длительность неизвестна, когда смещение задано в процентах, событие прогресса может быть проигнорировано. |
| `Иконки`                                 | Используется для отображения значка вместе с линейной рекламой. Exoclick предоставляет только один значок в разделе Icons. Его можно отключить, установив `imp.ext.icons_support = 0` в RTB-запросе.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `Значок`                                 | Элемент, содержащий `<IconClicks>` элемент.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `Клики по значку`                        | Элемент, используемый для загрузки информационной страницы в новом окне, а также для отслеживания кликов пользователей по рекламе.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `Переход по клику на значок`             | Элемент содержит URI информационной страницы. Видеоплеер должен открыть эту страницу в новом окне, когда пользователь нажимает на значок.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `Расширения`                             | Элемент, используемый для пользовательских расширений, определяемых рекламным сервером. Он должен содержать `<Extension>` элемент.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `Расширение`                             | Элемент, используемый для каждой пользовательской функции                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `Заголовок CTA`                          | Пользовательский элемент для поддержки CTA, он содержит следующие элементы: `<MobileText>`, `<PCText>`, `<DisplayUrl>`, `<Tracking>`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `Текст для мобильных устройств/ПК`       | Элементы содержат текст CTA, например `Подробнее` или `Подписаться сейчас`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `Отображаемый URL`                       | Необязательный удобочитаемый домен.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `Отслеживание`                           | URI отслеживания кликов. В Exoclick это можно отключить, установив отправку `imp.ext.video_cta = 0` в RTB-запросе.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `DSA`                                    | Пользовательский элемент для поддержки DSA, он содержит следующие элементы: `<Behalf>`, `<Paid>`, `<WhyThisAd>`, `<ClickThrough>`. Это [Закон о цифровых услугах](/exoclick-docs/dsa.md) оговорка.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `От имени` и `Оплативший`                | Имя рекламодателя, оплатившего эту рекламу                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `Почему эта реклама`                     | Конкретная пользовательская информация, которая была собрана                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `Переход по клику`                       | Дополнительная информация, связанная с [DSA](/exoclick-docs/dsa.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.exoclick.com/publishers/ru/vast/vast-tag.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
