Guide d'export Meta Ads — Script Python

GMSF v1.2 Meta Ads 10 min install
🎯
Objectif
Ce script Python exporte les données de campagnes Meta Ads (Facebook, Instagram, Audience Network, Messenger) avec la granularité GMSF v1.2 pour Carbon Intelligence™. Meta offre une granularité unique sur les placements (Feed, Stories, Reels) et les devices réels d'impression, essentiels pour un calcul carbone précis.
⚙️
Installation
3 étapes · 10 minutes
Prérequis
  1. Python 3.8+ installé sur votre machine
  2. Installer les dépendances : pip install requests pandas
  3. Créer une Meta App sur developers.facebook.com
  4. Obtenir un Access Token longue durée avec les permissions ads_read et ads_management
  5. Noter votre Ad Account ID (format : act_XXXXXXXXX)
Configurer le script
  1. Ouvrir le fichier : carbon-intelligence-meta-ads-export.py
  2. Renseigner les variables : ACCESS_TOKEN, AD_ACCOUNT_ID
  3. Configurer OUTPUT_DIR (dossier de destination des CSV)
  4. Optionnel : Définir les variables d'environnement CI_META_ACCESS_TOKEN et CI_META_AD_ACCOUNT_ID au lieu de coder en dur
Exécuter
  1. Lancer le script : python carbon-intelligence-meta-ads-export.py
  2. Les fichiers CSV sont générés dans OUTPUT_DIR
  3. Planifier l'exécution via cron (hebdomadaire recommandé)
📊
Ce qui est exporté
10 onglets créés automatiquement
OngletContenuUsage Carbon Intelligence
CI_CampaignsPar campagne + semaine : impressions, reach, fréquence, dépenses, ROASVue d'ensemble des campagnes
CI_DevicePar appareil (mobile, desktop, tablette)Facteur énergétique par appareil
CI_GeoPar paysMix énergétique pays GMSF v1.2
CI_PlacementsPar plateforme x position : Feed, Stories, Reels, Right Column🎯 Spécifique Meta — Granularité Feed/Stories/Reels
CI_CreativeSizePar annonce avec dimensions créativesPoids du transfert de données
CI_AdFormatPar publisher_platformFacteur de format publicitaire
CI_VideoQuartiles vidéo (p25, p50, p75, p100), durée moyenneCalcul carbone vidéo
CI_ImpDevicePar appareil réel : iPhone, iPad, Android, Desktop🔴 Critique Carbone — appareil réellement utilisé
CI_MetadataInformations de compte et d'export (horodatage, version API)Traçabilité et audit
CI_Export_CSVToutes les dimensions consolidées à platImport direct plateforme CI
📁
Export CSV
Deux options disponibles
L'onglet CI_Export_CSV contient toutes les dimensions aplaties, prêtes pour l'import direct dans la plateforme Carbon Intelligence™. Les fichiers CSV sont automatiquement générés dans OUTPUT_DIR à chaque exécution du script.
🔗
Partage avec Carbon Intelligence™
📨
Partagez le Google Sheet avec : support@carbonintelligence.green (accès lecteur)
Ou envoyez le CSV exporté par email à la même adresse.
🔧
Configuration avancée
Section CONFIG du script
# Dans le script, section CONFIG :

LOOKBACK_DAYS: 90,          # Jours d'historique (défaut : 90)
MIN_IMPRESSIONS: 1,         # Seuil minimum d'impressions par ligne
API_VERSION: 'v19.0'        # Version de l'API Meta (mise à jour régulièrement)
🛠️
Résolution de problèmes
OAuthException
Access Token expiré. Générez un nouveau token longue durée sur developers.facebook.com avec les permissions requises.
"Error validating access token"
Vérifiez que l'Access Token possède les permissions ads_read et ads_management sur votre Meta App.
"Ad Account not found"
Vérifiez le format de votre Ad Account ID : act_XXXXXXXXX (avec le préfixe act_).
"Rate limit exceeded"
Le script gère automatiquement les retries exponentiels. Si le problème persiste, réduisez LOOKBACK_DAYS à 30 ou 60 jours.
Données vidéo vides
Normal si aucune campagne vidéo n'est active pour la période. L'onglet CI_Video ne se remplit que lorsqu'il y a des impressions vidéo.
💬
Support
Email support@carbonintelligence.green
Site web carbonintelligence.green
Version script 1.0.0
Méthodologie GMSF v1.2 (Ad Net Zero)
Carbon Intelligence™ — Guide d'installation Meta Ads — v1.0.0
ISO 14064 GHG Protocol ADEME Base Carbone GMSF v1.2 Ad Net Zero