ads.txt-Validator

Fügen Sie den Inhalt Ihrer ads.txt ein, um die Syntax sofort zu prüfen. Validiert die Felder DOMAIN, PUBLISHER_ID und RELATIONSHIP (DIRECT/RESELLER) zeilenweise und hilft Ihnen, die Datei korrekt einzurichten, die vor unautorisiertem Weiterverkauf von Werbeinventar (Domain-Spoofing) schützt.

Was ist die ads.txt

Die ads.txt (Authorized Digital Sellers) ist eine Textdatei, mit der Website-Betreiber erklären, welche Werbesysteme berechtigt sind, die Werbeflächen ihrer Seite zu verkaufen. Es handelt sich um einen vom IAB Tech Lab festgelegten Branchenstandard, der im Root-Verzeichnis der Domain hinterlegt wird (zum Beispiel unter https://example.com/ads.txt). Jede Zeile folgt einer Spezifikation mit 3 oder 4 durch Kommas getrennten Feldern: DOMAIN (die Domain des Werbesystems), PUBLISHER_ID (die Konto-Kennung) und RELATIONSHIP (DIRECT oder RESELLER). Schon ein einziges falsches Zeichen genügt, damit der Abgleich durch das Werbesystem fehlschlägt und eine an sich legitime Werbefläche als „nicht autorisiert" eingestuft wird.

Dieser Validator analysiert den von Ihnen eingefügten Inhalt der ads.txt zeilenweise und erkennt dabei Probleme wie eine falsche Feldanzahl, leere Felder, ein ungültiges DOMAIN-Format sowie fehlerhafte RELATIONSHIP-Werte (alles außer DIRECT oder RESELLER). Auch Kommentarzeilen (beginnend mit #) sowie Variablen-Direktiven wie CONTACT=, SUBDOMAIN= und OWNERDOMAIN= werden korrekt erkannt und getrennt von den eigentlichen Eintragszeilen dargestellt. Zusätzlich können Sie eine URL angeben, um die bereits veröffentlichte ads.txt einer bestehenden Website direkt abzurufen und zu prüfen.

So verwenden Sie den ads.txt-Validator

  1. Inhalt der ads.txt bereitstellen Halten Sie die aktuelle Datei Ihrer Website oder den Inhalt, den Sie demnächst veröffentlichen möchten, als Text bereit.
  2. In das Eingabefeld einfügen oder per URL abrufen Fügen Sie den Text direkt in das Textfeld ein oder geben Sie im Feld „Von URL abrufen" eine Domain ein, um die bestehende ads.txt zu laden.
  3. Validierungsergebnis prüfen Sehen Sie sich in der Übersicht an, ob jede Zeile als gültig, fehlerhaft, Variable oder Kommentar eingestuft wurde.
  4. Fehlerhafte Zeilen korrigieren Überarbeiten Sie die betreffende Zeile anhand des in der Hinweisspalte angezeigten konkreten Grundes, etwa einer zu geringen Feldanzahl oder eines ungültigen DOMAIN-Formats.
  5. Nach der Korrektur im Domain-Root veröffentlichen Sobald alle Zeilen als gültig angezeigt werden, veröffentlichen Sie die Datei auf Ihrem Server unter https://ihredomain.de/ads.txt.

Tipps für die Nutzung

  • Das Grundformat besteht aus 3 Feldern – DOMAIN, PUBLISHER_ID und RELATIONSHIP – mit einem optionalen vierten Feld für die ID der Zertifizierungsstelle. Zählen Sie die Kommas, um zu prüfen, dass keines fehlt oder zu viel ist.
  • RELATIONSHIP akzeptiert nur DIRECT (der Seitenbetreiber hat einen direkten Vertrag) oder RESELLER (Verkauf über einen Wiederverkäufer). Die Schreibweise ist laut Spezifikation nicht case-sensitiv, üblich ist jedoch Großschreibung.
  • Zeilen, die mit # beginnen, werden als Kommentare ignoriert. Variablen-Direktiven wie CONTACT= oder OWNERDOMAIN= helfen Werbesystemen beim Abgleich Ihres Kontos.
  • Die ads.txt muss im Domain-Root gehostet werden (https://example.com/ads.txt). In einem Unterverzeichnis wird sie von Werbesystemen und Crawlern nicht erkannt.
  • Für mobile Apps gibt es eine ergänzende Spezifikation namens app-ads.txt. Wer Werbeinventar sowohl über eine Website als auch über eine App verkauft, muss beide Dateien hosten.

In diesen Situationen hilfreich

Prüfung vor der Google-AdSense-Überprüfung

Kontrollieren Sie im Vorfeld der AdSense-Kontoprüfung oder zur Behebung von Warnhinweisen zur Anzeigenauslieferung, ob Ihre bereits veröffentlichte ads.txt Syntaxfehler enthält.

Beim Hinzufügen eines neuen Werbesystems (SSP)

Wenn Sie eine von einem neuen SSP oder Werbenetzwerk bereitgestellte Zeile ergänzen, können Sie sofort prüfen, ob die Anzahl der Kommas und die Schreibweise stimmen.

Kontrolle nach CMS-Umzug oder Website-Relaunch

Prüfen Sie über die URL-Abruffunktion direkt die Produktivumgebung, ob die ads.txt nach einem WordPress-Umzug oder Serverwechsel Zeichenkodierungs- oder Zeilenumbruchfehler aufweist.

Kontrolle bei mehreren Domains oder Standorten

Werbeagenturen und Betreiber mehrerer Websites können diesen Validierungsschritt nutzen, um die ads.txt-Dateien aller verwalteten Domains gebündelt zu überprüfen.

Prüfung extern bereitgestellter Textbausteine

Prüfen Sie einen von einem Werbenetzwerk zugesandten ads.txt-Textbaustein isoliert auf Syntaxfehler, bevor Sie ihn in Ihre eigene Datei übernehmen.

Glossar

ads.txt
Eine vom IAB Tech Lab festgelegte Textdatei-Spezifikation zur Erklärung der autorisierten Verkäufer einer Werbefläche. Sie wird im Root-Verzeichnis der Domain gehostet.
DIRECT
Ein RELATIONSHIP-Wert, der angibt, dass der Website-Betreiber einen direkten Vertrag mit dem Werbesystem hat und selbst die Berechtigung zum Verkauf der Werbefläche besitzt.
RESELLER
Ein RELATIONSHIP-Wert, der verwendet wird, wenn ein Wiederverkäufer (etwa ein Werbenetzwerk) mit vom Betreiber delegierter Berechtigung die Werbefläche verkauft.
ID der Zertifizierungsstelle (Certification Authority ID)
Das optionale vierte Feld, das eine von Stellen wie der TAG (Trustworthy Accountability Group) vergebene Kennung des Werbesystems angibt.
Domain-Spoofing
Eine betrügerische Praxis, bei der Dritte eine legitime Werbefläche unerlaubt kopieren und weiterverkaufen, sodass Werbetreibende ihre Anzeigen auf einer anderen Seite ausliefern lassen. Die ads.txt wurde geschaffen, um dies zu verhindern.
Authorized Digital Sellers
Der vollständige Name der ads.txt. Er bedeutet „autorisierte digitale Verkäufer" und bringt das Grundprinzip der gesamten Spezifikation auf den Punkt.
PUBLISHER_ID
Eine von jedem Werbesystem pro Konto vergebene Kennung. Bei Google AdSense beginnt sie mit dem Präfix „pub-".
SSP (Supply-Side Platform)
Eine Vermittlungsplattform, die die Werbeflächen von Publishern an die Gebotssysteme der Werbetreibenden weiterreicht. Im DOMAIN-Feld der ads.txt wird die Domain des SSP eingetragen.

Häufig gestellte Fragen

Die Anzeigenauslieferung stoppt nicht sofort vollständig, aber Google markiert Seiten ohne korrekt konfigurierte ads.txt, und wenn dies unbeachtet bleibt, kann ein Teil Ihres Werbeinventars nicht mehr verkauft werden. Prüfen Sie im AdSense-Dashboard den ads.txt-Codeausschnitt für Ihre Website und hosten Sie ihn im Domain-Root.

DIRECT bedeutet, dass der Seitenbetreiber einen direkten Vertrag mit dem Werbesystem hat und die Berechtigung zum Verkauf dieses Inventars besitzt. RESELLER wird verwendet, wenn ein Wiederverkäufer (z. B. ein Werbenetzwerk) das Inventar im Auftrag des Betreibers mit delegierter Berechtigung verkauft. Wird ein Werbeplatz über mehrere Werbesysteme verkauft, muss jede Beziehung korrekt einzeln aufgeführt werden.

Das ist die kontospezifische ID, die von jedem Werbesystem (Google AdSense, Google Ad Manager, andere SSPs usw.) vergeben wird. Bei AdSense beginnt sie mit „pub-" und ist auf der Kontoeinstellungsseite oder über die ads.txt-Codeausschnitt-Funktion im Dashboard zu finden.

Das hängt vom Werbesystem und Crawler ab, üblicherweise wird sie jedoch innerhalb von 24 Stunden erneut abgerufen. Da Änderungen etwas Zeit brauchen können, um sich durchzusetzen, müssen Sie sich keine Sorgen machen, wenn sich die Anzeigenauslieferung nach einer Aktualisierung nicht sofort ändert.

Grundsätzlich ist ads.txt pro Domain unabhängig, und eine Subdomain erbt die Einstellungen der Root-Domain nicht. Die IAB-Spezifikation enthält jedoch eine SUBDOMAIN=-Direktive, mit der bestimmte Subdomains auf eine separate Datei verweisen können.
Tool-kun

Übrigens – Warum es ads.txt gibt: ein Branchenstandard gegen die „Fälschung" von Werbeinventar

ads.txt (Authorized Digital Sellers) ist eine 2017 vom IAB Tech Lab entwickelte Spezifikation. Damals war die programmatische Werbung von sogenanntem „Domain-Spoofing" geplagt: Betrüger kopierten und verkauften ohne Erlaubnis das Werbeinventar seriöser Publisher weiter. Werbetreibende glaubten, auf einer Premium-Seite zu bieten, doch ihre Anzeigen landeten auf völlig unabhängigen, minderwertigen Seiten – was das Vertrauen von Werbetreibenden und Publishern gleichermaßen untergrub.

Der Mechanismus ist simpel: Ein Publisher veröffentlicht im Root-Verzeichnis seiner Domain als Klartextdatei, welche Werbesysteme er zum Verkauf seines Inventars autorisiert hat. Werbeeinkaufssysteme rufen diese Datei ab, um zu prüfen, ob das Inventar, auf das sie bieten, tatsächlich über einen von dieser Domain offiziell freigegebenen Kanal verkauft wird. Da das Design so einfach ist, sind die Einführungskosten gering – innerhalb weniger Jahre übernahm die Mehrheit der großen Werbesysteme und Publisher diesen Branchenstandard.

Auch Google AdSense fördert seit 2019 die Einführung von ads.txt, und Seiten ohne korrekte Konfiguration kann ein Teil der Anzeigenauslieferung eingeschränkt werden. Für eine Website, deren Geschäftsmodell auf Werbeeinnahmen basiert, ist ads.txt keine bloße Empfehlung, sondern faktisch eine notwendige Einstellung zum Schutz dieser Einnahmen.

Als ergänzende Spezifikationen hat das IAB Tech Lab außerdem app-ads.txt für mobile Apps sowie sellers.json, das Verkäuferinformationen auf Seiten der Werbesysteme veröffentlicht, entwickelt. Zusammen ermöglichen sie Werbetreibenden, entlang der gesamten Lieferkette zu überprüfen, wer welches Inventar unter welcher Beziehung verkauft.