> For the complete documentation index, see [llms.txt](https://sdn.docs.3q.video/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sdn.docs.3q.video/interface/module/video-advertising.md). # Video Advertising Mit diesem Modul werden Pre-, Mid- und Postroll Ads in Livestreams und Videos platziert. Dazu benötigen Sie AdTags bzw. VAST-URLs von VAST und VPAID-fähige Adserver oder Google DFP (Google Ads). {% hint style="info" %} Das Modul Analytics Advanced bietet Auswertungen zur Auslieferung von Ads. {% endhint %} #### Die grundlegenden Einrichtungsschritte sind: 1. Modul in der Modulverwaltung hinzufügen 2. AdTags anlegen 3. ggf. im OnDemand-Projekt eine Kategorie zuweisen 4. Werbung für den Player aktivieren ## Übersicht Zum **Öffnen** gehen Sie im **Hauptmenü** auf den Menüpunkt **Module**. Klicken Sie im Drop-down-Menü auf **Video Advertising.** #### Die Übersicht zeigt angelegte AdTags bzw. Kampagnen mit folgenden Informationen: * **ID** - wird automatisch erstellt, kann nicht geänder werden * **Name** - zeigt den hinterlegten Namen des AdTag * **Projekt** - zeigt das Projekt, in dem der AdTag verwendet wird * **Priorität** - zeigt die Priorität, mit der der AdTag für \ Werbemittelauslieferung verwendet wird * [**AdTag als Fallback benutzen** - zeigt, ob der AdTag als Fallback-Kampagne genutzt wird](#user-content-fn-1)[^1]
### **Funktionen in der Übersicht**: * Einen AdTag hinterlegen - Button: ***+ Neuen AdTag hinterlegen*** * im **Icon-Menü:** * den AdTag bearbeiten - **Stift** * dem AdTag eine *OnDemand-Kategorie* zuweisen - **Zahnrad** * [den Adtag löschen - **Mülleimer**](#user-content-fn-1)[^1] ## AdTag anlegen oder bearbeiten {% hint style="info" %} Werden einem Projekt mehrere AdTags zugewiesen, sollte die Reihenfolge der Adserver-Abfragen über die "Priorität" der AdTags und die Fallback-Zuweisung für einen AdTag geregelt werden. {% endhint %} Klicken Sie in der Übersicht auf den Button **+Neuen AdTag hinterlegen** oder zum **Bearbeiten** eines AdTags auf das **Stift-Icon.** Die Eingabeformulare unterscheiden sich nur durch den Titel **AdTag hinterlegen** bzw. **AdTag bearbeiten**.
Im Formular nehmen Sie folgende Einträge und Einstellungen vor: 1. **Name: -** individuelle Bezeichnung, die in der Übersicht verwendet wird 2. **Checkbox "Aktiv": -** wenn das Häkchen gesetzt ist, werden die URLs verwendet 3. **... AdTag als Fallback ...: -** dieser AdTag wird automatisch verwendet, wenn andere AdTags keine Werbemittel liefern 4. **Projekt**: - legt das Projekt für die Werbemittelauslieferung fest 5. **Priorität**: - bestimmt die Reihenfolge, wenn mehrere AdTags in einem Projekt verwendet werden 6. **VAST/VPAID … URL:** - hier werden pro Platzierung die AdTags/ URLs hinterlegt 7. **Anzahl X- roll AdSlots**: - Anzahl der möglichen Videoanzeigen pro Platzierung 8. [**MidRoll Intervall**: - Auslieferungsintervall für die MidRoll-Platzierungen](#user-content-fn-1)[^1] Zum Abschluss **speichern** Sie die Einstellungen. {% hint style="info" %} Um einen AdTag zu pausieren, entfernen Sie das Häkchen der Checkbox "Aktiv". {% endhint %} ## Den AdTag einer (OnDemand-) Kategorie zuweisen Wenn Sie für OnDemand-Projekte Kategorien angelegt haben, können Sie einem AdTag eine oder mehrere Kategorien zuweisen. Nur die Videos aus diesen Kategorien werden dann für die Werbemittelauslieferung verwendet. Sie **öffnen** den Bereich "Kategorie Einstellungen" in der **AdTag-Übersicht** über das **Zahnrad** im Icon-Menü. Der obere Seitenbereich zeigt die Standardeinstellungen für den AdTag. In der Tabelle ***Kategorie Einstellungen*** sehen Sie die zugewiesenen Kategorien mit den Slot-Belegungen.
### **Funktionen im Bereich**: * Eine Kategorieeinstellung anlegen - Button: ***+ Neue Katagorie Einstellungen*** * im **Icon-Menü:** * eine Kategorieeinstellung bearbeiten - **Stift** * [eine Kategorieeinstellung löschen - **Mülleimer**](#user-content-fn-1)[^1] ### Eine Kategorie-Einstellung erstellen/bearbeiten Klicken Sie auf den Button **+Neue Kategorie Einstellungen** oder zum Bearbeiten einer Kategorieeinstellung auf das **Stift-Icon.** Die Eingabeformulare unterscheiden sich nur durch den Titel **Neue Kategorie Einstellungen** bzw. **Kategorie Einstellungen** bearbeiten.
Im Formular wählen Sie: * die zu verwendende Kategorie * die Anzahl der AdSlots * optional den MidRoll Intervall Zum Abschluss **speichern** Sie die Einstellungen. ## Werbung im Player aktivieren Öffnen Sie im **Hauptmenü** den Menüpunkt **Player**. Gehen Sie in der **Playerübersicht** zum gewünschten Player und öffnen Sie über das **Stift-Icon** die Player-Einstellungen. Im **Player-Menü** wählen Sie den Reiter **Werbung**.
1. Prüfen Sie, ob Sie dem Player das richtige Projekt zugewiesen haben. 2. Setzen Sie bei **Werbung aktivieren** das Häkchen in der Checkbox. 3. Optional können Sie unter **Ausschließlich folgendes AdTag verwenden** festlegen, dass nur der gewählte AdTag verwendet wird. ## Statische AdTags selbst generieren Sie können mit statischen AdTags selbstgehostete Videodateien aus einem OnDemand-Projekt als Werbemittel verwenden. Dazu erstellen Sie nach folgendem URL-Schema ein eigenes AdTag: Der f**ettmarkierte** Teil der URL wird durch die Data-ID des gewünschten Videos ersetzt. Die angepasste URL hinterlegen Sie anschließend als AdTag in Video Advertising. Sie können dem AdTag auch eine URL hinterlegen, zu der bei Klick auf das Ad weitergeleitet wird: `https://playout.3qsdn.com/vast/ext/ee4fc974-c7cc-11e8-afb7-002590c750be/vast.xml?clickurl=https://example.com/test` | Parameter | | Description | | --------- | ------ | --------------------- | | clickurl | string | ClickURL für Video-Ad | [^1]: Besser als Tabelle formatieren --- # 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://sdn.docs.3q.video/interface/module/video-advertising.md?ask=&goal= ``` `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.