Carbon Intelligence™
Guía de exportación DV360 — Script Python
GMSF v1.2
DV360
10 min install
Objetivo
Este script Python exporta automáticamente los datos de sus campañas DV360 con la máxima granularidad para el análisis de carbono GMSF v1.2 en Carbon Intelligence™. DV360 ofrece dimensiones exclusivas no disponibles en Google Ads: tipo de conexión, exchange, entorno y modo de compra.
Installation
3 pasos · 10 minutos
Requisitos previos
- Python 3.8+ instalado en su máquina
- Instalar dependencias:
pip install google-api-python-client google-auth pandas - Crear una cuenta de servicio en Google Cloud Console
- Habilitar la API DV360 Reporting en su proyecto Cloud
- Descargar el archivo JSON de la cuenta de servicio (clave privada)
Configurar el script
- Abrir
carbon-intelligence-dv360-export.py - En la sección CONFIG, completar:
- •
SERVICE_ACCOUNT_PATH: ruta al JSON descargado - •
ADVERTISER_ID: su ID de anunciante DV360
- •
- Opcional: configurar
SPREADSHEET_URLpara exportar a Google Sheets - Opcional: configurar
OUTPUT_DIRpara la exportación CSV local
Ejecutar el script
- Ejecutar:
python carbon-intelligence-dv360-export.py - Para programar la ejecución:
- • Linux/Mac: usar
cron(ej.:0 9 * * 1= lunes 9h) - • Windows: usar el Programador de tareas
- • Linux/Mac: usar
- Recomendado: ejecución semanal el lunes por la mañana
Qué se exporta
12 pestañas creadas automáticamente
| Pestaña | Contenido | Uso Carbon Intelligence |
|---|---|---|
| CI_Campaigns | Por orden de inserción y semana | Resumen de emisiones |
| CI_Device | Por dispositivo (desktop, móvil, tableta, CTV) | Factor energético |
| CI_Geo | Por país y región | Mix energético GMSF v1.2 |
| CI_Placements | Por sitio/app y dominio | Ubicaciones de alto consumo |
| CI_CreativeSize | Por dimensiones creativas | Peso de transferencia de datos |
| CI_AdFormat | Por formato (Display, Video, Native, Audio, Rich Media) | Factor de formato |
| CI_Video | Métricas de vídeo detalladas (duración, cuartiles) | Cálculo de carbono de vídeo |
| CI_Exchange | Por exchange (Google, Index, OpenX, etc.) | 🎯 Exclusivo DV360 |
| CI_Connection | Por tipo de conexión (WiFi, 4G, 5G) | 🎯 Exclusivo DV360 |
| CI_Environment | Por entorno (Web, App, CTV) | 🎯 Exclusivo DV360 |
| CI_Metadata | Información de exportación y cuenta | Trazabilidad |
| CI_Export_CSV | Todas las dimensiones consolidadas | Importación directa CI |
Exportar CSV
Dos opciones disponibles
Opción A — CSV automático
El script genera automáticamente archivos CSV en
OUTPUT_DIROpción B — Google Sheets
Configurar
SPREADSHEET_URL para exportación directaCompartir con Carbon Intelligence™
Ventajas vs Google Ads
Dimensiones exclusivas DV360
Tipo de conexión (WiFi/4G/5G) — no disponible en Google Ads
Exchanges múltiples — no disponible en Google Ads
Modo de compra (Open/PMP/PG) — no disponible en Google Ads
Entorno (Web/App/CTV) — no disponible en Google Ads
Configuración avanzada
Sección CONFIG del script
# En el script, sección CONFIG:
LOOKBACK_DAYS: 90, # Días de historial
MIN_IMPRESSIONS: 10, # Umbral mínimo
INCLUDE_PAUSED: False, # Campañas en pausa
OUTPUT_FORMAT: 'csv', # csv o sheets
LOOKBACK_DAYS: 90, # Días de historial
MIN_IMPRESSIONS: 10, # Umbral mínimo
INCLUDE_PAUSED: False, # Campañas en pausa
OUTPUT_FORMAT: 'csv', # csv o sheets
Solución de problemas
"Authentication failed"
Verifique la ruta al archivo JSON de la cuenta de servicio en
SERVICE_ACCOUNT_PATH."API not enabled"
Habilite la API DV360 Reporting en Google Cloud Console para su proyecto.
"Advertiser not found"
Verifique el ID de anunciante en
ADVERTISER_ID — debe coincidir con su cuenta DV360.Timeout
Reduzca
LOOKBACK_DAYS a 30 días si la API tarda demasiado."No data"
Verifique que existan campañas activas para el período. Aumente
LOOKBACK_DAYS si es necesario.Soporte
Email
support@carbonintelligence.green
Sitio web
carbonintelligence.green
Versión del script
1.0.0
Metodología
GMSF v1.2 (Ad Net Zero)