# Работа с различными типами тегов

{% hint style="info" %}
Тег — это тип рекламного материала, доставляемого со сторонних серверов. Основная особенность такого формата — добавление к объявлению скриптов, которые помогают получить дополнительную статистику о взаимодействии пользователя с рекламным материалом и данные по оценке места, где показывается реклама.
{% endhint %}

Тег используется в случаях, когда необходимо подключить сторонние системы аналитики и сделать измерения рекламы с дополнительными метриками.

## Как загружать теги?

Чтобы загрузить тег нужного формата, перейдите в раздел «Объявления» и кликните на «Создать объявление».

<figure><img src="/files/0tOyV45wEI8y12QHqMXH" alt=""><figcaption></figcaption></figure>

После этого откроется список всех типов объявлений, которые можно использовать в Hybrid Platform.

В Hybrid Platform поддерживаются следующие стандарты, описывающие обмен данными видеоплеера и сервера:

* VAST;
* VPAID;
* 3rd-party tag.

<figure><img src="/files/eMHhpZxVdGPGKmi8kCdz" alt=""><figcaption></figcaption></figure>

На нашей платформе они являются отдельным типом баннера. Рассмотрим создание каждого подробнее.

## Типы тегов

### 3rd-party tag

3rd-party tag — это фрагмент кода, который вставляется на веб-сайт и позволяет передавать данные между разными рекламными платформами и системами.

Используется для отслеживания показов, взаимодействия с объявлением и сбора сторонних данных (например, о поведении пользователя на других сайтах) для более точной настройки рекламы.

Для загрузки 3rd-party tag в настройках загружаем готовый файл HTML-формата или же заполняем пустую форму для каждого отдельного баннера:

* загружаем объявление;
* выбираем размер из представленных вариантов или же указываем его вручную;
* указываем ККТУ (классификатор категории товаров и услуг);
* вставляем HTML-шаблон;
* называем баннер;
* указываем используется ли MRAID-механика в креативе.

<figure><img src="/files/Kt0VkusidgApEcDRURsb" alt=""><figcaption></figcaption></figure>

Пример:

```
<script src="https://bs.serving-sys.com/BurstingPipe/adServer.bs?cn=rsb&c=28&pli=29570846&PluID=0&w=240&h=400&ord=[timestamp]&ucm=true&ncu=%%CLICK_URL_UNESC%%&mb=1&ebappid=$$AppId$$"></script>
<noscript>
```

Далее рассмотрим типы объявлений, которые созданы для единого стандарта доставки рекламы в видеоплееры и позволяют внедрять видеорекламу на сайт. Это упрощает формат работы рекламодателя и рекламной площадки, но они имеют некоторые особенности, которые мы рассмотрим ниже.

### VAST Tag Banner

Video Ad Serving Template (VAST) — это стандартный XML-файл, который содержит инструкции для видеоплеера по воспроизведению рекламы, а также данные для отслеживания ее эффективности.

Данный тег поддерживает отслеживание ключевых показателей (показы, клики) видео, которые позволяют провести первоначальную оценку эффективности рекламы.

Чтобы создать объявление, укажите URL для получения XML-шаблона или же пропишите XML-шаблон.

Далее заполняем поля:

* название объявления, которое видно будет только вам;
* ККТУ (классификатор категории товаров и услуг).

<figure><img src="/files/q66YOQo79H7mzqPIgv6v" alt=""><figcaption></figcaption></figure>

Пример:

{% code expandable="true" %}

```
<VAST version="3.0">
  <Ad id="aGVscA">
   <InLine>
     <AdSystem>Hybrid</AdSystem>
     <AdTitle>Our video ad</AdTitle>
     <AdServingId>a532d16d-4d7f-4440-bd29-2ec05553fc80</AdServingId>
     <Impression><![CDATA[https://adserver.com/track/impression]]></Impression>
     <TrackingEvents>
      <Tracking type="start"><![CDATA[{your url}]]></Tracking>
      <Tracking type="creativeView"><![CDATA[{your url}]]></Tracking>
      <Tracking type="firstQuartile"><![CDATA[{your url}]]></Tracking>
      <Tracking type="midpoint"><![CDATA[{your url}]]></Tracking>
      <Tracking type="thirdQuartile"><![CDATA[{your url}]]></Tracking>
      <Tracking type="complete"><![CDATA[{your url}]]></Tracking>
      <Tracking type="skip"><![CDATA[{your url}]]></Tracking>
      <Tracking type="close"><![CDATA[{your url}]]></Tracking>
     </TrackingEvents>
     <VideoClicks>
      <ClickThrough><![CDATA[{your landing}]]></ClickThrough>
      <ClickTracking><![CDATA[{your url}]]></ClickTracking>
     </VideoClicks>
     <Creatives>
       <Creative>
        <Linear skipoffset="00:00:05">
         <Duration>00:00:20</Duration>
         <MediaFiles>
          <MediaFile
            delivery="progressive"
            type="video/mp4"
            width="672"
            height="480">
             <![CDATA[{mediafile url}]]>
          </MediaFile>
         </MediaFiles>
        </Linear>
       </Creative>
     </Creatives>
   </InLine>
  </Ad>
 </VAST>
```

{% endcode %}

### VPAID Tag Banner

VPAID (Video Player-Ad Interface Definition) — это расширенный стандарт для интерактивной видеорекламы, который позволяет роликам взаимодействовать с видеопроигрывателем и пользователем.

Это не просто видеофайл, а скрипт (часто HTML/CSS/JavaScript), который предоставляет более глубокие возможности для управления, измерения (например, кликабельность, безопасность бренда, мошенничество) и интерактивности, такой как создание опросов или динамических элементов.

Помимо аналогичных полей настроек, как у типа VAST, укажите:

* используется ли в креативе MRAID-стандарт (для мультимедийной/интерактивной рекламы в мобильных приложениях);
* ссылку на свой сайт.

<figure><img src="/files/12nLB5MVmfg50tWFFuwC" alt=""><figcaption></figcaption></figure>

Пример:

{% code expandable="true" %}

```
<VAST version="3.0">
<Ad id="1234567">
<InLine>
<AdSystem>ASTRA</AdSystem>
<AdTitle>VPAID</AdTitle>
<Description>Complex Vpaid Ad</Description>
<Impression><![CDATA[https://bs.serving-sys.com/serving/adServer.bs?cn=display&c=19&mc=imp&pli=29104513&PluID=0&ord=[timestamp]&rtu=-1]]></Impression>
<Creatives>
<Creative sequence="1">
<Linear>
<Duration>00:00:30</Duration>
<AdParameters>
<![CDATA[{
"videos":[
{
"url" : "https://content.hybrid.ai/vast/vpaid/marimer/marimer360.mp4",
"mimetype": "video/mp4"
}
],
"overlay" : {
"src": "https://content.hybrid.ai/vast/vpaid/marimer/5.html"
},
"clicks": {
"default": "%%CLICK_URL_UNESC%%https://www.marimer.ru/promo/?utm_source=Hybrid&utm_medium=cpm&utm_campaign=Marimer_Promo_partners&utm_term=100#partners",
"button1": "%%CLICK_URL_UNESC%%https://www.marimer.ru/promo/?utm_source=Hybrid&utm_medium=cpm&utm_campaign=Marimer_Promo_partners&utm_term=100#partners",
"button2": "%%CLICK_URL_UNESC%%https://www.marimer.ru/promo/?utm_source=Hybrid&utm_medium=cpm&utm_campaign=Marimer_Promo_registration&utm_term=100#registration",
"button3": "%%CLICK_URL_UNESC%%https://www.marimer.ru/promo/?utm_source=Hybrid&utm_medium=cpm&utm_campaign=Marimer_Promo_registrationWA&utm_term=100#registration"
},
"pixels": {
"button1": "https://{tracking_domain}/DeliverySeance/SaveCustomBannerEvent1?sid={seanceid}",
"button2": "https://{tracking_domain}/DeliverySeance/SaveCustomBannerEvent2?sid={seanceid}",
"button3": "https://{tracking_domain}/DeliverySeance/SaveCustomBannerEvent3?sid={seanceid}",
"overlay": "https://{tracking_domain}/DeliverySeance/SaveCustomBannerEvent1?sid={seanceid}"
}
}]]>
</AdParameters>
<VideoClicks>
</VideoClicks>
<MediaFiles>
<MediaFile apiFramework="VPAID" type="application/javascript">
<![CDATA[https://content.hybrid.ai/vast/vpaid/marimer/vpaid4.js]]>
</MediaFile>
</MediaFiles>
</Linear>
</Creative>
</Creatives>
</InLine>
</Ad>
</VAST>
```

{% endcode %}

## Модерация тегов

Все теги перед отправкой в SSP проходят обязательную проверку на наличие вредоносного кода. Для этого используется платформа компании-партнера The Media Trust (TMT).

Основная цель модерации — проверка рекламы на предмет соответствия нормам и отсутствие вредоносного содержимого в коде тегов. Как правило, модерация занимает до 24 часов.

Подробнее о статусах модерации для объявлений и рекламных кампаний можно изучить [тут](https://docs.hybrid.ai/platform-documentation/getting-started/statusy-moderacii).

## Параметры тегов для использования макросов

Мы можем добавлять в ссылки любые макросы, доступные в нашей системе.

Каждый 3rd-party tag сторонней системы имеет свои параметры для простановки макросов.&#x20;

{% hint style="warning" %}
Важно! Чтобы в нашей системе появлялись клики, в теге обязательно нужно прописывать параметр «%%CLICK\_URL\_UNESC%%». В противном случае в промерителях типа Adserving или Weborama будет показываться определенное кол-во кликов, а в Hybrid Platform они будут равны 0.
{% endhint %}

> Иногда при загрузке тега в Hybrid Platform вы можете не увидеть превью вашего объявления. Почему так происходит?
>
> 1. Все пути в теге должны быть прописаны через протокол https.
> 2. Возможно, на стороне клиента настроена визуализация баннера только при доставке рекламы на сайт. В этом случае отсутствие превью в кабинете никак не повлияет на отображение вашего объявления на сайте при запуске.

Если у вас возникли вопросы, вы всегда можете обратиться за помощью к своему аккаунт-менеджеру или написать нам на почту <support@hybrid.ru>.


---

# Agent Instructions: 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:

```
GET https://hybrid.gitbook.io/platform-documentation/getting-started/tags.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.