Wie VAST-Spezifikationen die Validierungsregeln von vastlint präzisieren

Die VAST-Spezifikation des IAB Tech Lab definiert technische Standards für Video-Werbeformate. Doch ihre Umsetzung in der Praxis erfordert mehr als nur automatisierte Schema-Prüfungen. Der Open-Source-Linter vastlint nutzt daher sowohl die offiziellen PDF-Dokumente als auch die XSD-Schemata – und ergänzt sie um erprobte Branchenpraktiken. Das Ergebnis ist ein mehrstufiges Regelwerk, das nicht nur strukturelle Fehler erkennt, sondern auch logische Inkonsistenzen in VAST-Dokumenten aufdeckt.

Warum VAST-Spezifikationen mehr als nur XSD benötigen

Das IAB Tech Lab veröffentlicht VAST als zwei zentrale Artefakte: ein normatives PDF-Dokument und eine maschinenlesbare XSD-Datei. Während die XSD die grundlegende Dokumentstruktur beschreibt, enthält das PDF die eigentlichen Validierungsregeln. Die XSD deckt beispielsweise keine Geschäftslogik, Reihenfolgebeschränkungen oder URL-spezifische Vorgaben ab. Ein linter wie vastlint muss daher beide Quellen als komplementäre Wahrheiten behandeln – nicht als austauschbare Alternativen.

Ein konkretes Beispiel: Die Pflichtangabe von AdTitle in Inline-Anzeigen stammt direkt aus der VAST 2.0-Spezifikation. Obwohl spätere Versionen diesen Punkt nicht explizit wiederholen, bleibt die Regel bestehen. Solche versionsabhängigen Vorgaben werden in vastlint als versionsspezifische Prüflogik umgesetzt. So führt ein VAST 3.0-Dokument nicht zu Fehlern für Regeln, die erst ab Version 4.1 relevant sind – etwa die Deprecation von conditionalAd oder Survey.

Vom PDF zur Regel: Manuelle Extraktion als Grundpfeiler

Die Extraktion der Validierungsregeln aus den PDF-Spezifikationen erfolgte zunächst manuell und iterativ. Jede Hauptversion der VAST-Spezifikation (2.0, 3.0, 4.0, 4.1, 4.2, 4.3) wurde komplett durchgelesen, um normative Aussagen zu identifizieren. Diese wurden anschließend nach Elementen, Attributen und Constraint-Typen klassifiziert.

Die Analyse umfasste unter anderem:

• Verbindliche Pflichtfelder: Wie InLine muss AdTitle enthalten.
• Versionsabhängige Änderungen: Die Entfernung von fullscreen/exitFullscreen-Tracking-Events in VAST 4.0.
• Deprecations: conditionalAd wurde in Version 4.1 als veraltet markiert.

Jede dieser Regeln wurde mit einem Versionskontext versehen. Dadurch können Nutzer:innen vastlint so konfigurieren, dass nur die für ihre VAST-Version relevanten Prüfungen durchgeführt werden. Diese versionsspezifische Validierung verhindert falsch-positive Ergebnisse und stellt sicher, dass ältere Anzeigenformate weiterhin korrekt verarbeitet werden.

XSD als struktureller Unterbau: Systematische Fehlererkennung

Während das PDF die inhaltlichen Vorgaben liefert, definiert die XSD die strukturellen Rahmenbedingungen von VAST-Dokumenten. Die Schemata legen fest, welche:

• Attribute erlaubt sind,
• Kind-Elemente ein übergeordnetes Element enthalten darf,
• Inhaltsmodelle für jedes Element gelten.

Diese strukturellen Regeln bilden die Grundlage für viele Prüfungen in vastlint. Beispiele dafür sind:

• Unbekannte Attribute: Wird ein nicht definiertes Attribut wie unknownAttr verwendet, führt dies zu einem Fehler.
• Unerlaubte Enum-Werte: Attribute wie delivery (muss progressive oder streaming sein) oder adType werden gegen die XSD-Definition validiert.
• Fehlende Pflichtkindelemente: Ein MediaFile-Element muss beispielsweise immer ein type-Attribut enthalten.

Die XSD-Prüfungen sind besonders nützlich, um syntaktische Fehler frühzeitig zu erkennen – noch bevor die inhaltlichen Vorgaben des PDFs greifen. Allerdings decken sie keine semantischen Inkonsistenzen ab, wie etwa die korrekte Reihenfolge von Tracking-Events.

Praxiswissen als dritte Säule: Branchenstandards ergänzen die Spezifikation

Nicht alle Validierungsregeln stammen aus offiziellen Dokumenten. Einige wurden erst durch wiederkehrende Probleme im Echtbetrieb identifiziert. vastlint integriert daher eine dritte Kategorie von Regeln, die aus Industriebest Practices abgeleitet werden. Dazu gehören:

• HTTPS-Zwangsprüfung: MediaFile und Tracking-URLs müssen über HTTPS ausgeliefert werden, um Sicherheitslücken zu vermeiden.
• Duplikatsvermeidung: Mehrfache Impression-URLs können zu Abrechnungsstreitigkeiten führen und werden daher als Fehler markiert.
• Fehlende Quartil-Tracking-Events: Diese sind essenziell für die Erfolgsmessung von Videoanzeigen.
• VPAID-in-CTV-Fußangel: Die Integration von VPAID in Connected-TV-Umgebungen führt häufig zu Kompatibilitätsproblemen und wird daher als potenzielles Risiko gewertet.

Diese Regeln werden mit dem Hinweis „IndustryBestPractice“ oder „Inferred“ versehen und bieten zusätzliche Sicherheit – selbst wenn sie nicht direkt in der VAST-Spezifikation verankert sind.

Der vollständige Regelkatalog: Transparenz durch dokumentierte Prüfungen

Jede Validierungsregel in vastlint ist dokumentiert und nachvollziehbar. Für jede Prüfung gibt es eine dedizierte Seite auf vastlint.org, die folgende Informationen enthält:

• Regel-ID: Eindeutiger Bezeichner wie VAST-4.0-universaladid-idregistry.
• Beschreibung: Was genau geprüft wird.
• Quelle: Ob die Regel aus dem VAST-PDF, der XSD oder einer Branchenempfehlung stammt.
• Schweregrad: Von Error bis Warning.
• Reparaturhinweise: Konkrete Anleitung zur Fehlerbehebung.
• Beispiele: Korrekte und fehlerhafte VAST-Fragment-Beispiele.

Diese Transparenz ermöglicht es Entwickler:innen und Werbetreibenden, die Prüfungen nachzuvollziehen und bei Bedarf anzupassen. Zudem können Unternehmen eigene Regeln hinzufügen, um unternehmensspezifische Vorgaben durchzusetzen.

Fazit: VAST-Linting als unverzichtbarer Qualitätscheck für digitale Werbung

VAST-Spezifikationen sind komplex und entwickeln sich kontinuierlich weiter. Die Kombination aus PDF-basierten Vorgaben, XSD-Strukturen und praktischen Branchenkenntnissen macht vastlint zu einem mächtigen Werkzeug für die Qualitätssicherung von Video-Werbeformaten. Durch die versionsspezifische Prüfung vermeiden Unternehmen teure Fehler, während die Integration von Best Practices zusätzliche Sicherheit bietet.

In einer Zeit, in der digitale Werbung immer stärker automatisiert und programmatisch gesteuert wird, wird die korrekte Validierung von VAST-Dokumenten zum entscheidenden Faktor für Zuverlässigkeit und Compliance. Mit Tools wie vastlint können Teams sicherstellen, dass ihre Anzeigenformate nicht nur technisch korrekt, sondern auch marktkonform sind – und damit die Grundlage für erfolgreiche Kampagnen legen.