Carbon Intelligence™
DV360 Export-Anleitung — Python-Skript
GMSF v1.2
DV360
10 min install
Ziel
Dieses Python-Skript exportiert automatisch Ihre DV360-Kampagnendaten mit maximaler Granularität für die GMSF v1.2 CO2-Analyse in Carbon Intelligence™. DV360 bietet exklusive Dimensionen, die in Google Ads nicht verfügbar sind: Verbindungstyp, Exchange, Umgebung und Einkaufsmodus.
Installation
3 Schritte · 10 Minuten
Voraussetzungen
- Python 3.8+ auf Ihrem Rechner installiert
- Abhängigkeiten installieren:
pip install google-api-python-client google-auth pandas - Ein Dienstkonto in der Google Cloud Console erstellen
- Die DV360 Reporting API in Ihrem Cloud-Projekt aktivieren
- Die JSON-Datei des Dienstkontos herunterladen (privater Schlüssel)
Skript konfigurieren
carbon-intelligence-dv360-export.pyöffnen- Im Abschnitt CONFIG ausfüllen:
- •
SERVICE_ACCOUNT_PATH: Pfad zur heruntergeladenen JSON-Datei - •
ADVERTISER_ID: Ihre DV360-Advertiser-ID
- •
- Optional:
SPREADSHEET_URLfür den Export nach Google Sheets konfigurieren - Optional:
OUTPUT_DIRfür den lokalen CSV-Export konfigurieren
Skript ausführen
- Ausführen:
python carbon-intelligence-dv360-export.py - Zur Planung der Ausführung:
- • Linux/Mac:
cronverwenden (z.B.:0 9 * * 1= Montag 9 Uhr) - • Windows: Aufgabenplanung verwenden
- • Linux/Mac:
- Empfohlen: wöchentliche Ausführung am Montagmorgen
Was exportiert wird
12 Tabs automatisch erstellt
| Tab | Inhalt | Verwendung Carbon Intelligence |
|---|---|---|
| CI_Campaigns | Nach Insertion Order und Woche | Emissionsübersicht |
| CI_Device | Nach Gerät (Desktop, Mobil, Tablet, CTV) | Energiefaktor |
| CI_Geo | Nach Land und Region | GMSF v1.2 Energiemix |
| CI_Placements | Nach Website/App und Domain | Energieintensive Platzierungen |
| CI_CreativeSize | Nach Kreativdimensionen | Datentransfergewicht |
| CI_AdFormat | Nach Format (Display, Video, Native, Audio, Rich Media) | Formatfaktor |
| CI_Video | Detaillierte Videometriken (Dauer, Quartile) | Video-CO2-Berechnung |
| CI_Exchange | Nach Exchange (Google, Index, OpenX, etc.) | 🎯 DV360-Exklusiv |
| CI_Connection | Nach Verbindungstyp (WiFi, 4G, 5G) | 🎯 DV360-Exklusiv |
| CI_Environment | Nach Umgebung (Web, App, CTV) | 🎯 DV360-Exklusiv |
| CI_Metadata | Export- und Kontoinformationen | Rückverfolgbarkeit |
| CI_Export_CSV | Alle Dimensionen konsolidiert | Direkter CI-Import |
CSV-Export
Zwei Optionen verfügbar
Option A — Automatische CSV
Das Skript generiert automatisch CSV-Dateien in
OUTPUT_DIROption B — Google Sheets
SPREADSHEET_URL für direkten Export konfigurierenTeilen mit Carbon Intelligence™
Vorteile vs Google Ads
Exklusive DV360-Dimensionen
Verbindungstyp (WiFi/4G/5G) — nicht verfügbar in Google Ads
Mehrere Exchanges — nicht verfügbar in Google Ads
Einkaufsmodus (Open/PMP/PG) — nicht verfügbar in Google Ads
Umgebung (Web/App/CTV) — nicht verfügbar in Google Ads
Erweiterte Konfiguration
CONFIG-Abschnitt des Skripts
# Im Skript, Abschnitt CONFIG:
LOOKBACK_DAYS: 90, # Tage des Verlaufs
MIN_IMPRESSIONS: 10, # Mindestschwelle
INCLUDE_PAUSED: False, # Pausierte Kampagnen
OUTPUT_FORMAT: 'csv', # csv oder sheets
LOOKBACK_DAYS: 90, # Tage des Verlaufs
MIN_IMPRESSIONS: 10, # Mindestschwelle
INCLUDE_PAUSED: False, # Pausierte Kampagnen
OUTPUT_FORMAT: 'csv', # csv oder sheets
Fehlerbehebung
"Authentication failed"
Überprüfen Sie den Pfad zur JSON-Datei des Dienstkontos in
SERVICE_ACCOUNT_PATH."API not enabled"
Aktivieren Sie die DV360 Reporting API in der Google Cloud Console für Ihr Projekt.
"Advertiser not found"
Überprüfen Sie die Advertiser-ID in
ADVERTISER_ID — muss mit Ihrem DV360-Konto übereinstimmen.Timeout
Reduzieren Sie
LOOKBACK_DAYS auf 30 Tage, wenn die API zu lange braucht."No data"
Überprüfen Sie, ob aktive Kampagnen für den Zeitraum existieren. Erhöhen Sie
LOOKBACK_DAYS bei Bedarf.Unterstützung
Email
support@carbonintelligence.green
Webseite
carbonintelligence.green
Script-Version
1.0.0
Methodik
GMSF v1.2 (Ad Net Zero)