Carbon Intelligence™
Google Ads Export-Leitfaden
GMSF v1.2
Google Ads
5 min install
Ziel
Dieses Script exportiert automatisch Ihre Google Ads-Kampagnendaten mit der für die GMSF v1.2-Kohlenstoffanalyse erforderlichen Granularität in Carbon Intelligence™.
Installation
3 Schritte · 5 Minuten
Ziel-Google-Sheet erstellen
- Gehen Sie zu sheets.new
- Benennen Sie die Datei um:
CI_Export_GoogleAds_[Kundenname] - Kopieren Sie die Sheet-URL
Script installieren
- Melden Sie sich bei Google Ads an
- Gehen Sie zu Tools und Einstellungen → Massenaktionen → Scripts
- Klicken Sie auf + (Neues Script)
- Benennen Sie das Script:
Carbon Intelligence Export - Fügen Sie den Inhalt von
carbon-intelligence-google-ads-export.jsein - Ersetzen Sie
COLLER_URL_GOOGLE_SHEET_ICIdurch Ihre Google Sheet-URL - Klicken Sie auf Autorisieren und dann auf Ausführen
Ausführung planen
- Klicken Sie nach der ersten erfolgreichen Ausführung auf Zeitplan erstellen
- Wählen Sie Wöchentlich (Montagmorgen empfohlen)
- Das Script wird automatisch jede Woche ausgeführt
Was exportiert wird
10 Tabs automatisch erstellt
| Tab | Inhalt | Verwendung Carbon Intelligence |
|---|---|---|
| CI_Campaigns | Zusammenfassung nach Kampagne und Woche | Emissionsübersicht |
| CI_Device | Nach Gerät (Mobil, Desktop, Tablet) | Energiefaktor pro Gerät |
| CI_Geo | Nach Land und Region | GMSF v1.2 Energiemix nach Land |
| CI_Placements | Nach Website und Anwendung | Energieintensive Platzierungen |
| CI_CreativeSize | Nach Kreativgröße | Datentransfergewicht |
| CI_AdFormat | Nach Format (Search, Display, Video) | Anzeigenformatfaktor |
| CI_Video | Detaillierte Videodaten | Video-Kohlenstoffberechnung (Dauer, Quartile) |
| CI_Metadata | Konto- und Exportinformationen | Rückverfolgbarkeit und Audit |
| CI_Diagnostic | Einzelne Abfragetests | Problemidentifikation |
| CI_Export_CSV | Alle Dimensionen konsolidiert | Direkter Import in die CI-Plattform |
CSV-Export
Zwei Optionen verfügbar
Option A — Aus Google Sheets
- Gehen Sie zum Tab CI_Export_CSV
- Datei → Herunterladen → CSV (.csv)
Option B — Über das Script
- Ändern Sie die Funktion zu
exportToCSV - Ausführen — eine CSV-Datei wird in Ihrem Google Drive erstellt
- Der Dateilink erscheint in den Logs
Teilen mit Carbon Intelligence™
Nicht abgedeckte Dimensionen
| Dimension | Warum | Alternative |
|---|---|---|
| Verbindungstyp (Wi-Fi/4G/5G) | Nicht verfügbar in Google Ads | Verfügbar über DV360 oder TTD |
| Exchange (SSP) | Google Ads = Walled Garden | Verfügbar über DV360 oder TTD |
| Einkaufsmodus (Open/PMP) | Spezifisch für offenes Programmatic | Verfügbar über DV360 oder TTD |
| Kreativgewicht (KB) | Nicht von Google Ads gemeldet | GMSF-Schätzung nach Formattyp |
| Active View / Viewability | Wird von Google eingestellt | Metriken in v1.2.0 entfernt |
Wenn Sie DV360 oder einen anderen DSP verwenden, kontaktieren Sie uns für ein dediziertes Skript.
Erweiterte Konfiguration
CONFIG-Abschnitt des Skripts
// Im Script, Abschnitt CONFIG:
LOOKBACK_DAYS: 90, // Tage des Verlaufs (Standard: 90)
MIN_IMPRESSIONS: 1, // Minimaler Impressionsschwellenwert pro Zeile
INCLUDE_PAUSED: true // Pausierte Kampagnen einbeziehen (empfohlen)
LOOKBACK_DAYS: 90, // Tage des Verlaufs (Standard: 90)
MIN_IMPRESSIONS: 1, // Minimaler Impressionsschwellenwert pro Zeile
INCLUDE_PAUSED: true // Pausierte Kampagnen einbeziehen (empfohlen)
Diagnose
Integrierte Diagnosefunktion
- In Google Ads > Scripts, öffnen Sie das Script
- Im Dropdown-Menü neben Ausführen, wählen Sie diagnose
- Klicken Sie auf Ausführen
- Öffnen Sie das Google Sheet und gehen Sie zum Tab CI_Diagnostic
Die Diagnose testet: Kontozugriff, jeden Abfragetyp einzeln, Anzahl aktiver und pausierter Kampagnen, Datenverfügbarkeit pro Typ (Device, Geo, Placements, Video...). Jeder Test ist farbcodiert: grün (OK), gelb (leer aber normal), rot (Fehler). Bei einem Fehler senden Sie einen Screenshot des CI_Diagnostic-Tabs an support@carbonintelligence.green.
Fehlerbehebung
"Authorization required"
Normal bei der ersten Ausführung. Klicken Sie auf Autorisieren und akzeptieren Sie die Berechtigungen.
"Spreadsheet not found"
Überprüfen Sie, ob die Google Sheet-URL in
CONFIG.SPREADSHEET_URL korrekt ist.Alle Spalten leer
Führen Sie die Funktion diagnose aus (Dropdown neben Ausführen > wählen Sie "diagnose"). Überprüfen Sie dann den Tab CI_Diagnostic im Google Sheet, der das genaue Problem identifiziert.
Pausierte Kampagnen
Wenn Ihre Kampagnen pausiert sind, exportiert das Script standardmäßig keine Daten. In v1.2.0 ist
INCLUDE_PAUSED standardmäßig auf true gesetzt. Für ältere Versionen setzen Sie INCLUDE_PAUSED: true im CONFIG-Abschnitt.Fehlende Daten
Überprüfen Sie, ob die Kampagnen Impressionen für den Zeitraum haben. Passen Sie
LOOKBACK_DAYS bei Bedarf an.Timeout
Wenn das Konto viele Daten hat, reduzieren Sie
LOOKBACK_DAYS auf 30 Tage.Leere Tabs
Einige Tabs (Video, Placements) werden nur gefüllt, wenn die entsprechenden Kampagnentypen aktiv sind.
Unterstützung
Email
support@carbonintelligence.green
Webseite
carbonintelligence.green
Script-Version
1.3.0
Methodik
GMSF v1.2 (Ad Net Zero)