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

# Banner X-Videoanzeigen

Werbetreibende und Händler können Werbevideos in ihre Banner hochladen, die direkt auf ihrer Website oder in ihrer App angezeigt werden. Diese Videos beeinflussen Kaufentscheidungen, indem sie Produkte auf ansprechende Weise präsentieren. Interaktive Videos ermöglichen es Verbrauchern, Produkte direkt aus dem Video heraus zu entdecken und zu kaufen, mit Optionen wie **In den Warenkorb** oder **Jetzt kaufen**.

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

## Warum Video-Anzeigen für Ihre Website?

Onsite-Video ermöglicht Ihren Werbetreibenden eine tiefere Interaktion mit Ihren Käufern auf Ihrer Website. Dadurch entstehen einladendere Käufererlebnisse und die Verweildauer der Käufer auf Ihrer Website zum Erkunden ihrer Optionen wird erhöht.

| Gründe                                            | Beschreibung                                                                                                                                                                                                            |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Eine Markengeschichte fördern                     | Interaktionsstarke Video-Anzeigen präsentieren einen ansprechenden und relevanten Teil der Gesamt- oder Produktspezifischen Geschichte eines Werbetreibenden und verbinden ihn tiefer mit Ihrer Einzelhandelsmarke.     |
| Neue Produkteinführungen                          | Werbetreibende können Video nutzen, um neue Produkte eingehender vorzustellen, als dies mit einfachen Display-Anzeigen möglich wäre. Video ermöglicht es ihnen, Käufern den Wert neuer Produkte zu vermitteln.          |
| Markenbekanntheit                                 | Werbetreibende, die die Bekanntheit in einer neuen Kategorie oder mit einer neuen Botschaft steigern möchten, können Video an zentralen Stellen auf Ihrer Website nutzen, um direkt mit Ihren Käufern zu kommunizieren. |
| Die Bindung zu Ihrer Einzelhandelsmarke vertiefen | Video kann die Verbindung zwischen einem Werbetreibenden und Ihrer Einzelhandelsmarke in den Köpfen der Käufer vertiefen.                                                                                               |

## Video-Spezifikationen

* Maximale Dateigröße\*\*: 300MB
* **Akzeptierte Dateitypen**: Video/mp4, video/quicktime, video/x-msvideo
* **Optionale Codec-Validierung**: H.264, H.265
* **Höhen und Breiten**: Vom Händler in Pixeln definiert
* Dauerlimit\*\*: Keines
* **Kampagnenüberprüfung**: Obligatorisch für Banner-X-Kampagnen, die ein Videoelement enthalten
* **Tag-Unterstützung**: Standard-VAST-Tag bereitgestellt als `adm` in der Anzeigen-Antwort

## Video-Anzeigen integrieren

Sie können interaktive Banner-X-Video-Anzeigen erstellen, die sich nahtlos integrieren lassen mit [VAST 4.0](https://iabtechlab.com/wp-content/uploads/2016/05/VAST4.0_Updated_April_2016.pdf) kompatiblen Videoplayern, wodurch Händlern ein interaktives Werbeformat zur Verfügung steht, das die Bereitstellung mit minimalem Aufwand rationalisiert.

Banner X Video-Anzeigen entsprechen dem Standard Digital Video Ad Serving Template (VAST) 4.0 und gewährleisten eine reibungslose und kompatible Integration mit unterstützten Videoplayern.

Beim Einbinden von Video-Anzeigen in Kampagnen enthält die Anzeigen-Antwort ein Feld namens `adm`. Dieses Feld enthält die XML-Tags, die für die VAST 4.0-Konformität erforderlich sind, und ermöglicht eine einfache Einbettung in Videoplayer.

### Integrationsanforderungen

#### Anzeigen-Anforderung

Sie müssen eine Anzeigen-Anforderung an unseren Banner X Endpunkt senden. Video- und andere Banner-Inhalte werden nur für Kampagnen bereitgestellt, für die Videos und Banner-Inhalte konfiguriert sind. Sie müssen sicherstellen, dass Kampagnen mit Video-Assets konfiguriert sind, bevor Sie Anzeigen mit dem bereitgestellten `adm` Objekt erhalten.

Weitere Informationen zum Anfordern von Anzeigen finden Sie in [Banner X-Anzeigen generieren](/retail-media-interface/integration/de/integration/bannerx.md)

#### Videoplayer (Anzeigen-Rendering)

Epsilon Retail Media stellt einen VAST-Tag (Video Ad Server Template) in unserer Anzeigen-Antwort bereit als `adm` Objekt der Banner-X-Antwort. Daher benötigen Sie voraussichtlich einen Videoplayer, um den VAST-Tag zu parsen und die Video-Anzeige zu rendern.

{% hint style="info" %}
**Sie haben keinen Videoplayer?** Eine Vielzahl von Open-Source-Videoplayern kann verwendet werden. Wir empfehlen, verfügbare kostenpflichtige sowie Open-Source-Optionen wie Video JS oder Clappr zu prüfen. Beachten Sie, dass möglicherweise zusätzliche Plugins erforderlich sind, um VAST-Tags zu parsen.
{% endhint %}

#### Banner X Vorschau-Tool

Aktualisieren Sie Ihr Banner-X-Vorschau-Tool, um sicherzustellen, dass die Anzeigenvorschau beim Erstellen, Verwalten und Überprüfen von Kampagnen korrekt gerendert wird. Siehe [Banner X-Vorschau](/retail-media-interface/integration/de/generating-ads/banner-x-responsive/integrating-your-banner-x-previewer.md).

#### Tracking & Berichterstattung

Eine Vielzahl von Tracking-Optionen (Impressionen, Klicks, Fortschritt und Interaktion) ist möglich, bitte beachten Sie die Anleitung in [Banner X-Videointeraktionsberichte](/retail-media-interface/integration/de/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)

### Tracking-Elemente

Verwendet das [Video Ad Serving Template](https://iabtechlab.com/standards/vast/) (VAST) für Tracking-Zwecke. Der VAST-Tag enthält mehrere Tracking-Mechanismen:

* Impressions-Tracking
* Klick-Tracking
* Fortschritts-Tracking (start, firstQuartile, midpoint, thirdQuartile, complete)
  * **Erstes Quartil (25% gesehen)**: Früher Indikator für anfängliche Interaktion
  * **Mittelpunkt (50% gesehen)**: Zeigt anhaltendes Interesse des Zuschauers auf der Hälfte des Inhalts an
  * **Drittes Quartil (75% gesehen)**: Zeigt starke Bindung des Zuschauers an den Inhalt
  * **Vollständig (100% gesehen)**: Bestätigt, dass der Zuschauer das gesamte Video gesehen hat, was auf maximale Interaktion hinweist
* Interaktions-Tracking (mute, unmute, pause, resume, fullscreen)
  * **Stummschalten**: Der Benutzer hat den Video-Ton stummgeschaltet
  * **Ton einschalten**: Der Benutzer hat den Video-Ton wieder eingeschaltet
  * **Pause**: Der Benutzer hat die Videowiedergabe pausiert
  * **Fortsetzen**: Der Benutzer hat die Videowiedergabe nach dem Pausieren fortgesetzt

{% hint style="info" %}
**Anleitung zur Integration des Interaktions-Trackings anzeigen** Bitte beachten Sie die Anleitung in [Banner X-Videointeraktionsberichte](/retail-media-interface/integration/de/data-api/api-overview/ad-interaction-events-reporting/integrate-banner-x-video-interaction-reporting.md)
{% endhint %}

### Beispiel einer Anzeigen-Antwort für Video-Anzeigen

Hier ist ein Ausschnitt, wie die Video-Anzeigen-Antwort einschließlich VAST-bezogener Informationen aussehen würde:

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