Google Ads API Daten nach BigQuery übertragen

Inhalt ausblenden

Der Artikel zeigt den Transfer von Google Ads API Daten nach Google BigQuery anhand von benutzerdefinierten Reportings, welche individuell konfiguriert werden können.

Mögliche Übertragungswege

Man kann die Google Ads API-Daten auf verschiedene Weisen in BigQuery übertragen. Eine Möglichkeit ist es, einen ETL-Prozess (Extract, Transform, Load) mit einem Drittanbieter-ETL-Tool zu erstellen. Diese Tools extrahieren die Daten aus der Google Ads API, wandeln sie in das richtige Format um und laden sie dann in BigQuery hoch.

Ein weiterer Weg besteht in 2 existierenden Google Transfer Services für Google Ads , die bereits mit BigQuery mitgeliefert werden. Leider hinkt hier häufig die API-Version des Service hinterher und so erhält man nicht die neusten Datentypen, die Google eingeführt hat. Insbesondere in Bezug auf Pmax Kampagnen und deren Asset Groups stellt dies derzeit eine Einschränkung dar, welche es sich lohnt zu überwinden.

Ein einfacher Ansatz die Daten nach BigQuery zu übertragen, stellt eine Apps Script dar, welches an die eigenen Datenbedürfnisse angepasst werden kann.

Apps Script zur Übertragung  von Google Ads API Daten nach BigQuery

Das Script wird in der Google Apps Script Umgebung installiert und täglich ausgeführt. Bei der Ausführung werden die zuvor konfigurierten Tabellen genommen und mit der Google Ads API abgefragt. Anschließend werden die Daten nach Google BigQuery übertragen.

Vor- und Nachteile dieser Lösung

Vorteile:

  • Flexibel, auf API Neuerungen kann individuell reagiert werden.
  • Datensparsam: Es werden nur konfigurierte Tabellen übertragen.
  • Kostengünstig, da keine weiteren Infrastrukturen eingerichtet werden müssen.

Nachteile:

  • Tägliche Übertragung ist aufgrund der API-Limits nur bedingt möglich.
  • Wenn die Daten in Echtzeit benötigt werden, ist diese Lösung nicht geeignet
  • Die Daten werden in BigQuery abgelegt, wie sie von der API angeliefert werden. Dies bedeutet, dass zusätzliche Reportings eingerichtet werden müssen, um die Daten für die Analyse aufzubereiten

Installation

  1. Script installieren
  2. Übertragungsfenster festlegen
  3. Daten festlegen mit dem GAQL Query Builder
  4. Übertragung starten

Script installieren

Das Script von unten mit Copy & Paste in ein Google Ads Script oder Apps Script übertragen. Alle Script-Konfiguration findet in der CONFIG variable statt. Der Rest sollte nur editiert werden, wenn man weiß was man tut.

In der Scriptumgebung muss BigQuery noch als Extra-Service angestellt werden.

Google Ads Script erweiterte APIs

Anschließend muss die Variable des Scripts konfiguriert werden.

Variablen konfigurieren

In der CONFIG Variable werden alle Einstellungen vorgenommen, die das Script benötigt. Die Variablen sollten von der Namensgebung her selbsterklärend sein. Ansonsten hilft der Kommentar dahinter.

Copy to Clipboard

Daten festlegen mit dem GAQL Query Builder

Im CONFIG.REPORTS Array können API-Calls werden. Dabei ist jeder Abruf ein Objekt mit den Variablen wie in der Tabelle und im Beispiel gezeigt. Für den Aufbau der API-Calls empfehle ich, dringend den Google Ads API Query Builder zu nutzen, da dieser zunächst zeigt, welche Felder überhaupt kombiniert werden dürfen.

Variable Value
NAME Der Tabellen Name in der Google Ads-Api ‚asset_group_product_group_view‚
CONDITION Hier kann ein „WHERE“ statement eingefügt werden
FIELDS Die im Report gewünschten  Felder.
RETURN_FIELDS Felder, welche von der API ohne Anforderung gesendet werden. Notwendig zur Erstellung der Tabellenfelder in BigQuery
PARTITION_FIELD Notwendig, wenn das Feld segemens_date zur Partitionierung genutzt werden soll. In allen anderen Feldern leer lassen.

Zusätzlich müssen die Felder definiert werden mit

Copy to Clipboard
Variable Value
FieldName Der Name des Feldes wie in der Google Ads Api gezeigt.
Format Datentypen, wie für BigQuery definiert.
Alias FieldName Conversion that works for Google BigQuery as colmun name.

Wie in dem Code-Beispiel für die eigentlich Query zeigt, wie die Felder während des API-Abrufs genutzt werden.

Copy to Clipboard

Hier ein Beispiel für einen vollständig konfigurierten Abruf von ‚ad_group_ad‘:

Copy to Clipboard

Übertragung starten

Wenn alle komponenten korrekt konfiguriert wurden, kann der Google Ads Api Abruf gestartet werden.

Das komplette Script zur freien Nutzung:

Hier veröffentliche ich das Script als komplette Version. Ich freue mich auf Kommentare, Feedback, Verbesserungen und natürlich eure Erweiterung der Abrufkonfigurationenen unter (CONFIG.REPORTS).