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
  1. Python 3.8+ instalado en su máquina
  2. Instalar dependencias: pip install google-api-python-client google-auth pandas
  3. Crear una cuenta de servicio en Google Cloud Console
  4. Habilitar la API DV360 Reporting en su proyecto Cloud
  5. Descargar el archivo JSON de la cuenta de servicio (clave privada)
Configurar el script
  1. Abrir carbon-intelligence-dv360-export.py
  2. En la sección CONFIG, completar:
    • SERVICE_ACCOUNT_PATH: ruta al JSON descargado
    • ADVERTISER_ID: su ID de anunciante DV360
  3. Opcional: configurar SPREADSHEET_URL para exportar a Google Sheets
  4. Opcional: configurar OUTPUT_DIR para la exportación CSV local
Ejecutar el script
  1. Ejecutar: python carbon-intelligence-dv360-export.py
  2. Para programar la ejecución:
    • Linux/Mac: usar cron (ej.: 0 9 * * 1 = lunes 9h)
    • Windows: usar el Programador de tareas
  3. Recomendado: ejecución semanal el lunes por la mañana
📊
Qué se exporta
12 pestañas creadas automáticamente
PestañaContenidoUso Carbon Intelligence
CI_CampaignsPor orden de inserción y semanaResumen de emisiones
CI_DevicePor dispositivo (desktop, móvil, tableta, CTV)Factor energético
CI_GeoPor país y regiónMix energético GMSF v1.2
CI_PlacementsPor sitio/app y dominioUbicaciones de alto consumo
CI_CreativeSizePor dimensiones creativasPeso de transferencia de datos
CI_AdFormatPor formato (Display, Video, Native, Audio, Rich Media)Factor de formato
CI_VideoMétricas de vídeo detalladas (duración, cuartiles)Cálculo de carbono de vídeo
CI_ExchangePor exchange (Google, Index, OpenX, etc.)🎯 Exclusivo DV360
CI_ConnectionPor tipo de conexión (WiFi, 4G, 5G)🎯 Exclusivo DV360
CI_EnvironmentPor entorno (Web, App, CTV)🎯 Exclusivo DV360
CI_MetadataInformación de exportación y cuentaTrazabilidad
CI_Export_CSVTodas las dimensiones consolidadasImportación directa CI
📁
Exportar CSV
Dos opciones disponibles
Opción A — CSV automático
El script genera automáticamente archivos CSV en OUTPUT_DIR
Opción B — Google Sheets
Configurar SPREADSHEET_URL para exportación directa
🔗
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.
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
🛠️
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
Versión del script 1.0.0
Metodología GMSF v1.2 (Ad Net Zero)