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

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

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

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

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

<figure><img src="https://2131244838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MAzurVhFf9V3ESeCJ48%2Fuploads%2FyT80V4dx4wNjT8S1gu44%2Fscreenshot%20-%202025-11-24T143713.347.png?alt=media&#x26;token=faa3a2f1-65a8-41e2-ad99-484515deeee2" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://2131244838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MAzurVhFf9V3ESeCJ48%2Fuploads%2FWJ66r27gZLcAJcUkVG4C%2Fscreenshot%20-%202025-11-24T143855.896.png?alt=media&#x26;token=45490e2c-75a1-47ad-9a3a-821400e93249" alt=""><figcaption></figcaption></figure>

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

## Типы тегов

### 3rd-party tag

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

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

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

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

<figure><img src="https://2131244838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MAzurVhFf9V3ESeCJ48%2Fuploads%2FXjy1AiDcqA9VSwYXhGyF%2Fimage.png?alt=media&#x26;token=031883e8-9982-44f4-a5f9-c5645a5fccaf" 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="https://2131244838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MAzurVhFf9V3ESeCJ48%2Fuploads%2FoYPO9VfBb387kzDe0GDy%2Fimage.png?alt=media&#x26;token=864f895c-53e4-4d7c-b631-f123a5bbed4b" 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="https://2131244838-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MAzurVhFf9V3ESeCJ48%2Fuploads%2FGTJ33OpLMyv9wHnNOchx%2Fscreenshot%20-%202025-11-24T144934.491.png?alt=media&#x26;token=0cd24f1a-224f-453e-98c8-bf74a6ebd419" 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>.