Ein einziger Formatierungsfehler in Ihrer ads.txt-Datei kann die Angebotsunterdrückung durch DSPs auslösen und einen bedeutenden Prozentsatz Ihrer programmatischen Werbeeinnahmen auslöschen - lautlos, ohne Fehlermeldung auf Ihrer Website. ads.txt ist eine Textdatei mit strengen Parsing-Regeln, und die meisten Publisher entdecken Probleme erst durch unerklärliche CPM-Einbrüche in ihrem Werbe-Dashboard. Dieser Guide deckt jede Methode zur Prüfung von ads.txt-Dateien ab, die wichtigsten Fehler und wie Sie die Datei langfristig gesund halten.
Was ist ads.txt?
ads.txt steht für Authorized Digital Sellers. Es ist eine Textdatei im Root Ihrer Domain - `yourdomain.com/ads.txt` - die jede Ad Exchange, jedes Netzwerk und jede Supply-Side-Plattform (SSP) auflistet, die autorisiert ist, Werbeinventar auf Ihrer Website zu verkaufen. Das IAB Tech Lab führte den Standard 2017 speziell zur Bekämpfung von Domain-Spoofing ein: einer Form von Werbebetrug, bei der üble Akteure Inventar verkaufen und vorgeben, es stamme von einer Premium-Publisher-Domain, die ihnen nicht gehört.
Wenn eine Demand-Side-Plattform (DSP) oder ein Werbetreibender ein programmatisches Gebot abgibt, prüft ihr System die ads.txt-Datei des Publishers, bevor es Geld ausgibt. Taucht die im Gebotsrequest genannte Verkaufsentität nicht in der ads.txt-Datei auf, überspringt der Käufer das Gebot entweder ganz oder wendet einen erheblichen Abschlag an. Eine fehlende Datei, ein falsch konfigurierter Eintrag oder ein veralteter Datensatz führen direkt zu niedrigeren Fill Rates und reduzierten effektiven CPMs.
Das ads.txt-Zeilenformat
Jede Zeile in einer gültigen ads.txt-Datei folgt einem präzisen Vier-Felder-Format. Die Struktur zu verstehen ist essenziell, um Fehler zu erkennen - die meisten Validierungsprobleme stammen von Zeilen, die von diesem exakten Muster abweichen.
# Format: domain, publisher-account-id, account-type, authority-id
# account-type must be DIRECT or RESELLER
# authority-id (TAG-ID) is optional but strongly recommended
google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
appnexus.com, 1234, RESELLER, f5ab79cb980f11d1
openx.com, 540191398, RESELLER, 6a698e965929
# Lines starting with # are comments - ignored by parsers
# [email protected]
# SUBDOMAIN=sub.yourdomain.com- domain: Die Root-Domain des Werbesystems (z. B. `google.com`, nicht `ads.google.com`).
- publisher-account-id: Ihre Konto- oder Publisher-ID bei diesem Werbenetzwerk.
- account-type: Entweder `DIRECT` (direkter Vertrag) oder `RESELLER` (Verkauf über Zwischenhändler).
- authority-id: Die optionale, aber empfohlene TAG-ID bzw. Seller Account ID der Trustworthy Accountability Group. Werden sie weggelassen, sinkt das Vertrauen der Käufer.
Note
Warum ads.txt-Fehler Umsatz kosten
Die Durchsetzung von ads.txt im programmatischen Ökosystem ist nicht einheitlich - verschiedene DSPs gehen mit ungültigen Dateien unterschiedlich um, wodurch sich der Umsatzschwerpunkt schwer vorhersagen und leicht übersehen lässt, bis die CPMs spürbar einbrechen. Zu verstehen, wie Käufer auf Fehler reagieren, erklärt, warum sich die regelmäßige Prüfung von ads.txt lohnt.
Wie DSPs auf ads.txt-Probleme reagieren
- Fehlende Datei (404): Die meisten großen DSPs behandeln eine fehlende ads.txt als „unverifiziertes Inventar“. Manche verzichten ganz auf Gebote; andere bieten zu einem stark abgeschlagenen Floor-Preis.
- Ungültiges Zeilenformat: Zeilen mit falscher Feldanzahl oder ungültigen Kontotypwerten werden stillschweigend übersprungen - der Eintrag wird behandelt, als existiere er nicht.
- DIRECT- vs.-RESELLER-Abweichung: Verkauft ein Netzwerk als DIRECT, Ihre Datei listet es aber als RESELLER (oder umgekehrt), markieren Käufer die Abweichung und senken das Vertrauen in das Inventar.
- Fehlende authority-id: Das Programm TAG Certified Channels verlangt authority-ids. Käufer, die die TAG-Zertifizierung durchsetzen, überspringen Einträge ohne.
- Weiterleitung zur Startseite: Eine 301- oder 302-Weiterleitung von /ads.txt zur Startseite behandeln die meisten Crawler als fehlende Datei.
Käufer digitaler Werbung können ads.txt verwenden, um festzustellen, ob eine digitale Media-Einkaufschance vom Publisher autorisiert ist und ob Wiederverkäufer den Publisher-Inventar verkaufen dürfen.
Google AdSense und ads.txt-Warnungen
Google AdSense ist bei der Durchsetzung von ads.txt besonders streng. Ist Ihre AdSense-Publisher-ID nicht korrekt in Ihrer ads.txt-Datei gelistet, zeigt AdSense eine Warnung im Dashboard an und kann die Auslieferung auf Ihren freigegebenen Anzeigenflächen reduzieren. Der erforderliche AdSense-Eintrag folgt exakt diesem Format: `google.com, pub-XXXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0`. Die authority-id `f08c47fec0942fa0` ist die feste Google-TAG-ID - sie muss exakt wie geschrieben erscheinen.
Warning
So prüfen Sie Ihre ads.txt-Datei
Die ads.txt-Prüfung erfordert zwei getrennte Verifikationen: Erreichbarkeit (ist die Datei unter der richtigen URL erreichbar?) und Gültigkeit (ist jede Zeile korrekt formatiert?). Beide Prüfungen sind schnell und mit den richtigen Tools in unter zwei Minuten erledigt.
Verifizieren Sie, dass die Datei im Domain-Root erreichbar ist
Öffnen Sie einen Browser im Inkognito-Modus und navigieren Sie zu `yourdomain.com/ads.txt`. Die Datei sollte als Klartext ohne HTML-Hülle, ohne Login-Aufforderung und ohne Weiterleitung laden. Sehen Sie einen 404 oder leitet die Datei auf Ihre Startseite weiter, ist ads.txt für Werbeplattform-Crawler nicht erreichbar, unabhängig davon, ob die Datei auf Ihrem Server existiert. Prüfen Sie Ihre Webserver-Konfiguration - viele WordPress-Sites leiten versehentlich alle undefinierten Pfade über `.htaccess`-Regeln zur Startseite um.
Fügen Sie die Datei in den Aback-Tools-ads.txt-Validator ein
Kopieren Sie den vollständigen Inhalt Ihrer ads.txt-Datei - aus dem Browser oder direkt von Ihrem Server - und fügen Sie ihn in den ads.txt-Validator ein. Das Tool analysiert jede Zeile gegen die IAB-Spezifikation, markiert falsche Feldanzahlen, ungültige Kontotypwerte und Duplikateinträge und meldet jeden Fehler mit Zeilennummer. Ihre Daten werden vollständig im Browser verarbeitet - nichts wird auf einen Server hochgeladen.
Gleichen Sie mit Ihrer Werbenetzwerk-Partnerliste ab
Vergleichen Sie die validierten Einträge mit den aktuellen ads.txt-Zeilen, die jedes von Ihnen genutzte Werbenetzwerk bereitstellt. Die meisten Netzwerke veröffentlichen ihre erforderlichen ads.txt-Einträge in ihrer Publisher-Dokumentation oder ihrem Dashboard. Netzwerke aktualisieren gelegentlich ihre Pflichteinträge - eine Domain-Änderung oder eine neue authority-id - und Publisher verpassen das Update. Eine Abweichung zwischen dem, was Ihre Datei listet, und dem, was ein Netzwerk aktuell verlangt, verursacht dieselbe Angebotsunterdrückung wie ein fehlender Eintrag.
Beheben Sie Fehler und verifizieren Sie die Erreichbarkeit erneut
Korrigieren Sie jeden gemeldeten Fehler, laden Sie die Datei erneut in das Root-Verzeichnis Ihres Servers hoch und navigieren Sie erneut zu `yourdomain.com/ads.txt`, um zu bestätigen, dass die aktualisierte Datei live ist. Geben Sie den großen Werbeplattformen 24-48 Stunden zum Re-Crawl der Datei, bevor Sie eine Umsatzerholung erwarten. Führen Sie den Validator ein zweites Mal auf der Live-Datei aus, um zu bestätigen, dass keine Upload-Fehler neue Probleme eingeführt haben.
ads.txt-Validator
Validieren Sie ads.txt-Dateien auf Formatfehler, ungültige Kontotypen, Duplikateinträge und fehlende Pflichtfelder - browserlokal, kein Upload nötig.
Häufige Fehler und deren Behebung
Die meisten ads.txt-Probleme fallen in eine kleine Zahl sich wiederholender Muster. Jedes hat eine bestimmte Ursache und eine bestimmte Lösung - wenn Sie wissen, worauf Sie achten müssen, sind sie in Minuten behoben.
Falsche Feldanzahl
Der häufigste Fehler ist eine Zeile mit der falschen Anzahl kommagetrennter Felder. Jede Zeile muss genau drei Pflichtfelder (Domain, Konto-ID, Kontotyp) und ein optionales Feld (authority-id) haben. Zwei-Feld-Zeilen (nur Domain und Konto-ID) und Fünf-Feld-Zeilen (zusätzliche Felder durch Copy-Paste-Fehler) scheitern beide an der Validierung. Prüfen Sie jede Zeile, die Ihr Validator markiert - oft ist das Problem ein überzähliges Komma oder ein fehlendes Komma aus manueller Bearbeitung.
Ungültiger Kontotypwert
Das Kontotypfeld akzeptiert nur zwei Werte: `DIRECT` und `RESELLER`. Groß-/Kleinschreibungs-unempfindliche Parser akzeptieren `direct` und `reseller`, aber die IAB-Spezifikation empfiehlt Großbuchstaben. Jeder andere Wert - `DIRECT/RESELLER`, `Partner`, `Network` oder leer - scheitert an der Validierung, und die Zeile wird von konformen Parsern vollständig übersprungen. Prüfen Sie jede markierte Zeile und korrigieren Sie den Wert exakt auf `DIRECT` oder `RESELLER`, je nach Ihrer vertraglichen Beziehung zu diesem Netzwerk.
Datei aus falschem Pfad oder mit falschem Content-Type ausgeliefert
Die ads.txt-Datei muss exakt unter `yourdomain.com/ads.txt` erreichbar sein - nicht `/ads.txt.php`, nicht `/ads-txt`, nicht in einem Unterverzeichnis. Der Server sollte den Status `200 OK` mit einem `Content-Type` von `text/plain` zurückliefern. Manche Hosting-Plattformen liefern `.txt`-Dateien als `application/octet-stream` aus, was manche Crawler ablehnen. Nutzen Sie den Robots-Validator parallel zu Ihrer ads.txt-Prüfung - hat robots.txt ähnliche Erreichbarkeitsprobleme, haben Sie vermutlich ein Server-Konfigurationsproblem, das alle `.txt`-Dateien im Root betrifft.
| Fehler | Was der Validator meldet | Lösung |
|---|---|---|
| Falsche Feldanzahl | Zeile hat 2 Felder, erwartet 3-4 | Fehlende Domain, Konto-ID oder Typ ergänzen |
| Ungültiger Kontotyp | "partner" ist weder DIRECT noch RESELLER | Auf DIRECT oder RESELLER ändern |
| Duplikateintrag | Duplikat von Zeile 12 | Die doppelte Zeile entfernen |
| Weiterleitung / 404 | Datei unter /ads.txt nicht erreichbar | Server-Routing oder .htaccess korrigieren |
| Versteckte Unicode-Zeichen | Unerwartetes Zeichen an Position 8 | Zeile neu tippen - nicht aus PDFs kopieren |
| Falscher Subdomain-Eintrag | Stattdessen die Direktive SUBDOMAIN= nutzen | Kommentar SUBDOMAIN=sub.domain.com ergänzen |
| TAG authority-id fehlt | Authority-id empfohlen | TAG-ID aus der Netzwerk-Dokumentation ergänzen |
Versteckte Zeichen und Kodierungsprobleme
Ein besonders kniffliges ads.txt-Problem sind Zeilen, die visuell korrekt aussehen, aber beim Parsing scheitern, weil sie versteckte Unicode-Zeichen enthalten - geschützte Leerzeichen, Nullbreiten-Leerzeichen oder typografische Anführungszeichen - eingetragen durchs Kopieren aus einem PDF, einem Word-Dokument oder einer Rich-Text-E-Mail. Die meisten Texteditoren zeigen diese Zeichen nicht. Scheitert eine Zeile an der Validierung ohne offensichtlichen Formatfehler, tippen Sie sie manuell neu statt sie zu kopieren. Das Unicode- und Encoding-Reparatur-Tool kann unsichtbare Unicode-Zeichen aus eingefügtem Text entfernen, bevor Sie ihn in Ihre ads.txt-Datei einfügen.
app-ads.txt und sellers.json
ads.txt wurde für Web-Publisher entworfen. Das programmatische Werbeökosystem hat den Standard auf zwei verwandte Spezifikationen erweitert: app-ads.txt für mobile App-Inventare und sellers.json für Transparenz der Lieferkette. Alle drei Formate zu verstehen hilft Ihnen, ein vollständiges Autorisierungsbild zu bekommen.
app-ads.txt für Mobile-App-Publisher
Mobile-App-Entwickler nutzen app-ads.txt statt ads.txt. Das Dateiformat ist identisch - dieselbe Vier-Felder-Zeilenstruktur, dieselben DIRECT/RESELLER-Kontotypen, dasselbe authority-id-Feld. Der Unterschied liegt in der Auffindung: Bei Apps schlagen Werbeplattformen die Website-URL des Entwicklers aus dem App-Store- bzw. Google-Play-Eintrag nach und prüfen auf app-ads.txt im Root dieser Domain. Sie hosten app-ads.txt auf Ihrer Entwickler-Website, nicht in der App selbst. Nutzen Sie den app-ads.txt-Validator, um die Autorisierung mobiler App-Inventare mit denselben Validierungsregeln zu prüfen.
sellers.json - das Komplement der Lieferkette
sellers.json ist das Komplement zu ads.txt aus der Gegenrichtung: Werbenetzwerke und SSPs veröffentlichen eine sellers.json-Datei auf ihrer eigenen Domain, die alle Publisher (Verkäufer) auflistet, die sie vertreten. Ein Käufer kann Ihren ads.txt-RESELLER-Eintrag gegen die sellers.json des SSP abgleichen, um zu verifizieren, dass die Lieferkette legitim ist. Als Publisher erstellen Sie sellers.json nicht, aber es zu verstehen erklärt, warum korrekte authority-ids in Ihrer ads.txt wichtig sind - sie dienen dazu, Ihre Einträge mit sellers.json-Datensätzen abzugleichen.
Note
ads.txt-Gesundheit überwachen
Eine einmalige ads.txt-Prüfung genügt nicht - Werbenetzwerk-Einträge ändern sich, neue Partner werden integriert, und die Dateierreichbarkeit kann nach Server- oder CMS-Updates brechen. Eine schlanke Monitoring-Routine verhindert stille Umsatzverluste zwischen manuellen Audits.
Google-AdSense-Dashboard-Warnungen
Das AdSense-Dashboard zeigt ein ads.txt-Warnbanner, wenn Ihre Publisher-ID in Ihrer ads.txt-Datei fehlt oder die Datei nicht erreichbar ist. Prüfen Sie das AdSense-Dashboard nach jeder Servermigration, jedem CMS-Update oder jeder `.htaccess`-Änderung - das sind die drei häufigsten Ereignisse, die die ads.txt-Erreichbarkeit brechen, ohne dass der Publisher es bemerkt. Die Warnung erscheint im Abschnitt „Konto“ der AdSense-Einstellungen.
Programmatische Partnerbenachrichtigungen
Die meisten großen SSPs und Werbenetzwerke senden E-Mail-Benachrichtigungen, wenn sich ihre erforderlichen ads.txt-Einträge ändern. Abonnieren Sie Update-Benachrichtigungen im Publisher-Portal jedes Partners, wo verfügbar. Aktualisiert ein Partner seine Domain oder authority-id, räumen sie meist eine Migrationsfrist von 30-90 Tagen ein, bevor alte Einträge nicht mehr honoriert werden - aber nur Publisher, die aktiv überwachen, erfassen die Änderung rechtzeitig.
Technischer Audit-Workflow
Nehmen Sie die ads.txt-Validierung in Ihr quartalsweises technisches SEO-Audit auf, neben robots.txt, Sitemap-Validierung und Canonical-Tag-Prüfungen. Nutzen Sie den Robots.txt-Regelkonflikt-Erklärer, um zu verifizieren, dass keine robots.txt-Regel versehentlich Werbeplattform-Crawler blockiert, und den Sitemap-Validator, um die Sitemap-Gesundheit in derselben Sitzung zu prüfen. Diese Dateien liegen auf derselben Server-Root-Ebene und sind oft von denselben Fehlkonfigurationsereignissen betroffen.
Tip
ads.txt-Best-Practices
Wer diese Praktiken befolgt, hält seine ads.txt-Datei genau, erreichbar und wirksam - maximiert die Gebotsberechtigung und schützt Ihr Inventar vor unbefugten Wiederverkäufern.
Halten Sie die Datei schlank und aktuell
Entfernen Sie Einträge von Werbenetzwerken, mit denen Sie nicht mehr arbeiten. Eine überdimensionierte ads.txt mit Dutzenden inaktiver Einträgen schadet dem Umsatz nicht direkt, vergrößert aber die Fehlerfläche und erschwert die Dateiauditierung. Melden Sie sich bei einem Netzwerk ab, entfernen Sie deren Einträge, sobald Sie deren Anzeigentags von Ihren Seiten nehmen - behandeln Sie beides als Teil desselben Offboarding-Prozesses.
Verwenden Sie immer authority-ids, wo verfügbar
Die TAG authority-id (auch TAG-ID oder Seller Account ID genannt) ist in der ads.txt-Spezifikation technisch optional, aber große DSPs bevorzugen Einträge mit ihr. Sie erlaubt Käufern, die gesamte Lieferkette vom Publisher bis zur Exchange über den sellers.json-Abgleich zu verifizieren. Jedes große Werbenetzwerk veröffentlicht seine authority-id in der Publisher-Dokumentation - nehmen Sie sie in jeden Eintrag auf, wo verfügbar.
- Ein Eintrag pro Zeile: Kombinieren Sie nie mehrere Netzwerke in einer Zeile - jede autorisierte Verkäuferbeziehung bekommt ihre eigene Zeile.
- Vor jedem Upload validieren: Führen Sie den ads.txt-Validator vor dem Hochladen auf die Datei aus, um Fehler zu finden, die Sie beim Bearbeiten eingeführt haben.
- UTF-8-Kodierung ohne BOM: Speichern Sie die Datei als reines UTF-8. Ein BOM (Byte Order Mark) am Dateianfang kann das Parsing bei manchen Werbeplattform-Crawlern brechen.
- Kein Leerraum am Zeilenende: Viele Texteditoren fügen unsichtbare nachgestellte Leerzeichen hinzu. Diese können in strengen Validatoren Zeilen-Fehler beim Parsing verursachen.
- Versionskontrolle für Ihre ads.txt: Halten Sie ads.txt im Versionskontroll-Repository Ihrer Site. Eine Git-Historie lässt Sie exakt nachverfolgen, wann ein Eintrag hinzugefügt oder entfernt wurde, falls der Umsatz unerwartet einbricht.
app-ads.txt-Validator
Validieren Sie app-ads.txt-Dateien für mobile Werbeinventare - dieselben Formatregeln wie ads.txt, optimiert für den Kontext mobiler App-Publisher.
Key takeaways
- ads.txt listet jeden autorisierten Verkäufer Ihres Werbeinventars - fehlende oder ungültige Einträge lassen DSPs Gebote überspringen oder Ihre CPMs abschlagen.
- Prüfen Sie zuerst die Erreichbarkeit: Navigieren Sie zu `yourdomain.com/ads.txt` und bestätigen Sie, dass die Datei als Klartext mit Status 200 lädt, ohne Weiterleitung und ohne HTML-Hülle.
- Nutzen Sie den ads.txt-Validator, um jede Zeile auf Formatfehler, ungültige Kontotypen und Duplikate zu prüfen - die gesamte Verarbeitung geschieht in Ihrem Browser.
- Die fünf häufigsten Fehler sind falsche Feldanzahl, ungültige Kontotypwerte, Auslieferung am falschen Pfad, versteckte Unicode-Zeichen und fehlende authority-ids.
- Google AdSense verlangt exakt den Eintrag `google.com, pub-XXXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0` - die authority-id `f08c47fec0942fa0` ist fix und muss exakt übereinstimmen.
- Für mobile Apps nutzen Sie app-ads.txt im selben Format, gehostet im Root Ihrer Entwickler-Website, auffindbar über Ihren App-Store-Eintrag.
- Revalidieren Sie ads.txt nach jeder Servermigration, jedem CMS-Update oder Hosting-Wechsel - das sind die häufigsten Ereignisse, die die Dateierreichbarkeit lautlos brechen.