Meta Ads Export-Anleitung — Python Script

GMSF v1.2 Meta Ads 10 min install
🎯
Ziel
Dieses Python-Script exportiert die Kampagnendaten von Meta Ads (Facebook, Instagram, Audience Network, Messenger) mit GMSF v1.2-Granularität für Carbon Intelligence™. Meta bietet einzigartige Granularität bei Placements (Feed, Stories, Reels) und tatsächlichen Impressions-Geräten, die für eine präzise CO2-Berechnung unerlässlich sind.
⚙️
Installation
3 Schritte · 10 Minuten
Voraussetzungen
  1. Python 3.8+ auf Ihrem Rechner installiert
  2. Abhängigkeiten installieren: pip install requests pandas
  3. Eine Meta App auf developers.facebook.com erstellen
  4. Einen langlebigen Access Token mit ads_read- und ads_management-Berechtigungen erhalten
  5. Ihre Ad Account ID notieren (Format: act_XXXXXXXXX)
Script konfigurieren
  1. Datei öffnen: carbon-intelligence-meta-ads-export.py
  2. Variablen ausfüllen: ACCESS_TOKEN, AD_ACCOUNT_ID
  3. OUTPUT_DIR konfigurieren (CSV-Zielordner)
  4. Optional: Umgebungsvariablen CI_META_ACCESS_TOKEN und CI_META_AD_ACCOUNT_ID anstelle von Hardcoding setzen
Ausführen
  1. Script ausführen: python carbon-intelligence-meta-ads-export.py
  2. CSV-Dateien werden in OUTPUT_DIR generiert
  3. Ausführung über cron planen (wöchentlich empfohlen)
📊
Was exportiert wird
10 Tabs automatisch erstellt
TabInhaltVerwendung Carbon Intelligence
CI_CampaignsNach Kampagne + Woche: Impressions, Reichweite, Frequenz, Ausgaben, ROASKampagnenübersicht
CI_DeviceNach Gerät (Mobil, Desktop, Tablet)Energiefaktor pro Gerät
CI_GeoNach LandGMSF v1.2 Energiemix nach Land
CI_PlacementsNach Plattform x Position: Feed, Stories, Reels, Right Column🎯 Meta-spezifisch — Feed/Stories/Reels-Granularität
CI_CreativeSizeNach Anzeige mit Creative-DimensionenDatentransfergewicht
CI_AdFormatNach publisher_platformAnzeigenformatfaktor
CI_VideoVideo-Quartile (p25, p50, p75, p100), durchschnittliche DauerVideo-CO2-Berechnung
CI_ImpDeviceNach realem Gerät: iPhone, iPad, Android, Desktop🔴 CO2-kritisch — tatsächlich verwendetes Gerät
CI_MetadataKonto- und Exportinformationen (Zeitstempel, API-Version)Rückverfolgbarkeit und Audit
CI_Export_CSVAlle Dimensionen konsolidiert flachDirektimport CI-Plattform
📁
CSV-Export
Zwei Optionen verfügbar
Der CI_Export_CSV-Tab enthält alle Dimensionen flach, bereit für den Direktimport in die Carbon Intelligence™-Plattform. CSV-Dateien werden automatisch in OUTPUT_DIR bei jeder Script-Ausführung generiert.
🔗
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 der Historie (Standard: 90)
MIN_IMPRESSIONS: 1,         # Minimaler Impressions-Schwellenwert pro Zeile
API_VERSION: 'v19.0'        # Meta API-Version (regelmäßig aktualisiert)
🛠️
Fehlerbehebung
OAuthException
Access Token abgelaufen. Generieren Sie einen neuen langlebigen Token auf developers.facebook.com mit den erforderlichen Berechtigungen.
"Error validating access token"
Überprüfen Sie, dass der Access Token die Berechtigungen ads_read und ads_management für Ihre Meta App besitzt.
"Ad Account not found"
Überprüfen Sie das Format Ihrer Ad Account ID: act_XXXXXXXXX (mit dem Präfix act_).
"Rate limit exceeded"
Das Script handhabt automatisch exponentielle Wiederholungsversuche. Falls anhaltend, reduzieren Sie LOOKBACK_DAYS auf 30 oder 60 Tage.
Leere Videodaten
Normal, wenn keine Videokampagne für den Zeitraum aktiv ist. Der CI_Video-Tab wird nur bei Video-Impressions gefüllt.
💬
Unterstützung
Email support@carbonintelligence.green
Webseite carbonintelligence.green
Script-Version 1.0.0
Methodik GMSF v1.2 (Ad Net Zero)
Carbon Intelligence™ — Installationsanleitung Meta Ads — v1.0.0
ISO 14064 GHG Protocol ADEME Base Carbone GMSF v1.2 Ad Net Zero