Carbon Intelligence™
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
- Vaya a sheets.new
- Renombre el archivo:
CI_Export_GoogleAds_[NombreCliente] - Copie la URL del Sheet
Instalar el script
- Inicie sesión en Google Ads
- Vaya a Herramientas y configuración → Acciones masivas → Scripts
- Haga clic en + (Nuevo script)
- Nombre el script:
Carbon Intelligence Export - Pegue el contenido del archivo
carbon-intelligence-google-ads-export.js - Reemplace
COLLER_URL_GOOGLE_SHEET_ICIpor la URL de su Google Sheet - Haga clic en Autorizar y luego en Ejecutar
Programar la ejecución
- Después de la primera ejecución exitosa, haga clic en Crear un programa
- Seleccione Semanal (lunes por la mañana recomendado)
- El script se ejecutará automáticamente cada semana
Qué se exporta
10 pestañas creadas automáticamente
| Pestaña | Contenido | Uso Carbon Intelligence |
|---|---|---|
| CI_Campaigns | Resumen por campaña y semana | Visión general de emisiones |
| CI_Device | Por dispositivo (móvil, escritorio, tableta) | Factor de energía por dispositivo |
| CI_Geo | Por país y región | Mix energético por país GMSF v1.2 |
| CI_Placements | Por sitio y aplicación | Ubicaciones con alto consumo energético |
| CI_CreativeSize | Por tamaño de creatividad | Peso de transferencia de datos |
| CI_AdFormat | Por formato (Search, Display, Video) | Factor de formato publicitario |
| CI_Video | Datos de vídeo detallados | Cálculo de carbono de vídeo (duración, cuartiles) |
| CI_Metadata | Información de cuenta y exportación | Trazabilidad y auditoría |
| CI_Diagnostic | Pruebas de cada consulta | Identificación de problemas |
| CI_Export_CSV | Todas las dimensiones consolidadas | Importación directa a la plataforma CI |
Exportar CSV
Dos opciones disponibles
Opción A — Desde Google Sheets
- Vaya a la pestaña CI_Export_CSV
- Archivo → Descargar → CSV (.csv)
Opción B — Mediante el script
- Cambie la función a
exportToCSV - Ejecute — se creará un archivo CSV en su Google Drive
- El enlace del archivo aparece en los logs
Compartir con Carbon Intelligence™
Dimensiones no cubiertas
| Dimension | Por qué | Alternative |
|---|---|---|
| Tipo de conexión (Wi-Fi/4G/5G) | No disponible en Google Ads | Disponible mediante DV360 o TTD |
| Exchange (SSP) | Google Ads = walled garden | Disponible mediante DV360 o TTD |
| Modo de compra (Open/PMP) | Específico del programático open | Disponible mediante DV360 o TTD |
| Peso creativo (KB) | No reportado por Google Ads | Estimación GMSF por tipo de formato |
| Active View / Viewability | En proceso de sunset en Google | Mé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)
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
- En Google Ads > Scripts, abra el script
- En el menú desplegable junto a Ejecutar, seleccione diagnose
- Haga clic en Ejecutar
- 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
Sitio web
carbonintelligence.green
Versión del script
1.3.0
Metodología
GMSF v1.2 (Ad Net Zero)