> 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 <a href="#page_modul_einrichten" id="page_modul_einrichten"></a>

Zum **Öffnen** gehen Sie im **Hauptmenü** auf den Menüpunkt **Module**. Klicken Sie im Drop-down-Menü auf **Video Advertising.**&#x20;

#### 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                                                          \
  &#x20;                                                          Werbemittelauslieferung verwendet wird
* [**AdTag als Fallback benutzen**   - zeigt, ob der AdTag als Fallback-Kampagne  genutzt wird](#user-content-fn-1)[^1]

<figure><img src="/files/NCuPHr0cOMdilrRLVi8n" alt=""><figcaption></figcaption></figure>

### **Funktionen in der Übersicht**:&#x20;

* 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**.

<figure><img src="/files/cIDOnQ1iHduvZz87j3eO" alt=""><figcaption></figcaption></figure>

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 &#x20;

   &#x20;                                            keine Werbemittel liefern
4. **Projekt**:                             - legt das Projekt für die Werbemittelauslieferung fest
5. **Priorität**:                           - bestimmt die Reihenfolge, wenn mehrere AdTags in einem

   &#x20;                                            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 <a href="#page_kategorie_einstellungen" id="page_kategorie_einstellungen"></a>

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.&#x20;

In der Tabelle ***Kategorie Einstellungen*** sehen Sie die zugewiesenen Kategorien mit den Slot-Belegungen.&#x20;

<figure><img src="/files/9tMHDsHmevvBYARbwuwJ" alt=""><figcaption></figcaption></figure>

### **Funktionen im Bereich**:&#x20;

* 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.

<figure><img src="/files/qMI9VPM5ubar9LOwRhdY" alt=""><figcaption></figcaption></figure>

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 <a href="#page_adtags_verwenden" id="page_adtags_verwenden"></a>

Öffnen Sie im **Hauptmenü** den Menüpunkt **Player**.&#x20;

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**.

<figure><img src="/files/hpO1ppfihPt8KfY0KFDt" alt=""><figcaption></figcaption></figure>

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 <a href="#page_statische_adtags_selbst_generieren" id="page_statische_adtags_selbst_generieren"></a>

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:

<https://playout.3qsdn.com/vast/ext/**ee4fc974-c7cc-11e8-afb7-002590c750be**/vast.xml>

Der f**ettmarkierte** Teil der URL wird durch die Data-ID des gewünschten Videos ersetzt.&#x20;

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