Guía de exportación Meta Ads — Script Python

GMSF v1.2 Meta Ads 10 min install
🎯
Objetivo
Este script Python exporta los datos de campañas de Meta Ads (Facebook, Instagram, Audience Network, Messenger) con granularidad GMSF v1.2 para Carbon Intelligence™. Meta ofrece una granularidad única en placements (Feed, Stories, Reels) y dispositivos reales de impresión, esenciales para un cálculo de carbono preciso.
⚙️
Installation
3 pasos · 10 minutos
Requisitos previos
  1. Python 3.8+ instalado en su máquina
  2. Instalar dependencias: pip install requests pandas
  3. Crear una Meta App en developers.facebook.com
  4. Obtener un Access Token de larga duración con permisos ads_read y ads_management
  5. Anotar su Ad Account ID (formato: act_XXXXXXXXX)
Configurar el script
  1. Abrir el archivo: carbon-intelligence-meta-ads-export.py
  2. Completar las variables: ACCESS_TOKEN, AD_ACCOUNT_ID
  3. Configurar OUTPUT_DIR (carpeta de destino de los CSV)
  4. Opcional: Definir las variables de entorno CI_META_ACCESS_TOKEN y CI_META_AD_ACCOUNT_ID en lugar de codificar directamente
Ejecutar
  1. Ejecutar el script: python carbon-intelligence-meta-ads-export.py
  2. Los archivos CSV se generan en OUTPUT_DIR
  3. Programar la ejecución mediante cron (semanal recomendado)
📊
Qué se exporta
10 pestañas creadas automáticamente
PestañaContenidoUso Carbon Intelligence
CI_CampaignsPor campaña + semana: impresiones, alcance, frecuencia, gasto, ROASResumen de campañas
CI_DevicePor dispositivo (móvil, desktop, tableta)Factor energético por dispositivo
CI_GeoPor paísMix energético por país GMSF v1.2
CI_PlacementsPor plataforma x posición: Feed, Stories, Reels, Right Column🎯 Específico Meta — Granularidad Feed/Stories/Reels
CI_CreativeSizePor anuncio con dimensiones creativasPeso de transferencia de datos
CI_AdFormatPor publisher_platformFactor de formato publicitario
CI_VideoCuartiles de vídeo (p25, p50, p75, p100), duración mediaCálculo de carbono de vídeo
CI_ImpDevicePor dispositivo real: iPhone, iPad, Android, Desktop🔴 Crítico Carbono — dispositivo realmente utilizado
CI_MetadataInformación de cuenta y exportación (marca de tiempo, versión API)Trazabilidad y auditoría
CI_Export_CSVTodas las dimensiones consolidadas en planoImportación directa plataforma CI
📁
Exportar CSV
Dos opciones disponibles
La pestaña CI_Export_CSV contiene todas las dimensiones aplanadas, listas para la importación directa en la plataforma Carbon Intelligence™. Los archivos CSV se generan automáticamente en OUTPUT_DIR con cada ejecución del script.
🔗
Compartir con Carbon Intelligence™
📨
Comparta el Google Sheet con: support@carbonintelligence.green (accès lecteur)
O envíe el CSV exportado por email a la misma dirección.
🔧
Configuración avanzada
Sección CONFIG del script
# En el script, sección CONFIG:

LOOKBACK_DAYS: 90,          # Días de historial (por defecto: 90)
MIN_IMPRESSIONS: 1,         # Umbral mínimo de impresiones por fila
API_VERSION: 'v19.0'        # Versión de la API Meta (actualizada regularmente)
🛠️
Solución de problemas
OAuthException
Access Token expirado. Genere un nuevo token de larga duración en developers.facebook.com con los permisos requeridos.
"Error validating access token"
Verifique que el Access Token tenga los permisos ads_read y ads_management en su Meta App.
"Ad Account not found"
Verifique el formato de su Ad Account ID: act_XXXXXXXXX (con el prefijo act_).
"Rate limit exceeded"
El script gestiona automáticamente los reintentos exponenciales. Si persiste, reduzca LOOKBACK_DAYS a 30 o 60 días.
Datos de vídeo vacíos
Normal si no hay campaña de vídeo activa para el período. La pestaña CI_Video solo se llena cuando hay impresiones de vídeo.
💬
Soporte
Email support@carbonintelligence.green
Sitio web carbonintelligence.green
Versión del script 1.0.0
Metodología GMSF v1.2 (Ad Net Zero)
Carbon Intelligence™ — Guía de instalación Meta Ads — v1.0.0
ISO 14064 GHG Protocol ADEME Base Carbone GMSF v1.2 Ad Net Zero