> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/cs/generating-ads/banner-x-responsive/video-ads-banner-x.md).

# Video reklamy Banner X

Inzerenti a prodejci mohou do svých bannerů nahrávat propagační videa, která se zobrazují přímo na jejich webu nebo v aplikaci. Tato videa ovlivňují nákupní rozhodnutí tím, že předvádějí produkty poutavým způsobem. Interaktivní videa umožňují spotřebitelům prozkoumávat a nakupovat produkty přímo z videa pomocí možností **pridat do kosiku** nebo **koupit hned**.

<figure><img src="/files/rHM2JyOe83y3szhYSals" alt="" width="450"><figcaption></figcaption></figure>

## Proč zvolit video ads pro váš web?

Video Na webu umožňuje vašim inzerentům navázat hlubší kontakt s vašimi nakupujícími přímo na vašem webu, vytváří atraktivnější zákaznické zážitky a zvyšuje čas, který nakupující stráví na vašem webu prozkoumáváním svých možností.

| Důvody                                          | Popis                                                                                                                                                                                                             |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Propagace příběhu značky                        | Vysoce poutavé video ads představují atraktivní a relevantní část celkového příběhu inzerenta nebo příběhu konkrétního produktu, čímž je hlouběji propojují s vaší maloobchodní značkou.                          |
| Uvedení nových produktů na trh                  | Inzerenti mohou využít video k představení nových produktů do větší hloubky, než by dokázali s běžným displayem. Video jim umožňuje spojit se s nakupujícími ohledně hodnoty, kterou nové produkty mohou přinést. |
| Povědomí o značce                               | Inzerenti, kteří chtějí podpořit povědomí v nové kategorii nebo s novým sdělením, mohou využít video na klíčových místech vašeho webu a komunikovat tak přímo s vašimi nakupujícími.                              |
| Prohloubení spojení s vaší maloobchodní značkou | Video může v myslích nakupujících prohloubit spojení mezi inzerentem a vaší maloobchodní značkou.                                                                                                                 |

## Specifikace videa

* Maximální velikost souboru\*\*: 300MB
* **Akceptované typy souborů**: Video/mp4, video/quicktime, video/x-msvideo
* **Volitelná validace kodeku**: H.264, H.265
* **Výšky a šířky**: Definováno prodejcem v pixelech
* Limit délky\*\*: Žádný
* **Kontrola kampaně**: Povinná pro kampaně s bannery X, které obsahují video prvek
* **Podpora tagů**: Standardní tag VAST servírovaný jako `adm` v odpovědi na reklamu

## Integrace video ads

Můžete vytvářet interaktivní video ads pro bannery X, které se bezproblémově integrují s [VAST 4.0](https://iabtechlab.com/wp-content/uploads/2016/05/VAST4.0_Updated_April_2016.pdf) kompatibilními přehrávači videa, což prodejcům poskytuje interaktivní reklamní formát, který zjednodušuje nasazení s minimálním úsilím.

Banner X video ads dodržují standard Digital Video Ad Serving Template (VAST) 4.0, což zajišťuje plynulou a kompatibilní integraci s podporovanými přehrávači videa.

Při začlenění video ads do kampaní obsahuje odpověď na reklamu pole s názvem `adm`. Toto pole obsahuje XML tagy vyžadované pro soulad s VAST 4.0, což umožňuje snadné vložení do přehrávačů videa.

### Požadavky na integraci

#### Požadavek na reklamu

Budete muset odeslat požadavek na reklamu na náš Banner X endpoint. Video a další obsah banneru budou servírovány pouze pro kampaně, které mají nakonfigurovaná videa a obsah banneru. Musíte se ujistit, že existují kampaně, které jsou nakonfigurovány s video podklady, než obdržíte reklamy s `adm` poskytnutým objektem.

Více o tom, jak požadovat reklamy, si můžete přečíst v [Generovat reklamy pro bannery X](/retail-media-interface/integration/cs/integration/bannerx.md)

#### Přehrávač videa (vykreslování reklamy)

Epsilon Retail Media servíruje tag VAST (Video Ad Server Template) v naší odpovědi na reklamu jako `adm` objekt odpovědi banneru X. Jako takový budete pravděpodobně potřebovat přehrávač videa k zpracování tagu VAST a vykreslení video ad.

{% hint style="info" %}
**Nemáte přehrávač videa?** Lze použít řadu open-source přehrávačů videa. Doporučujeme projít dostupné placené i open-source možnosti, jako je Video JS nebo Clappr. Upozorňujeme, že ke zpracování tagů VAST mohou být vyžadovány dodatečné pluginy.
{% endhint %}

#### Banner X previewer

Aktualizujte svůj previewer pro bannery X, abyste zajistili správné náhledy reklam při vytváření, správě a kontrole kampaní. Viz [Previewer pro bannery X](/retail-media-interface/integration/cs/generating-ads/banner-x-responsive/integrating-your-banner-x-previewer.md).

#### Sledování a reportování

Je možná celá řada sledování (imprese, kliknutí, průběh a interakce), přečtěte si prosím průvodce v [Reportování interakcí s videem u bannerů X](/retail-media-interface/integration/cs/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)

### Prvky sledování

Používá [Video Ad Serving Template](https://iabtechlab.com/standards/vast/) (VAST) pro účely sledování. Tag VAST obsahuje několik mechanismů sledování:

* Sledování impresí
* Sledování kliknutí
* Sledování průběhu (start, firstQuartile, midpoint, thirdQuartile, complete)
  * **První kvartil (25 % zhlédnuto)**: Sledovaný indikátor počátečního zapojení
  * **Střed (50 % zhlédnuto)**: Indikuje přetrvávající zájem diváka v polovině obsahu
  * **Třetí kvartil (75 % zhlédnuto)**: Ukazuje silné zaujetí diváka obsahem
  * **Dokončeno (100 % zhlédnuto)**: Potvrzuje, že divák zhlédl celé video, což značí maximální zapojení
* Sledování interakce (mute, unmute, pause, resume, fullscreen)
  * **Mute**: Uživatel ztlumil zvuk videa
  * **Unmute**: Uživatel zapnul zvuk videa
  * **Pause**: Uživatel pozastavil přehrávání videa
  * **Resume**: Uživatel obnovil přehrávání videa po pozastavení

{% hint style="info" %}
**Zobrazit průvodce integrací pro sledování interakcí** Přečtěte si prosím průvodce v [Reportování interakcí s videem u bannerů X](/retail-media-interface/integration/cs/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)
{% endhint %}

### Příklad odpovědi na reklamu pro video ads

Zde je ukázka toho, jak by vypadala odpověď pro video ad včetně informací souvisejících s VAST:

```
{
  "ads": [
    {
      "contentStandardId": "00000000-0000-0000-0000-000000000001",
      "slotId": "Double_Tile",
      "banners": [
        {
          "citrusAdId": "example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789",
          "citrusCampaignName": "Example-Campaign-Name",
          "citrusContentStandardId": "00000000-0000-0000-0000-000000000001",
          "citrusSlotId": "Double_Tile",
          "citrusExpiry": "2026-12-31T00:00:00.000000000Z",
          "headingText": "Example heading text",
          "bannerText": "Example banner text",
          "bannerTextColour": "000000",
          "tags": {},
          "gtins": [
            "00000000000000"
          ],
          "sellerId": "",
          "position": 1,
          "metadata": {},
          "adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<VAST version=\"4.0\">
    <Ad id=\"1\">
        <InLine>
            <AdSystem>CitrusAd</AdSystem>
            <Impression><![CDATA[https://example.com/v1/resource/first-i/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]></Impression>
            <ViewableImpression>
                <Viewable><![CDATA[https://example.com/v1/resource/first-i/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]></Viewable>
                <NotViewable></NotViewable>
                <ViewUndetermined></ViewUndetermined>
            </ViewableImpression>
            <AdTitle>example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789</AdTitle>
            <Creatives>
                <Creative>
                    <UniversalAdId
                        idRegistry=\"citrusad.com\"
                        idValue=\"00000000-0000-0000-0000-000000000002\">
                        00000000-0000-0000-0000-000000000002
                    </UniversalAdId>
                    <Linear>
                        <Duration></Duration>
                        <MediaFiles>
                            <ClosedCaptionFiles>
                                <ClosedCaptionFile type=\"text/vtt\" language=\"en\">
                                    <![CDATA[https://example.com/media/example-transcript.vtt]]>
                                </ClosedCaptionFile>
                            </ClosedCaptionFiles>
                            <Mezzanine>
                                <![CDATA[https://example.com/media/example-video-1.mp4]]>
                            </Mezzanine>
                            <MediaFile
                                delivery=\"progressive\"
                                type=\"video/mp4\"
                                width=\"160\"
                                height=\"128\"
                                bitrate=\"3552\"
                                codec=\"h264\">
                                <![CDATA[https://example.com/media/example-video-1.mp4]]>
                            </MediaFile>
                        </MediaFiles>
                        <VideoClicks>
                            <ClickTracking>
                                <![CDATA[https://example.com/v1/resource/second-c/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]>
                            </ClickTracking>
                            <ClickThrough></ClickThrough>
                        </VideoClicks>
                    </Linear>
                </Creative>

                <Creative>
                    <UniversalAdId
                        idRegistry=\"citrusad.com\"
                        idValue=\"00000000-0000-0000-0000-000000000003\">
                        00000000-0000-0000-0000-000000000003
                    </UniversalAdId>
                    <Linear>
                        <Duration></Duration>
                        <MediaFiles>
                            <Mezzanine>
                                <![CDATA[https://example.com/media/example-video-2.mp4]]>
                            </Mezzanine>
                            <MediaFile
                                delivery=\"progressive\"
                                type=\"video/mp4\"
                                width=\"1920\"
                                height=\"1080\"
                                bitrate=\"832398\"
                                codec=\"h264\">
                                <![CDATA[https://example.com/media/example-video-2.mp4]]>
                            </MediaFile>
                        </MediaFiles>
                        <VideoClicks>
                            <ClickTracking>
                                <![CDATA[https://example.com/v1/resource/second-c/example_ad_id_AbCdEfGhIjKlMnOpQrStUvWxYz0123456789]]>
                            </ClickTracking>
                            <ClickThrough></ClickThrough>
                        </VideoClicks>
                    </Linear>
                </Creative>
            </Creatives>
        </InLine>
    </Ad>
</VAST>",
          "videoTranscriptFiles": [
            {
              "videoFileId": "00000000-0000-0000-0000-000000000002",
              "format": "txt",
              "url": "https://example.com/media/example-transcript.txt",
              "language": "en"
            }
          ]
        }
      ]
    }
  ]
}
```

<br>


---

# 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://help.citrusad.com/retail-media-interface/integration/cs/generating-ads/banner-x-responsive/video-ads-banner-x.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.