Carbon Intelligence™
The Trade Desk Exportleitfaden — Python-Script
GMSF v1.2
The Trade Desk
10 min install
Ziel
Dieses Python-Script exportiert automatisch Ihre The Trade Desk-Kampagnendaten mit der für die GMSF v1.2 Kohlenstoffanalyse in Carbon Intelligence™ erforderlichen Granularität. The Trade Desk bietet eine sehr feine Granularität bei Exchanges, Verbindungen und Kauftypen.
Installation
3 Schritte · 10 Minuten
Voraussetzungen
- Python 3.8+ auf Ihrem Server oder lokalen Rechner installiert
- Abhängigkeiten installieren:
pip install requests pandas - Einen API Token und eine Partner ID von The Trade Desk beziehen
- Die Ziel-Advertiser ID für den Export notieren
Script konfigurieren
- Die Datei
carbon-intelligence-thetradedesk-export.pyöffnen - Die Authentifizierungsparameter ausfüllen:
API_TOKEN,PARTNER_ID,ADVERTISER_ID OUTPUT_DIRfür den CSV-Zielordner konfigurieren
Ausführen
- Das Script ausführen:
python carbon-intelligence-thetradedesk-export.py - Wiederkehrende Ausführung planen über
cron(Linux/macOS) oder Aufgabenplanung (Windows) - Empfehlung: wöchentlich (jeden Montag morgens)
Was exportiert wird
13 Tabs automatisch erstellt
| Tab | Inhalt | Verwendung Carbon Intelligence |
|---|---|---|
| CI_Campaigns | Zusammenfassung nach Kampagne und Tag | Emissionsübersicht |
| CI_Device | Nach Gerät (Mobil, Desktop, CTV) | Energiefaktor pro Gerät |
| CI_Geo | Nach Land und Region | GMSF v1.2 Länder-Energiemix |
| CI_Placements | Nach Website und Anwendung | Energieintensive Platzierungen |
| CI_CreativeSize | Nach Creative-Größe (300x250, 728x90, etc.) | Datentransfergewicht |
| CI_AdFormat | Nach Format (Display, Video, Native) | Anzeigenformat-Faktor |
| CI_Video | Detaillierte Videodaten (Dauer, Typ) | Video-Kohlenstoffberechnung |
| CI_Exchange | Nach Exchange (Rubicon, OpenX, AppNexus, etc.) | 🎯 TTD-spezifisch — Inventarquelle |
| CI_Connection | Nach Verbindungstyp (WiFi, Mobil, Kabel) | 🎯 TTD-spezifisch — Netzwerk-Energieeffizienz |
| CI_Environment | Nach Kontext (App, Web, OTT) | 🎯 TTD-spezifisch — Medienumgebungstyp |
| CI_BuyType | Nach Kaufmodus (Open Auction, PMP, PG) | 🎯 TTD-spezifisch — Transparenz der Kaufstrategie |
| CI_Metadata | Kontoinformationen, Script-Version, Daten | Rückverfolgbarkeit und Audit |
| CI_Export_CSV | Alle Dimensionen konsolidiert | Direktimport CI-Plattform |
CSV-Export
Zwei Optionen verfügbar
Nach jeder Script-Ausführung finden Sie im Ordner
OUTPUT_DIR die folgenden CSV-Dateien:- •
CI_Export_[DATE].csv— Konsolidierte Datei für Direktimport - •
CI_Campaigns_[DATE].csv— Kampagnendetails - •
CI_Device_[DATE].csv— Nach Gerät - •
CI_Exchange_[DATE].csv— Nach Exchange (TTD-spezifisch) - • ...und weitere Dimensionen
Teilen mit Carbon Intelligence™
Erweiterte Konfiguration
CONFIG-Abschnitt des Skripts
# Im Script, Abschnitt CONFIG:
LOOKBACK_DAYS: 90, # Tage des Verlaufs (Standard: 90)
MIN_IMPRESSIONS: 1, # Minimaler Impressions-Schwellenwert pro Zeile
REPORT_TIMEZONE: 'UTC', # Zeitzone des Berichts
MAX_RETRIES: 3 # API-Wiederholungsversuche bei Fehler
LOOKBACK_DAYS: 90, # Tage des Verlaufs (Standard: 90)
MIN_IMPRESSIONS: 1, # Minimaler Impressions-Schwellenwert pro Zeile
REPORT_TIMEZONE: 'UTC', # Zeitzone des Berichts
MAX_RETRIES: 3 # API-Wiederholungsversuche bei Fehler
Fehlerbehebung
"401 Unauthorized"
Überprüfen Sie, ob Ihr
API_TOKEN gültig und nicht abgelaufen ist. Generieren Sie ihn bei Bedarf in der The Trade Desk Konsole neu."Advertiser not found"
Überprüfen Sie, ob die
ADVERTISER_ID existiert und Ihr Token Zugriff auf dieses Konto hat."Report timeout"
Der Bericht dauert zu lange. Reduzieren Sie
LOOKBACK_DAYS von 90 auf 30 Tage."Empty report"
Überprüfen Sie, ob Sie aktive Kampagnen mit Impressions für den von
LOOKBACK_DAYS definierten Zeitraum haben."Rate limit exceeded"
Die The Trade Desk API hat ein Kontingent. Warten Sie einige Minuten und versuchen Sie es erneut. Erhöhen Sie
MAX_RETRIES für bessere Resilienz.Unterstützung
Email
support@carbonintelligence.green
Webseite
carbonintelligence.green
Script-Version
1.0.0
Methodik
GMSF v1.2 (Ad Net Zero)