> 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/hu/generating-ads/banner-x-responsive/video-ads-banner-x.md).

# Banner X videóhirdetések

A hirdetők és a kiskereskedők promóciós videókat tölthetnek fel a bannereikre, amelyek közvetlenül a webhelyükön vagy alkalmazásukban jelennek meg. Ezek a videók befolyásolják a vásárlási döntéseket azáltal, hogy lebilincselő módon mutatják be a termékeket. Az interaktív videók lehetővé teszik a fogyasztók számára, hogy közvetlenül a videóból böngésszenek és vásároljanak termékeket **kosárhoz adás** vagy **vásárlás most** opciókkal.

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

## Miért érdemes videóhirdetéseket használni a webhelyén?

A webhelyen megjelenő videók lehetővé teszik a hirdetők számára, hogy mélyebb kapcsolatot alakítsanak ki a vásárlókkal az Ön webhelyén, vonzóbb vásárlói élményt teremtve, és növelve a vásárlók által az Ön webhelyén töltött időt a lehetőségeik feltérképezése során.

| Okok                                                | Leírás                                                                                                                                                                                                                                     |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Márkatörténet népszerűsítése                        | A magas elkötelezettséget kiváltó videóhirdetések bemutatják a hirdető teljes vagy termékspecifikus történetének lebilincselő és releváns részét, mélyebben összekapcsolva őket az Ön kiskereskedelmi márkájával.                          |
| Új termékek bevezetése                              | A hirdetők videók segítségével alaposabban mutathatják be az új termékeket, mint a hagyományos display hirdetésekkel. A videó lehetővé teszi számukra, hogy kapcsolatba lépjenek a vásárlókkal az új termékek által kínált értékek mentén. |
| Márkaismertség                                      | Az új kategóriákban vagy új üzenetekkel márkaismertséget növelni kívánó hirdetők videókat használhatnak a webhely kulcsfontosságú helyein, hogy közvetlenül kommunikáljanak a vásárlókkal.                                                 |
| Mélyítse a kapcsolatot a kiskereskedelmi márkájával | A videó mélyítheti a hirdető és az Ön kiskereskedelmi márkája közötti kapcsolatot a vásárlók tudatában.                                                                                                                                    |

## Videóspecifikációk

* Maximális fájlméret\*\*: 300 MB
* **Elfogadott fájltípusok**: Video/mp4, video/quicktime, video/x-msvideo
* **Opcionális kodek-ellenőrzés**: H.264, H.265
* **Magasság és szélesség**: A kiskereskedő által megadva képpontban (pixel)
* Időtartam-korlát\*\*: Nincs
* **Kampányellenőrzés**: Kötelező azon banner X kampányok esetében, amelyek videóelemet tartalmaznak
* **Címketámogatás**: Standard VAST-címke a következőként szolgáltatva: `adm` a hirdetési válaszban

## Videóhirdetések integrálása

Létrehozhat olyan interaktív banner X videóhirdetéseket, amelyek zökkenőmentesen integrálódnak a következővel: [VAST 4.0](https://iabtechlab.com/wp-content/uploads/2016/05/VAST4.0_Updated_April_2016.pdf) kompatibilis videólejátszók, amelyek interaktív hirdetési formátumot biztosítanak a kiskereskedők számára, minimális ráfordítással egyszerűsítve a bevezetést.

Banner X a videóhirdetések követik a Digital Video Ad Serving Template (VAST) 4.0 szabványt, biztosítva a zökkenőmentes és kompatibilis integrációt a támogatott videólejátszókkal.

Amikor videóhirdetéseket épít be a kampányokba, a hirdetési válasz tartalmaz egy mezőt, melynek neve: `adm`. Ez a mező tartalmazza a VAST 4.0 megfelelőséghez szükséges XML-címkéket, lehetővé téve a könnyű beágyazást a videólejátszókba.

### Integrációs követelmények

#### Hirdetéskérés

Hirdetéskérést kell küldenie a következős végpontunkra: Banner X endpoint. Videós és egyéb banner-tartalmak csak olyan kampányokhoz kerülnek kiszolgálásra, amelyeknél a videók és a banner-tartalmak konfigurálva vannak. Gondoskodnia kell arról, hogy legyenek videós elemekkel konfigurált kampányok, mielőtt megkapná a hirdetéseket a megadott `adm` objektummal.

A hirdetések kéréséről bővebben itt olvashat: [Banner X hirdetések generálása](/retail-media-interface/integration/hu/integration/bannerx.md)

#### Videólejátszó (hirdetésmegjelenítés)

Epsilon Retail Media egy VAST-címkét (Video Ad Server Template) szolgál ki a hirdetési válaszunkban, mint a `adm` objektumaként. Így valószínűleg szüksége lesz egy videólejátszóra a VAST-címke beolvasásához és a videóhirdetés megjelenítéséhez.

{% hint style="info" %}
**Nincs videólejátszója?** Különféle nyílt forráskódú videólejátszók használhatók. Javasoljuk az elérhető fizetős és nyílt forráskódú lehetőségek áttekintését, mint például a Video JS vagy a Clappr. Vegye figyelembe, hogy a VAST-címkék beolvasásához további bővítményekre lehet szükség.
{% endhint %}

#### Banner X előnézeti eszköz

Frissítse a banner x előnézeti eszközét annak érdekében, hogy a hirdetés előnézete megfelelően jelenjen meg a kampányok létrehozása, kezelése és felülvizsgálata során. Lásd: [Banner X előnézeti eszköz](/retail-media-interface/integration/hu/generating-ads/banner-x-responsive/integrating-your-banner-x-previewer.md).

#### Mérés és jelentéskészítés

Különféle mérések (megjelenések, kattintások, előrehaladás és interakció) mind lehetségesek, kérjük, olvassa el az útmutatót itt: [Banner X videóinterakciós jelentéskészítés](/retail-media-interface/integration/hu/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)

### Mérési elemek

A következőt használja [Video Ad Serving Template](https://iabtechlab.com/standards/vast/) (VAST) mérési célokra. A VAST-címke számos mérési mechanizmust tartalmaz:

* Megjelenésmérés
* Kattintásmérés
* Előrehaladás mérése (start, firstQuartile, midpoint, thirdQuartile, complete)
  * **Első kvartilis (25% megtekintve)**: A kezdeti elkötelezettség korai mutatója
  * **Felezőpont (50% megtekintve)**: Tartós nézői érdeklődést jelez a tartalom felénél
  * **Harmadik kvartilis (75% megtekintve)**: A néző erős elkötelezettségét mutatja a tartalom iránt
  * **Befejezve (100% megtekintve)**: Megerősíti, hogy a néző a teljes videót megtekintette, ami maximális elkötelezettséget jelez
* Interakciók mérése (mute, unmute, pause, resume, fullscreen)
  * **Némítás**: A felhasználó elnémította a videó hangját
  * **Némítás feloldása**: A felhasználó visszahangosította a videót
  * **Szünet**: A felhasználó szüneteltette a videó lejátszását
  * **Folytatás**: A felhasználó szüneteltetés után folytatta a videó lejátszását

{% hint style="info" %}
**Tekintse meg az interakciók mérésére vonatkozó integrációs útmutatót** Kérjük, olvassa el az útmutatót itt: [Banner X videóinterakciós jelentéskészítés](/retail-media-interface/integration/hu/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)
{% endhint %}

### Példa hirdetési válasz videóhirdetésekhez

Íme egy részlet arról, hogyan nézne ki a videóhirdetés válasza, beleértve a VAST-tal kapcsolatos információkat:

```
{
  "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/hu/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.
