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
  1. Python 3.8+ auf Ihrem Server oder lokalen Rechner installiert
  2. Abhängigkeiten installieren: pip install requests pandas
  3. Einen API Token und eine Partner ID von The Trade Desk beziehen
  4. Die Ziel-Advertiser ID für den Export notieren
Script konfigurieren
  1. Die Datei carbon-intelligence-thetradedesk-export.py öffnen
  2. Die Authentifizierungsparameter ausfüllen: API_TOKEN, PARTNER_ID, ADVERTISER_ID
  3. OUTPUT_DIR für den CSV-Zielordner konfigurieren
Ausführen
  1. Das Script ausführen: python carbon-intelligence-thetradedesk-export.py
  2. Wiederkehrende Ausführung planen über cron (Linux/macOS) oder Aufgabenplanung (Windows)
  3. Empfehlung: wöchentlich (jeden Montag morgens)
📊
Was exportiert wird
13 Tabs automatisch erstellt
TabInhaltVerwendung Carbon Intelligence
CI_CampaignsZusammenfassung nach Kampagne und TagEmissionsübersicht
CI_DeviceNach Gerät (Mobil, Desktop, CTV)Energiefaktor pro Gerät
CI_GeoNach Land und RegionGMSF v1.2 Länder-Energiemix
CI_PlacementsNach Website und AnwendungEnergieintensive Platzierungen
CI_CreativeSizeNach Creative-Größe (300x250, 728x90, etc.)Datentransfergewicht
CI_AdFormatNach Format (Display, Video, Native)Anzeigenformat-Faktor
CI_VideoDetaillierte Videodaten (Dauer, Typ)Video-Kohlenstoffberechnung
CI_ExchangeNach Exchange (Rubicon, OpenX, AppNexus, etc.)🎯 TTD-spezifisch — Inventarquelle
CI_ConnectionNach Verbindungstyp (WiFi, Mobil, Kabel)🎯 TTD-spezifisch — Netzwerk-Energieeffizienz
CI_EnvironmentNach Kontext (App, Web, OTT)🎯 TTD-spezifisch — Medienumgebungstyp
CI_BuyTypeNach Kaufmodus (Open Auction, PMP, PG)🎯 TTD-spezifisch — Transparenz der Kaufstrategie
CI_MetadataKontoinformationen, Script-Version, DatenRückverfolgbarkeit und Audit
CI_Export_CSVAlle Dimensionen konsolidiertDirektimport 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
📨
Teilen Sie das Google Sheet mit: support@carbonintelligence.green (accès lecteur)
Oder senden Sie die exportierte CSV per E-Mail an dieselbe Adresse.
🔧
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
🛠️
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
Script-Version 1.0.0
Methodik GMSF v1.2 (Ad Net Zero)