Search-Console-Daten automatisch: Wochenbericht per API
Kurz gesagt: Wer jede Woche die Search Console öffnet, Zeiträume einstellt und Klicks, Impressionen und die wichtigsten Suchanfragen abschreibt, verliert Zeit und vergisst es irgendwann. Die Search Console bietet eine Programmierschnittstelle, über die ein kleines Skript genau diese Zahlen abruft, mit der Vorwoche vergleicht und als kurze E-Mail an das Team schickt. Dieser Artikel erklärt, wie die Schnittstelle funktioniert, welche Zugriffsrechte Sie brauchen, welche Eigenheiten Sie kennen müssen, etwa die Zeitzone und die Verzögerung der Daten, und wie ein Wochenbericht aussieht, der wirklich gelesen wird.
Was die Schnittstelle liefert
Die Methode searchanalytics.query der Search Console API gibt dieselben Leistungsdaten zurück, die Sie im Bericht „Leistung“ sehen: Klicks, Impressionen, Klickrate und durchschnittliche Position. Laut Dokumentation lassen sich die Daten nach Dimensionen wie Land, Gerät, Seite und Suchanfrage gruppieren und nach Darstellungsart, Ergebnistyp und Zeitraum filtern.
Eine Anfrage ist ein einfacher POST-Aufruf an die Adresse der jeweiligen Property mit einem kleinen JSON-Inhalt. Pflichtangaben sind Start- und Enddatum. Optional legen Sie Dimensionen, Filter und die Zahl der Zeilen fest. Laut Dokumentation ist rowLimit zwischen 1 und 25 000 zulässig, Standard sind 1 000 Zeilen. Für mehr Zeilen blättern Sie mit startRow.
Zugriff einrichten
Die Dokumentation nennt für die Abfrage zwei mögliche Berechtigungsbereiche: einen nur lesenden und einen vollen. Für einen Bericht genügt der lesende Bereich. Zwei Wege sind üblich:
- Dienstkonto: In einem Google-Cloud-Projekt legen Sie ein Dienstkonto an, aktivieren die Search Console API und fügen die E-Mail-Adresse des Dienstkontos in der Search Console als Nutzer mit eingeschränkten Rechten hinzu. Das Skript meldet sich dann ohne menschliches Zutun an.
- OAuth mit einem Personenkonto: Eine Person erteilt einmal die Freigabe, das Skript speichert ein Erneuerungstoken. Das ist einfacher für Einzelpersonen, aber an diese Person gebunden.
Für einen Betrieb ist das Dienstkonto meist die robustere Lösung, weil der Bericht nicht ausfällt, wenn eine Mitarbeiterin das Unternehmen verlässt. Bewahren Sie die Schlüsseldatei des Dienstkontos wie ein Passwort auf und geben Sie ihm nur die Rechte, die es braucht.
Die Eigenheiten der Daten
Drei Punkte führen in selbst gebauten Berichten oft zu Verwirrung:
Zeitzone. Laut Dokumentation werden Start- und Enddatum in pazifischer Zeit angegeben. Ein „Tag“ in der Search Console beginnt also nicht um Mitternacht in Wien, Berlin oder Zürich. Für Wochenvergleiche spielt das kaum eine Rolle, solange Sie konsequent dieselben Zeiträume abfragen.
Verzögerung. Die Daten der letzten Tage sind noch nicht endgültig. Laut Dokumentation liefert die Schnittstelle ohne weitere Angabe nur abgeschlossene Daten. Mit dataState auf all erhalten Sie auch frische, noch vorläufige Werte. Für einen Wochenbericht ist es sinnvoll, die Woche erst nach einigen Tagen auszuwerten oder ausdrücklich nur endgültige Daten zu verwenden, damit sich Zahlen nicht nachträglich verschieben.
Unvollständige Suchanfragen. Nicht jede Suchanfrage wird einzeln ausgewiesen. Die Summe der Klicks über alle Suchanfragen kann deshalb kleiner sein als die Gesamtzahl der Klicks ohne Gruppierung. Fragen Sie die Gesamtwerte daher getrennt ab, ohne Dimension.
Was in den Bericht gehört
Ein Wochenbericht wird gelesen, wenn er kurz ist und Veränderungen zeigt. Bewährt hat sich ein Aufbau mit wenigen Blöcken:
- Klicks und Impressionen der Woche im Vergleich zur Vorwoche und zur gleichen Woche im Vorjahr, sofern vorhanden.
- Die zehn Seiten mit den meisten Klicks und ihre Veränderung.
- Suchanfragen mit dem größten Zuwachs und dem größten Rückgang.
- Ein Hinweis, wenn eine wichtige Seite plötzlich deutlich weniger Impressionen hat.
Verzichten Sie auf lange Listen. Wer mehr Details braucht, öffnet die Search Console. Der Bericht soll Anlass geben, genauer hinzusehen, nicht die Analyse ersetzen.
Technische Umsetzung
Für die Abfrage gibt es offizielle Programmbibliotheken von Google für gängige Sprachen, etwa Python oder Node.js. Ein typischer Ablauf:
Anmeldung mit Dienstkonto (Bereich: webmasters.readonly)
Abfrage Gesamtwerte: letzte Woche und Vorwoche
Abfrage nach Seite: letzte Woche, rowLimit 50
Abfrage nach Suchanfrage: beide Wochen, Vergleich berechnen
E-Mail mit kurzer HTML-Übersicht versenden
Lassen Sie das Skript über einen Zeitplan laufen, etwa montags am Vormittag, auf einem Server, einer Automatisierungsplattform oder als geplanter Job in Ihrer Versionsverwaltung. Protokollieren Sie Fehler und lassen Sie sich benachrichtigen, wenn der Bericht ausbleibt. Eine stille Unterbrechung fällt sonst erst nach Wochen auf.
Den Bericht weiterentwickeln
Nach einigen Wochen zeigt sich, welche Teile des Berichts gelesen werden und welche nicht. Fragen Sie die Empfänger kurz nach, was ihnen hilft. Oft lohnt es sich, Seiten nach Bereichen zu gruppieren, etwa Produkte, Ratgeber und Standorte, und für jeden Bereich nur eine Zeile mit der Veränderung zu zeigen. Ebenso sinnvoll ist eine Trennung nach Gerät, wenn sich mobile und Desktop-Nutzung unterschiedlich entwickeln, oder nach Land, wenn Sie in mehreren Ländern verkaufen.
Wenn Sie die abgerufenen Daten zusätzlich in einer eigenen Datenbank ablegen, können Sie später längere Zeiträume vergleichen, als die Oberfläche anbietet. Halten Sie den Bericht trotzdem kurz. Eine zweite, ausführliche Monatsauswertung ist besser als ein Wochenbericht, der mit jeder Erweiterung länger und damit seltener gelesen wird.
Datenschutz und Weitergabe
Die Daten der Search Console enthalten keine personenbezogenen Angaben einzelner Besucher, sind aber Geschäftsinformationen. Überlegen Sie, wer den Bericht bekommen soll. Für externe Agenturen kann ein eigener Bericht mit weniger Details sinnvoll sein.
Beispiel zur Veranschaulichung
Ein Hersteller von Holzspielzeug mit Kunden in Deutschland, Österreich und der Schweiz (Beispiel zur Veranschaulichung) möchte wöchentlich wissen, wie sich die Sichtbarkeit seiner Produktseiten entwickelt. Die Agentur richtet ein Dienstkonto mit Lesezugriff ein und schreibt ein kurzes Skript, das jeden Montag die abgeschlossenen Daten der Vorwoche abruft, mit der Woche davor vergleicht und eine E-Mail mit fünf Kennzahlen, den zehn wichtigsten Seiten und den auffälligsten Suchanfragen verschickt. Fällt eine Seite stark ab, steht sie im Bericht ganz oben.
Typische Fehler
- Vorläufige Daten der letzten Tage auswerten und sich über spätere Änderungen wundern.
- Summen aus Suchanfragen als Gesamtwerte verwenden.
- Das Skript an das persönliche Konto einer einzelnen Person binden.
- Dem Dienstkonto volle Rechte statt Lesezugriff geben.
- Einen Bericht mit Hunderten Zeilen schicken, den niemand liest.
Häufige Fragen
Kostet die Search Console API etwas?
Die Nutzung ist im Rahmen der von Google festgelegten Kontingente kostenlos. Prüfen Sie die aktuellen Grenzen in der Dokumentation.
Wie weit reichen die Daten zurück?
Die Search Console stellt Leistungsdaten für einen begrenzten Zeitraum bereit. Wer längere Vergleiche braucht, sollte die Daten regelmäßig selbst speichern.
Kann ich mehrere Websites in einem Bericht zusammenfassen?
Ja. Das Dienstkonto braucht Zugriff auf jede Property, und das Skript fragt sie nacheinander ab.
Warum weichen meine Zahlen von der Oberfläche ab?
Häufig wegen unterschiedlicher Zeiträume, vorläufiger Daten oder fehlender Gesamtabfrage ohne Dimension.
Wenn Sie Ihre Search-Console-Daten automatisch und verständlich jede Woche im Postfach haben möchten, bauen wir den Bericht gern mit Ihnen auf: Wochenbericht einrichten.