Guía de exportación Google Ads

GMSF v1.2 Google Ads 5 min install
🎯
Objetivo
Este script exporta automáticamente los datos de sus campañas Google Ads con la granularidad necesaria para el análisis de carbono GMSF v1.2 en Carbon Intelligence.
⚙️
Installation
3 pasos · 5 minutos
Crear la hoja de cálculo Google Sheet de destino
  1. Vaya a sheets.new
  2. Renombre el archivo: CI_Export_GoogleAds_[NombreCliente]
  3. Copie la URL del Sheet
Instalar el script
  1. Inicie sesión en Google Ads
  2. Vaya a Herramientas y configuración → Acciones masivas → Scripts
  3. Haga clic en + (Nuevo script)
  4. Nombre el script: Carbon Intelligence Export
  5. Pegue el contenido del archivo carbon-intelligence-google-ads-export.js
  6. Reemplace COLLER_URL_GOOGLE_SHEET_ICI por la URL de su Google Sheet
  7. Haga clic en Autorizar y luego en Ejecutar
Programar la ejecución
  1. Después de la primera ejecución exitosa, haga clic en Crear un programa
  2. Seleccione Semanal (lunes por la mañana recomendado)
  3. El script se ejecutará automáticamente cada semana
📊
Qué se exporta
10 pestañas creadas automáticamente
PestañaContenidoUso Carbon Intelligence
CI_CampaignsResumen por campaña y semanaVisión general de emisiones
CI_DevicePor dispositivo (móvil, escritorio, tableta)Factor de energía por dispositivo
CI_GeoPor país y regiónMix energético por país GMSF v1.2
CI_PlacementsPor sitio y aplicaciónUbicaciones con alto consumo energético
CI_CreativeSizePor tamaño de creatividadPeso de transferencia de datos
CI_AdFormatPor formato (Search, Display, Video)Factor de formato publicitario
CI_VideoDatos de vídeo detalladosCálculo de carbono de vídeo (duración, cuartiles)
CI_MetadataInformación de cuenta y exportaciónTrazabilidad y auditoría
CI_DiagnosticPruebas de cada consultaIdentificación de problemas
CI_Export_CSVTodas las dimensiones consolidadasImportación directa a la plataforma CI
📁
Exportar CSV
Dos opciones disponibles
Opción A — Desde Google Sheets
  1. Vaya a la pestaña CI_Export_CSV
  2. Archivo → Descargar → CSV (.csv)
Opción B — Mediante el script
  1. Cambie la función a exportToCSV
  2. Ejecute — se creará un archivo CSV en su Google Drive
  3. El enlace del archivo aparece en los logs
🔗
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.
⚠️
Dimensiones no cubiertas
DimensionPor quéAlternative
Tipo de conexión (Wi-Fi/4G/5G)No disponible en Google AdsDisponible mediante DV360 o TTD
Exchange (SSP)Google Ads = walled gardenDisponible mediante DV360 o TTD
Modo de compra (Open/PMP)Específico del programático openDisponible mediante DV360 o TTD
Peso creativo (KB)No reportado por Google AdsEstimación GMSF por tipo de formato
Active View / ViewabilityEn proceso de sunset en GoogleMétricas eliminadas en v1.2.0
Si utiliza DV360 u otro DSP, contáctenos para un script dedicado.
🔧
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
INCLUDE_PAUSED: true     // Incluir campañas en pausa (recomendado)
🔍
Diagnóstico
Función de diagnóstico integrada
  1. En Google Ads > Scripts, abra el script
  2. En el menú desplegable junto a Ejecutar, seleccione diagnose
  3. Haga clic en Ejecutar
  4. Abra el Google Sheet y vaya a la pestaña CI_Diagnostic

El diagnóstico prueba: acceso a la cuenta de Google Ads, cada tipo de consulta individualmente, número de campañas activas y en pausa, disponibilidad de datos por tipo (Device, Geo, Placements, Video...). Cada prueba está coloreada: verde (OK), amarillo (vacío pero normal), rojo (error). En caso de error, envíe una captura de la pestaña CI_Diagnostic a support@carbonintelligence.green.

🛠️
Solución de problemas
"Authorization required"
Normal en la primera ejecución. Haga clic en Autorizar y acepte los permisos.
"Spreadsheet not found"
Verifique que la URL del Google Sheet sea correcta en CONFIG.SPREADSHEET_URL.
Columnas vacías (todas)
Ejecute la función diagnose (menú desplegable junto a Ejecutar > seleccione "diagnose"). Luego consulte la pestaña CI_Diagnostic en el Google Sheet que identifica el problema exacto.
Campañas en pausa
Si sus campañas están en pausa, el script no exporta datos por defecto. En v1.2.0, INCLUDE_PAUSED está en true por defecto. Para versiones anteriores, cambie INCLUDE_PAUSED: true en la sección CONFIG.
Datos faltantes
Verifique que las campañas tengan impresiones para el período. Ajuste LOOKBACK_DAYS si es necesario.
Timeout
Si la cuenta tiene muchos datos, reduzca LOOKBACK_DAYS a 30 días.
Pestañas vacías
Algunas pestañas (Video, Placements) solo se llenan si los tipos de campaña correspondientes están activos.
💬
Soporte
Email support@carbonintelligence.green
Versión del script 1.3.0
Metodología GMSF v1.2 (Ad Net Zero)