Amazon Ads Reporting: Reporting API, Marketing Stream und die Abschaltung 2027
Kurz gesagt: Amazon Ads Reporting zeigt, welche Anzeigen Klicks und zugeschriebene Käufe bringen. Sie können Berichte regelmäßig herunterladen oder Zahlen laufend an Ihr System senden. Dafür gibt es Reporting API v1 und Marketing Stream v2. Die älteren Versionen Reporting API v3 und Marketing Stream v1 werden am 30. Juni 2027 abgeschaltet.
Welche Reporting-Oberflächen es gibt
Die Auswahl fängt nicht bei der Frage "welche Kennzahlen brauche ich", sondern bei der Frage "wie oft und in welcher Menge" an. Amazon bündelt die Reporting-Funktionen der Ads API in zwei aktive Oberflächen: die Reporting API v1 und Amazon Marketing Stream in Version 2. Beide liefern Werbedaten, aber mit unterschiedlichen Zustellmustern.
Die Reporting API v1 ist eine Pull-Schnittstelle: Sie fordern einen Report an, Amazon erzeugt ihn asynchron, und Sie laden das Ergebnis ab. Amazon bewirbt sie für periodische Auswertungen mit vorbereiteten Metriken und Dimensionen, für Berichte, die Stakeholder direkt verstehen sollen, sowie für die Kombination beliebiger Dimensionen in einer Anfrage.
Amazon Marketing Stream Version 2 ist die Push-Schnittstelle: Amazon legt vollständige Datensätze als Parquet-Dateien in Ihren S3-Bucket. Die Performance-Daten aktualisieren sich alle 15 Minuten. Es gibt kein Polling und keine Drosselung; dafür liegt der Aufwand in Ihrer eigenen Pipeline.
| Oberfläche | Zustellung | Wofür Amazon sie empfiehlt |
|---|---|---|
| Reporting API v1 | Pull: Report anfordern, Ergebnis herunterladen | Periodische oder geplante Auswertungen mit vorbereiteten Metriken und Dimensionen; ein Request je Client-ID gleichzeitig |
| Amazon Marketing Stream v2 | Push: Parquet-Dateien in Ihren S3-Bucket | Automatisiertes, wiederkehrendes Reporting, Dashboards, Optimierungslogik, Modelle und mehr als 100 Reports pro Tag |
| Reporting API v3 (alt) | Pull, nur noch eingeschränkt | Wird am 30. Juni 2027 abgeschaltet; für neue Integrationen nicht mehr wählen |
| Amazon Marketing Stream v1 (alt) | Push als Delta über Firehose oder SQS | Wird am 30. Juni 2027 abgeschaltet; Migration auf Version 2 |
Die Abschalttermine sind kein Gerücht, sondern stehen in Amazons eigener Reporting-Übersicht: v3 reporting, Amazon Marketing Stream Version 1, Version 2 reporting für Sponsored Ads und das Amazon DSP Reporting werden alle zum 30. Juni 2027 abgeschaltet. Wer heute noch auf v3 setzt, baut eine Migration ein, die er nicht wollte.
Ein Hinweis zur Abgrenzung: Amazon Marketing Stream liefert Werbedaten, keine Retail-Daten. Für Absatz, Bestand oder Erlöse aus dem Verkauf ist der Vendor-Pfad zuständig, nicht die Ads API.
Wie frisch sind die Zahlen wirklich?
Bei Sponsored Ads sind die ersten Impression- und Klickdaten über die API innerhalb von 12 Stunden verfügbar. Das ist der theoretische Start, nicht der belastbare Wert: Amazon validiert jeden Klick, um Advertiser nicht unnötig zu belasten, und die Erkennung ungültigen Traffics läuft nachträglich bis zu 30 Tage. Amazon empfiehlt, mindestens 5 Tage zu warten, bevor Sie die Kampagnenleistung bewerten.
Conversions verhalten sich anders. Sie werden in täglichen, wöchentlichen und monatlichen Intervallen aktualisiert und geprüft und können bis zu 60 Tage zurückrevidiert werden. Amazons Empfehlung lautet deshalb, Reports monatlich erneut abzurufen, damit die Conversions nicht veralten.
Für die Planung heißt das: Die 5 Tage Wartezeit gelten für die Klickzahlen, nicht für die Conversions. Conversions bekommen ihren eigenen Rhythmus, und Amazon Marketing Stream v2 nimmt Ihnen die Nachlieferung ab, weil der Stream bei Erstellung des Abos bis zu 70 Tage automatisch nachliefert und sich damit selbst korrigiert, während die Validierung nachläuft.
| Daten | Erste Verfügbarkeit | Was Amazon zusagt |
|---|---|---|
| Impressionen und Klicks (Sponsored Ads) | innerhalb von 12 Stunden | Warte mindestens 5 Tage für eine belastbare Bewertung; ungültiger Traffic wird bis zu 30 Tage nachträglich erkannt |
| Conversions (Sponsored Ads) | täglich, wöchentlich, monatlich | Können bis zu 60 Tage zurück geändert werden; Reports monatlich erneut abrufen |
| Impressionen und Klicks (Amazon DSP) | laut Oberflächen-Übersicht nach Validierung | Ungültiger Traffic wird bis zu 72 Stunden nachträglich erkannt |
Limitierungen, die in der Planung stehen müssen
Die Reporting API v1 erlaubt nur einen gleichzeitigen Report pro Client-ID: Für eine Client-ID läuft zur Zeit genau ein Report. Je nach durchschnittlicher Laufzeit ergibt das ungefähr 100 Reports pro Tag. Ein weiterer Request wird entweder in eine Warteschlange gestellt oder mit einem 429 beantwortet. Amazon empfiehlt, die Reports über den Tag zu verteilen und je Client-ID zu serialisieren.
Amazon Marketing Stream nimmt diese Drosselung vollständig heraus, weil die Daten ohne API-Aufruf in Ihre AWS-Umgebung geschoben werden. Das ist der Grund, warum Amazon Stream als die einzige Oberfläche bezeichnet, die automatisiertes Reporting im großen Maßstab trägt. Der Preis ist die eigene Verantwortung für Schema, Speicher und Verarbeitung.
Für die Architektur heißt das: Ad-hoc-Auswertungen und periodische Berichte gehören an die Reporting API v1, alles, was kontinuierlich fließen muss (Dashboards, Alarmierung, Optimierungslogik, Modellierung), an Marketing Stream v2. Beides parallel zu betreiben ist üblich, weil Amazon für Stream v2 den vollen Metrik- und Dimensionsumfang der Reporting API v1 zusagt: Stream v2 liefert dieselben Kennzahlen und Dimensionen, dazu die Summenwerte statt einzelner Änderungen.
Reports und Exports sind nicht dasselbe
Amazon trennt die Auswertung sauber: Ein Report enthält Performance-Daten wie Impressionen, Klicks oder Conversions für einen gewählten Report-Typ. Exports enthalten Kampagnen-Metadaten wie Budget oder Status. Konkret: Ein Target-Export für Sponsored Products liefert alle Targeting-Klauseln der Sponsored-Products-Kampagnen, während ein Target-Report Performance-Daten auf Target-Ebene enthält.
Ein Report kann bestimmte Metadaten enthalten, Amazon empfiehlt aber, Metadaten über die Export-Ressource anzufordern, weil das die Performance verbessert. Für den Alltag heißt das: Budget-, Status- und Strukturdaten holen Sie über Exports, Kennzahlen über Reports. Wer beides vermischt, zahlt mit doppelten Abfragen und inkonsistenten Ständen.
Einordnung: wann Amazon Ads Reporting genügt und wann nicht
Unser Fazit, nicht Amazons Aussage: Amazon Ads Reporting ist die richtige Ebene für alles, was Frage "wie lief meine Kampagne" beantwortet. Es ist die richtige Ebene, sobald Sie Metriken je Kampagne, Anzeigengruppe, Anzeige oder Keyword nachvollziehen und in ein eigenes Dashboard oder BI-Werkzeug übernehmen wollen.
Nicht die richtige Ebene ist sie für Fragen, die sich erst über mehrere Touchpoints und Zeiträume stellen: incrementality, audience overlap, Customer-Journey-Analyse, die Kombination mit Ihren eigenen First-Party-Daten. Dafür ist AMC zuständig: AMC verbindet die Werbe-Kontakte über die Zeit, und die Herkunft einer Conversion im Amazon-Kanal lesen Sie dort ab. Amazon Attribution ist das andere Ende derselben Frage, aber nur für Kanäle außerhalb von Amazon.
Und noch eine Grenze: Amazon Ads Reporting liefert die Werbe-Performance, nicht Ihre Margen. Für Deckungsbeitrag, Einkaufspreise und Bestandswirkung brauchen Sie zusätzlich die Verkaufsdaten aus dem Vendor- oder Seller-Pfad. Die drei Ebenen zu vermischen ist der häufigste Fehler in Reports, die dann plausibel aussehen und trotzdem keine Entscheidung tragen.
Schritt für Schritt
- Antwort auf den Verwendungszweck festlegen. Einmalige Auswertung, periodischer Bericht oder kontinuierlicher Datenfluss? Das entscheidet zwischen Reporting API v1 und Marketing Stream v2.
- Aktuelle Version prüfen. Prüfen Sie, ob Ihre Integration noch auf Reporting API v3 oder Marketing Stream v1 läuft. Beide werden am 30. Juni 2027 abgeschaltet.
- Metriken und Dimensionen festlegen. Legen Sie fest, welche Kennzahlen und welche Dimensionen Sie brauchen. Die Reporting API v1 kombiniert beliebige Dimensionen in einer Anfrage.
- Berichte zeitlich staffeln. Planen Sie die Abrufe über den Tag verteilt und je Client-ID serialisiert. Ein gleichzeitiger Report pro Client-ID ist die Obergrenze.
- Conversions monatlich nachziehen. Conversions können bis zu 60 Tage zurück geändert werden. Ziehen Sie Reports deshalb monatlich erneut ab.
- Metadaten über Exports holen. Budget, Status und Strukturdaten gehören in den Export-Ressource-Pfad, nicht in den Report.
Häufige Fragen
Wann wird Reporting API v3 abgeschaltet?
Amazon nennt den 30. Juni 2027 als Abschalttermin für v3 reporting, Marketing Stream Version 1, Version 2 reporting für Sponsored Ads und das Amazon DSP Reporting. Neue Integrationen sollten Reporting API v1 oder Marketing Stream v2 nutzen.
Was ist der Unterschied zwischen Reporting API v1 und Marketing Stream v2?
Die Reporting API v1 zieht Berichte auf Abruf, mit vorbereiteten Metriken und Dimensionen und einem gleichzeitigen Report pro Client-ID. Marketing Stream v2 schiebt vollständige Datensätze alle 15 Minuten in Ihren S3-Bucket, ohne Polling und ohne Drosselung, und liefert bei Anlage des Abos bis zu 70 Tage nach.
Wie schnell sind die Klickdaten verfügbar?
Die ersten Impression- und Klickdaten stehen innerhalb von 12 Stunden zur Verfügung. Amazon validiert Klicks jedoch nachträglich, und empfiehlt, mindestens 5 Tage zu warten, bevor Sie die Kampagnenleistung bewerten.
Warum ändern sich Conversion-Zahlen nachträglich?
Conversions werden in täglichen, wöchentlichen und monatlichen Intervallen aktualisiert und geprüft und können bis zu 60 Tage zurück geändert werden. Deshalb empfiehlt Amazon, Reports monatlich erneut abzurufen.
Reicht Amazon Ads Reporting für meine Analyse?
Für Kampagnen-Performance ja. Für incrementality, Audience-Überschneidung, Customer-Journey-Analyse und die Kombination mit eigenen First-Party-Daten ist AMC zuständig; dort lesen Sie auch die Herkunft einer Conversion im Amazon-Kanal ab. Amazon Attribution misst dagegen Kanäle außerhalb von Amazon.