Guida all'esportazione Meta Ads — Script Python

GMSF v1.2 Meta Ads 10 min install
🎯
Obiettivo
Questo script Python esporta i dati delle campagne Meta Ads (Facebook, Instagram, Audience Network, Messenger) con granularità GMSF v1.2 per Carbon Intelligence™. Meta offre una granularità unica sui placements (Feed, Stories, Reels) e sui dispositivi reali di impressione, essenziali per un calcolo preciso del carbonio.
⚙️
Installation
3 passaggi · 10 minuti
Prerequisiti
  1. Python 3.8+ installato sulla propria macchina
  2. Installare le dipendenze: pip install requests pandas
  3. Creare una Meta App su developers.facebook.com
  4. Ottenere un Access Token a lunga durata con i permessi ads_read e ads_management
  5. Annotare il proprio Ad Account ID (formato: act_XXXXXXXXX)
Configurare lo script
  1. Aprire il file: carbon-intelligence-meta-ads-export.py
  2. Compilare le variabili: ACCESS_TOKEN, AD_ACCOUNT_ID
  3. Configurare OUTPUT_DIR (cartella di destinazione dei CSV)
  4. Opzionale: Impostare le variabili d'ambiente CI_META_ACCESS_TOKEN e CI_META_AD_ACCOUNT_ID invece della codifica diretta
Eseguire
  1. Eseguire lo script: python carbon-intelligence-meta-ads-export.py
  2. I file CSV vengono generati in OUTPUT_DIR
  3. Pianificare l'esecuzione tramite cron (settimanale consigliato)
📊
Cosa viene esportato
10 schede create automaticamente
SchedaContenutoUtilizzo Carbon Intelligence
CI_CampaignsPer campagna + settimana: impressioni, copertura, frequenza, spesa, ROASPanoramica delle campagne
CI_DevicePer dispositivo (mobile, desktop, tablet)Fattore energetico per dispositivo
CI_GeoPer paeseMix energetico per paese GMSF v1.2
CI_PlacementsPer piattaforma x posizione: Feed, Stories, Reels, Right Column🎯 Specifico Meta — Granularità Feed/Stories/Reels
CI_CreativeSizePer annuncio con dimensioni creativePeso del trasferimento dati
CI_AdFormatPer publisher_platformFattore formato pubblicitario
CI_VideoQuartili video (p25, p50, p75, p100), durata mediaCalcolo del carbonio video
CI_ImpDevicePer dispositivo reale: iPhone, iPad, Android, Desktop🔴 Critico Carbonio — dispositivo effettivamente utilizzato
CI_MetadataInformazioni account ed esportazione (timestamp, versione API)Tracciabilità e audit
CI_Export_CSVTutte le dimensioni consolidate in pianoImportazione diretta piattaforma CI
📁
Esportazione CSV
Due opzioni disponibili
La scheda CI_Export_CSV contiene tutte le dimensioni appiattite, pronte per l'importazione diretta nella piattaforma Carbon Intelligence™. I file CSV vengono generati automaticamente in OUTPUT_DIR ad ogni esecuzione dello script.
🔗
Condivisione con Carbon Intelligence™
📨
Condividi il Google Sheet con: support@carbonintelligence.green (accès lecteur)
Oppure invia il CSV esportato per email allo stesso indirizzo.
🔧
Configurazione avanzata
Sezione CONFIG dello script
# Nello script, sezione CONFIG:

LOOKBACK_DAYS: 90,          # Giorni di storico (predefinito: 90)
MIN_IMPRESSIONS: 1,         # Soglia minima di impressioni per riga
API_VERSION: 'v19.0'        # Versione API Meta (aggiornata regolarmente)
🛠️
Risoluzione dei problemi
OAuthException
Access Token scaduto. Generare un nuovo token a lunga durata su developers.facebook.com con i permessi richiesti.
"Error validating access token"
Verificare che l'Access Token abbia i permessi ads_read e ads_management sulla propria Meta App.
"Ad Account not found"
Verificare il formato del proprio Ad Account ID: act_XXXXXXXXX (con il prefisso act_).
"Rate limit exceeded"
Lo script gestisce automaticamente i retry esponenziali. Se persiste, ridurre LOOKBACK_DAYS a 30 o 60 giorni.
Dati video vuoti
Normale se nessuna campagna video è attiva per il periodo. La scheda CI_Video si riempie solo quando ci sono impressioni video.
💬
Supporto
Email support@carbonintelligence.green
Sito web carbonintelligence.green
Versione script 1.0.0
Metodologia GMSF v1.2 (Ad Net Zero)
Carbon Intelligence™ — Guida all'installazione Meta Ads — v1.0.0
ISO 14064 GHG Protocol ADEME Base Carbone GMSF v1.2 Ad Net Zero