Carbon Intelligence™
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
- Python 3.8+ auf Ihrem Rechner installiert
- Abhängigkeiten installieren:
pip install requests pandas - Eine Anwendung in der Amazon Ads Developer Console erstellen
- Ihre Zugangsdaten beziehen: Client ID, Client Secret, Refresh Token
- Ihre DSP Profile ID in der Amazon Ads Konsole identifizieren
Konfigurieren
- Die Datei
carbon-intelligence-amazon-dsp-export.pyöffnen - 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
- •
- Das Ausgabeverzeichnis in
OUTPUT_DIRfestlegen
Ausführen
- Das Script ausführen:
python carbon-intelligence-amazon-dsp-export.py - Die exportierten Daten erscheinen in
OUTPUT_DIR - Regelmäßige Ausführung planen über
cron(Linux/macOS) oder Aufgabenplanung (Windows)
Was exportiert wird
11 Tabs automatisch erstellt
| Tab | Inhalt | Verwendung Carbon Intelligence |
|---|---|---|
| CI_Campaigns | Nach Order/Line Item + Woche | Emissionsübersicht |
| CI_Device | Desktop, Mobil, Tablet, CTV, Fire Tablet | Energiefaktor pro Gerät |
| CI_Geo | Nach Land und Region | GMSF v1.2 Länder-Energiemix |
| CI_Placements | Nach Inventarquelle | Energieintensive Platzierungen |
| CI_CreativeSize | Nach Creative-Größe | Datentransfergewicht |
| CI_AdFormat | Display, Video, OLV, STV, Audio (Amazon-Formate) | Anzeigenformat-Faktor |
| CI_Video | Detaillierte Videodaten (Dauer, Quartile) | Video-Kohlenstoffberechnung |
| CI_SupplySource | Amazon-Inventar vs Drittanbieter | 🎯 Amazon DSP-spezifisch |
| CI_Environment | Auslieferungskontext | Auslieferungsparameter |
| CI_Metadata | Konto- und Exportinformationen | Rückverfolgbarkeit und Audit |
| CI_Export_CSV | Alle Dimensionen konsolidiert | Direktimport 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™
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'
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
Webseite
carbonintelligence.green
Script-Version
1.0.0
Methodik
GMSF v1.2 (Ad Net Zero)