Und ARBEN KQIKU
Nachdem Google kürzlich das Abschaltdatum der AdWords API bekannt gegeben hat, müssen alle, die sie zum Datenabruf nutzen, auf die neue Google Ads API wechseln.
Google hat kürzlich angekündigt, die AdWords API am 27. April 2022 abzuschalten. Nach diesem Datum erhalten Werbetreibende, die die API zum Abruf von Daten aus ihren Google-Ads-Kampagnen nutzen, keine wichtigen Performance-Analysen mehr und auch nicht die Mittel, um Vorgänge wie das Gebotsmanagement zu skalieren. Das ist ein Problem für alle, die automatisierte Skripte einsetzen, die auf der alten API beruhen. In diesem Leitfaden erklären wir, wie Sie zur neuen API migrieren und zugleich von ihren neuen Funktionen und Features profitieren.
Was hat sich geändert?
Die alte API erlaubte es Werbetreibenden, je nach Bedarf zwischen verschiedenen Report-Typen zu wählen. Sie konnten zum Beispiel Kampagnen-Performance-Reports erstellen, um die Performance auf Kampagnenebene zu messen, oder Anzeigengruppen-Performance-Reports, um sie auf Anzeigengruppenebene zu messen. Die neue Google Ads API hingegen verfügt über Ressourcen, die abgefragt werden können, statt über Performance-Reports. Will ein Werbetreibender also auf die Daten zu Kampagnen zugreifen, fragt er die Ressource campaigns ab, statt den Kampagnen-Performance-Report.
Wie funktioniert die neue API?
Die ursprüngliche AdWords API nutzt zur Abfrage der API eine eigene Abfragesprache, die AdWords Query Language (AWQL). Die neue API hingegen nutzt eine moderne programmatische Schnittstelle auf Basis der Google Ads Query Language (GAQL). Diese Sprache wird verwendet, um über die Google Ads API Abfragen für Ressourcen und zugehörige Attribute, Segmente und Metriken mithilfe des Google Ads Service zu senden. Praktisch bedeutet das, dass automatisierte Skripte neu geschrieben werden müssen, damit sie mit der neuen Abfragesprache und der neuen API funktionieren.
So bauen Sie Abfragen für die neue API
Der Aufbau dieser Abfragen erfordert Fachwissen. Glücklicherweise gibt es Ressourcen zur Unterstützung von Entwicklern, etwa die offizielle Dokumentation der Google Ads API. Es gibt zudem ein neues Query-Builder-Tool, das Entwicklern hilft, rasch neue Abfragen zu erstellen. So können wir mit dem Tool eine neue Abfrage von Grund auf aufsetzen:
- Wählen Sie einen Ressourcennamen, den Sie abfragen möchten, etwa campaign. Der Query Builder zeigt dann eine Liste aller Felder, Segmente und Metriken, die zu dieser Ressource gehören.
- Nun können wir zwischen den verschiedenen Reitern oben im Formular wählen, etwa select, where, order by, limit und parameters.
- Klappen Sie den gewünschten Reiter auf, um eine Liste ankreuzbarer Kästchen anzuzeigen, etwa Attribut-Ressourcenfelder, Segmente und Metriken. Ein Häkchen baut Ihre GAQL-Abfrage auf. Mit etwas Ausprobieren verstehen Sie besser, wie Sie über die Reiter select, where, order by und limit unerwünschte Ressourcen segmentieren und herausfiltern und Ihre Ergebnisse sortieren. Ihr Endergebnis sollte ungefähr so aussehen:
Mit dem Query-Builder-Tool können Sie zudem rasch Syntax und Struktur prüfen, doch um sicherzustellen, dass die Abfrage gültig ist, müssen Sie das Query-Validator-Tool nutzen. Stellen wir uns vor, wir wollen die Abfrage aus dem Screenshot oben validieren. Kopieren Sie sie einfach in die Zwischenablage, navigieren Sie zum Query Validator und fügen Sie sie in das Dialogfeld ein. Der Validator sagt Ihnen, ob es Probleme mit Ihrer Abfrage gibt.
Muss ich alle alten AWQL-Abfragen neu schreiben?
Die gute Nachricht: Sie müssen nicht alle Ihre alten AWQL-Abfragen aus der alten API von Grund auf neu schreiben. Da sich die Namenskonventionen der beiden APIs recht stark unterscheiden, ist der mit Abstand schnellste und effizienteste Weg, das Migrations-Tool zu nutzen. Damit geben Sie die ursprüngliche AWQL-Abfrage ein, woraufhin sie automatisch in eine neue GAQL-Abfrage umgewandelt wird. Ist die Umwandlung erfolgreich, erscheint die Ausgabe grün.
Hier ein praktisches Beispiel, wie wir das Migrations-Tool nutzen können. In diesem Beispiel verwenden wir ein Google Ads Script, um die Kampagnennamen auszuwählen, die ein bestimmtes Kampagnen-Label enthalten, und vergleichen die Ausgabe zwischen der alten und der neuen API.
- Wählen Sie Ihre Google-Ads-Konto-ID.
2. Wählen Sie eine Abfrage, die in der alten AdWords-AWQL-Abfragesprache geschrieben ist
Mit der alten AdWords API sollte der Code ungefähr so aussehen:
Mit der neuen AdWords API sollte der Code ungefähr so aussehen:
3. Fassen Sie alle Zeilen dieser Abfrage zusammen. Beachten Sie, dass wir im Beispiel unten AdsApp.report() und report.rows() nutzen, um das gewünschte Ergebnis in der alten API zu erzielen.
In der neuen Google Ads API ist der Code knapper und sollte so aussehen:
4. Erstellen Sie einen Container und schieben Sie alle Zeilen hinein. Mit der alten AdWords API sollte das Ergebnis ungefähr so aussehen:
An diesem Punkt sind noch Zeilen übrig, daher müssen wir eine neue Variable namens row erstellen und daraus den Kampagnennamen greifen, um ihn in den Container allCampaigns zu schieben. Dieser Vorgang unterscheidet sich leicht von der Google Ads API, da die Ressourcen eigene Objekte sind. Zum Beispiel wird aus campaign.name zwei getrennte Einheiten: zunächst campaign, gefolgt von name.
Sie können die von beiden APIs abgerufenen Daten in zwei getrennte Spalten einer Google-Sheets- oder Excel-Tabelle eintragen und ihre Ausgaben dann vergleichen. Hat der Umwandlungsprozess korrekt funktioniert, sollten die Ergebnisse zwischen den beiden APIs identisch sein.
Was passiert, wenn ich nicht zur neuen API migriere?
Alle, die die alte AdWords API zum Datenabruf nutzen, müssen bis zum Abschaltdatum zur Google Ads API migrieren. Ab dem 27. April 2022 schlagen alle Anfragen an die alte API fehl, sodass Werbetreibende keine entscheidenden datengetriebenen Erkenntnisse zur Performance ihrer Google-Ads-Kampagnen mehr abrufen können. Das ist eine erhebliche Herausforderung für alle, die stark auf automatisierte Skripte setzen, um Vorgänge wie Performance-Reporting, Gebotsmanagement und Split-Testing zu skalieren.
Allerdings hat Google die Migration der Abfragen zur neuen API recht unkompliziert gestaltet. So können Werbetreibende auch die besonderen Vorteile des Upgrades geniessen, darunter die Möglichkeit, ihre Reporting-Fähigkeiten mit einer intuitiveren Abfragesprache zu erweitern und zu skalieren. Die Google Ads API hat zudem einen stetigen Release-Fahrplan und rollt regelmässig neue Features und Fixes aus, um mit Googles neuesten Standards Schritt zu halten.
Falls Sie mit der neuen API noch ringen, kann comtogether Ihnen helfen, Ihre Skripte zu migrieren, damit Ihnen nie entscheidende Erkenntnisse entgehen. Kontaktieren Sie uns noch heute, um mehr zu erfahren.