Google Ads API Daten nach BigQuery übertragen
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
- Script installieren
- Übertragungsfenster festlegen
- Daten festlegen mit dem GAQL Query Builder
- Ü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.
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.
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
| 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.
Hier ein Beispiel für einen vollständig konfigurierten Abruf von ‚ad_group_ad‘:
Ü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).
Hinterlasse einen Kommentar