Amazon DSP Exportleitfaden — Python-Script

GMSF v1.2 Amazon DSP 15 min install
🎯
Ziel
Dieses Python-Script exportiert automatisch Ihre Amazon DSP-Kampagnendaten mit der für die GMSF v1.2 Kohlenstoffanalyse in Carbon Intelligence erforderlichen Granularität. Amazon DSP bietet einzigartige Daten zu Amazon-Inventarquellen (IMDb TV, Twitch, Fire TV, etc.).
⚙️
Installation
3 Schritte · 15 Minuten
Voraussetzungen
  1. Python 3.8+ auf Ihrem Rechner installiert
  2. Abhängigkeiten installieren: pip install requests pandas
  3. Eine Anwendung in der Amazon Ads Developer Console erstellen
  4. Ihre Zugangsdaten beziehen: Client ID, Client Secret, Refresh Token
  5. Ihre DSP Profile ID in der Amazon Ads Konsole identifizieren
Konfigurieren
  1. Die Datei carbon-intelligence-amazon-dsp-export.py öffnen
  2. Die Konfigurationsvariablen am Anfang des Scripts ausfüllen:
    • CLIENT_ID = Ihre Client ID
    • CLIENT_SECRET = Ihr Client Secret
    • REFRESH_TOKEN = Ihr Refresh Token
    • PROFILE_ID = Ihre DSP Profile ID
  3. Das Ausgabeverzeichnis in OUTPUT_DIR festlegen
Ausführen
  1. Das Script ausführen: python carbon-intelligence-amazon-dsp-export.py
  2. Die exportierten Daten erscheinen in OUTPUT_DIR
  3. Regelmäßige Ausführung planen über cron (Linux/macOS) oder Aufgabenplanung (Windows)
📊
Was exportiert wird
11 Tabs automatisch erstellt
TabInhaltVerwendung Carbon Intelligence
CI_CampaignsNach Order/Line Item + WocheEmissionsübersicht
CI_DeviceDesktop, Mobil, Tablet, CTV, Fire TabletEnergiefaktor pro Gerät
CI_GeoNach Land und RegionGMSF v1.2 Länder-Energiemix
CI_PlacementsNach InventarquelleEnergieintensive Platzierungen
CI_CreativeSizeNach Creative-GrößeDatentransfergewicht
CI_AdFormatDisplay, Video, OLV, STV, Audio (Amazon-Formate)Anzeigenformat-Faktor
CI_VideoDetaillierte Videodaten (Dauer, Quartile)Video-Kohlenstoffberechnung
CI_SupplySourceAmazon-Inventar vs Drittanbieter🎯 Amazon DSP-spezifisch
CI_EnvironmentAuslieferungskontextAuslieferungsparameter
CI_MetadataKonto- und ExportinformationenRückverfolgbarkeit und Audit
CI_Export_CSVAlle Dimensionen konsolidiertDirektimport CI-Plattform
📁
CSV-Export
Zwei Optionen verfügbar
CSV-Dateien werden automatisch im von OUTPUT_DIR angegebenen Verzeichnis nach jeder Script-Ausführung generiert. Sie können sie direkt in Carbon Intelligence importieren oder in Ihre Datenpipeline integrieren.
🔗
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
# Erweiterte Konfigurationsvariablen:

LOOKBACK_DAYS: 90,                                      # Tage des Verlaufs zum Exportieren
MIN_IMPRESSIONS: 1,                                     # Minimaler Impressions-Schwellenwert pro Zeile
REPORT_WAIT_SECONDS: 60,                                # Wartezeit vor Abruf des Berichts
TOKEN_REFRESH_URL: 'https://api.amazon.com/auth/o2/token'
🛠️
Fehlerbehebung
"401 Unauthorized"
Ihr Refresh Token ist abgelaufen oder ungültig. Generieren Sie einen neuen Token in der Amazon Ads Developer Console und aktualisieren Sie REFRESH_TOKEN im Script.
"Profile not found"
Überprüfen Sie, ob Ihre PROFILE_ID in der Amazon Ads Konsole korrekt ist und mit Ihrem DSP-Profil übereinstimmt.
"Report failed"
Der Bericht konnte nicht erstellt werden. Überprüfen Sie den Datumsbereich und reduzieren Sie LOOKBACK_DAYS, falls der Bereich zu groß ist.
"No access"
Überprüfen Sie, ob Ihre Anwendungsberechtigungen und Ihr DSP-Profil Zugriff auf Berichte erlauben. Kontaktieren Sie bei Bedarf Ihren Amazon Ads Account Manager.
"Rate limit"
Die Amazon Ads API begrenzt Anfragen. Warten Sie mindestens 60 Sekunden zwischen Script-Ausführungen, oder erhöhen Sie REPORT_WAIT_SECONDS.
💬
Unterstützung
Email support@carbonintelligence.green
Script-Version 1.0.0
Methodik GMSF v1.2 (Ad Net Zero)