Carbon Intelligence · Conecta tus datos

Nuestra plataforma ha sido diseñada para integrarse de forma nativa con todos los DSP y plataformas publicitarias del ecosistema adtech global. Esta guía le acompaña paso a paso para conectar sus plataformas publicitarias a Carbon Intelligence™ — en solo unos minutos.

1 Exportar Extraiga datos de su DSP
2 Upload Enviar a Carbon Intelligence
3 Analizar Vea las emisiónes por impresión

Display & Video 360

El DSP programático de Google — la fuente de datos más rica para el análisis de carbono con acceso exclusivo a las dimensiones de tipo de conexión, exchange y entorno.

DV360 API v4 Dimensiones exclusivas GMSF v1.2

Dimensiones disponibles

Campaign
IO, Line Item, Creative
Device
Desktop, Mobile, Tablet, CTV
Geography
Country, Region, City
Placements
Sites, Apps, URLs
Creative Size
Width × Height, Rich Media
Ad Format
Display, Video, Native, Audio
★ Exchange
SSP / inventory source
★ Connection Type
WiFi, 4G, 5G, Carrier
★ Environment
Web, In-App, CTV
1
Crear un informe

En DV360, vaya a Reporting → Create Report.

2
Agregar dimensiones

Seleccione las dimensiones listadas arriba — incluya Exchange, Connection Type y Environment para la maxima granularidad.

3
Agregar metricas

Agregue Impressions, Clicks, Total Media Cost y cualquier otro KPI que monitoree.

4
Ejecutar y exportar CSV

Ejecute el informe y descarguelo como archivo CSV.

5
Cargar en Carbon Intelligence

Arrastre y suelte el CSV en la plataforma Carbon Intelligence — sus datos de emisiónes estaran listos en segundos.

💡 Consejo: Incluir las dimensiones Environment + Connection Type le proporciona la huella de carbono más precisa — son exclusivas de DV360 e impactan directamente los cálculos de energia por impresión.
1
Instalar Python y dependencias

Asegurese de que Python 3.8+ este instalado. Ejecute pip install google-api-python-client google-auth.

2
Crear una cuenta de servicio

En Google Cloud Console, cree una cuenta de servicio con acceso a la API de DV360 y el alcance Display & Video 360.

3
Descargar la clave JSON

Descargue el archivo de clave de la cuenta de servicio y guardelo de forma segura. Referenciara esta ruta en el script.

4
Configurar el script

Abra el script y configure su ADVERTISER_ID, la ruta KEY_FILE y el rango de fechas deseado.

5
Ejecutar el script

Ejecute python carbon-intelligence-dv360-export.py. El script extraera los datos a traves de la API de DV360 y generara un CSV listo para cargar.

6
Programar ejecuciónes semanales

Use cron (Linux/Mac) o el Programador de tareas (Windows) para automatizar las extracciónes semanales.

1
Habilitar BigQuery Data Transfer

En Google Cloud Console, habilite el servicio BigQuery Data Transfer para su proyecto.

2
Crear una configuración de transferencia DV360

Configure una transferencia programada de DV360 a BigQuery, seleccionando los IDs de anunciante y las dimensiones que necesita.

3
Configurar el dataset de destino

Cree o seleccione un dataset de BigQuery para recibir los datos de DV360. Establezca la region y las politicas de expiracion adecuadas.

4
Conectar BigQuery a Carbon Intelligence

En Carbon Intelligence, agregue una fuente de datos BigQuery y autentiquese con sus credenciales de Google Cloud.

5
Mapear tablas y programar sincronizaciónes

Seleccione las tablas para sincronizar y establezca la frecuencia de actualizacion. Los datos fluirán automáticamente a su panel de carbono.

🏢 Granularidad maxima: BigQuery Data Transfer conserva todas las dimensiones de DV360, incluidos los campos exclusivos Exchange, Connection Type y Environment — proporcionandole los cálculos de emisiónes más precisos posibles.

Google Ads

Search, Display, Video, Performance Max — la plataforma publicitaria más utilizada. Los Google Ads Scripts nativos hacen que la automatización sea perfecta.

Google Ads Scripts BigQuery Transfer GMSF v1.2

Dimensiones disponibles

Campaign
Name, ID, type, bidding
Device
Mobile, Desktop, Tablet
Geography
Country, Region
Placements
Sites, Apps, URLs
Creative Size
Ad type, image dimensions
Ad Format
Search, Display, Video, Discovery
Video
Duration, quartiles, view rate
No disponible
Connection type, Exchange, Buy type
1
Abrir informes de Google Ads

Navegue a Reports → Predefined reports en su cuenta de Google Ads.

2
Seleccionar dimensiones

Agregue las dimensiones Campaign, Device, Geography, Placements, Creative Size y Ad Format.

3
Agregar metricas

Incluya Impressions, Clicks, Cost y cualquier otra metrica que monitoree.

4
Descargar CSV

Ejecute el informe y descarguelo como archivo CSV.

5
Cargar en Carbon Intelligence

Arrastre y suelte el CSV en la plataforma Carbon Intelligence.

Los Google Ads Scripts se ejecutan de forma nativa dentro de Google Ads — no se requiere configuración local. El script exporta datos a un Google Sheet, que luego puede descargar o conectar directamente.

1
Abrir Google Ads Scripts

En Google Ads, navegue a Tools & Settings → Scripts.

2
Crear un nuevo script

Haga clic en el boton + para crear un nuevo script y pegue el script de exportación de Google Ads de Carbon Intelligence.

3
Establecer la URL de su Google Sheet

Cree un nuevo Google Sheet y pegue su URL en la variable SPREADSHEET_URL del script.

4
Autorizar y ejecutar

Haga clic en Authorize, luego en Run. El script completara 9 pestanas en su Google Sheet.

5
Programar ejecuciónes semanales

Configure el script para ejecutarse semanalmente en Scripts → Frequency.

Pestanas de Google Sheet creadas por el script

Nombre de la pestanaContenido
CI_CampaignsDatos a nivel de campaña con IDs, tipos y estrategias de puja
CI_DeviceDesglose de rendimiento por tipo de dispositivo
CI_GeoRendimiento geográfico por pais y region
CI_PlacementsDetalles de ubicacion en sitios y aplicaciónes
CI_CreativeSizeDimensiones de creatividades y tipos de anuncios
CI_AdFormatDesglose Search, Display, Video, Discovery
CI_VideoCuartiles de video, duracion y tasas de visualizacion
CI_MetadataInformacion de cuenta, rangos de fechas y metadatos de exportación
CI_Export_CSVExportacion combinada lista para descarga CSV
1
Habilitar BigQuery Data Transfer

En Google Cloud Console, habilite el servicio BigQuery Data Transfer.

2
Vincular su cuenta de Google Ads

Cree una configuración de transferencia de Google Ads, vinculando su cuenta de Ads (MCC o individual) a BigQuery.

3
Configurar tablas y programación

Seleccione las tablas de Google Ads a transferir y establezca el calendario de actualizacion (se recomienda diario).

4
Conectar BigQuery a Carbon Intelligence

En Carbon Intelligence, agregue BigQuery como fuente de datos y autentiquese.

5
Mapear y sincronizar

Mapee las tablas de BigQuery a las dimensiones de Carbon Intelligence y habilite la sincronización automática.

Meta Ads

Facebook, Instagram, Audience Network, Messenger — el mayor ecosistema de publicidad social. Granularidad única en ubicaciones (Feed, Stories, Reels) y dispositivos de impresión reales.

Marketing API v19.0 Feed · Stories · Reels GMSF v1.2

Dimensiones disponibles

Campaign
Campaign, Ad Set, Ad
Device Platform
Mobile, Desktop, Tablet
Geography
Country, Region
★ Placements
Feed, Stories, Reels, Right Column
Publisher Platform
Facebook, Instagram, AN, Messenger
Video
Quartiles p25–p100, avg watch time
★ Impression Device
iPhone, iPad, Android, Desktop
Creative
Ad name, format, dimensions
1
Abrir el Administrador de anuncios

Vaya a Meta Ads Manager y seleccione las campañas que desea analizar.

2
Personalizar columnas

Haga clic en Columns → Customize Columns y agregue las dimensiones listadas arriba.

3
Agregar breakdowns

Use Breakdown → By Delivery para agregar los breakdowns de Device, Platform, Placement e Impression Device.

4
Exportar CSV

Haga clic en Export → Export Table Data y elija el formato CSV.

5
Cargar en Carbon Intelligence

Cargue el CSV en Carbon Intelligence para un análisis de emisiónes instantaneo.

💡 Impression Device: Meta es una de las pocas plataformás que reporta el dispositivo real utilizado para ver su anuncio (ej. iPhone 14, Galaxy S23) — esto permite a Carbon Intelligence calcular el consumo de energia específico del dispositivo.

Use la API de Marketing de Meta v19.0 para extraer programáticamente los datos de campaña con todos los breakdowns disponibles.

1
Crear una aplicación Meta

Vaya a developers.facebook.com y cree una nueva aplicación con acceso a la API de Marketing.

2
Generar un token de larga duracion

Genere un token de acceso de usuario del sistema con el permiso ads_read en las cuentas publicitarias que necesita.

3
Configurar el script

Configure su ACCESS_TOKEN, AD_ACCOUNT_ID y el rango de fechas deseado en el script.

4
Ejecutar el script

Ejecute python carbon-intelligence-meta-ads-export.py. El script maneja automáticamente la paginación y los limites de velocidad.

5
Programar y cargar

Programe el script para ejecutarse semanalmente y cargue el CSV de salida en Carbon Intelligence.

Conecte Meta Ads a su Data Warehouse a traves de un conector ETL para un flujo de datos automatizado en tiempo real.

1
Elegir un conector ETL

Seleccione un conector compatible con Meta Ads: Fivetran, Supermetrics, Funnel.io o Adverity.

2
Autenticar Meta Ads

Conecte su cuenta de Meta Ads a la herramienta ETL usando OAuth. Seleccione las cuentas publicitarias a sincronizar.

3
Configurar el Data Warehouse de destino

Configure su Data Warehouse de destino (BigQuery, Snowflake, Redshift o Databricks).

4
Seleccionar tablas y programar

Elija las tablas de Meta Ads a sincronizar (insights de campaña, breakdowns, informes creativos) y establezca la frecuencia de sincronización.

5
Conectar el warehouse a Carbon Intelligence

Vincule su Data Warehouse a Carbon Intelligence y mapee las tablas de Meta Ads a las dimensiones de carbono.

The Trade Desk

El DSP independiente lider — transparencia programática completa con dimensiones de tipo de compra, proveedor y entorno para un análisis de carbono granular.

REDS API v3 Open · PMP · PG GMSF v1.2

Dimensiones disponibles

Campaign
Campaign, Ad Group, Creative
Device
Desktop, Mobile, Tablet, CTV
Geography
Country, Region, Metro
Domain / App
Sites, App bundles
Creative Size
Width × Height, format
Ad Format
Display, Video, Native, Audio, CTV
★ Supply Vendor
SSP / exchange source
★ Buy Type
Open Auction, PMP, PG
★ Environment
Web, App, CTV, DOOH
1
Abrir Mis informes

En The Trade Desk, navegue a Analytics → My Reports.

2
Crear un nuevo informe

Haga clic en New Report y seleccione el anunciante y el rango de fechas.

3
Agregar dimensiones y metricas

Agregue las dimensiones listadas arriba, incluyendo Supply Vendor, Buy Type y Environment. Agregue las metricas Impressions y Cost.

4
Exportar CSV

Ejecute el informe y descarguelo como CSV.

5
Cargar en Carbon Intelligence

Cargue el CSV en Carbon Intelligence.

Use la API REDS v3 de The Trade Desk para exportar programáticamente los datos de informes con granularidad completa de dimensiones.

1
Obtener credenciales API

Obtenga su token API desde la plataforma The Trade Desk en Settings → API Tokens.

2
Configurar el script

Configure su API_TOKEN, PARTNER_ID y ADVERTISER_ID en el script.

3
Ejecutar el script

Ejecute python carbon-intelligence-thetradedesk-export.py. El script consulta la API REDS y genera un CSV.

4
Programar y cargar

Automatice con un programador y cargue la salida en Carbon Intelligence.

Conecte los datos a nivel de log de The Trade Desk o use un conector ETL para una integración basada en Data Warehouse.

1
Habilitar datos a nivel de log

Contacte a su gerente de cuenta TTD para habilitar la entrega de datos a nivel de log (LLD) a su Data Warehouseamiento en la nube (S3, GCS o Azure Blob).

2
Configurar Data Warehouseamiento e ingestión

Configure su bucket en la nube y parametrice su Data Warehouse para ingerir los archivos LLD segun un calendario.

3
Transformar y agregar

Construya vistas SQL o modelos dbt para agregar los datos a nivel de log en las dimensiones necesarias para Carbon Intelligence.

4
Conectar a Carbon Intelligence

Vincule su Data Warehouse a Carbon Intelligence y mapee las tablas agregadas a las dimensiones de carbono.

Amazon DSP

Acceso al inventario exclusivo de Amazon — IMDb TV, Twitch, Fire TV, Prime Video Ads. Dimension única de fuente de suministro que separa el inventario propiedad de Amazon del inventario de terceros.

Unified Reporting API OLV · STV · Audio GMSF v1.2

Dimensiones disponibles

Campaign
Order, Line Item, Creative
Device
Desktop, Mobile, Tablet, CTV, Fire TV
Geography
Country, State, DMA
Creative Size
Dimensions, format type
★ Supply Source
Amazon-owned vs 3rd party
★ Ad Format
Display, OLV, STV, Audio
Environment
Web, App, Streaming
Video
Completions, quartiles, VAST errors
1
Abrir informes de Amazon DSP

En Amazon DSP, navegue a Measurement & Reporting → Reports.

2
Crear un nuevo informe

Haga clic en Create Report y seleccione su anunciante, el rango de fechas y el tipo de informe.

3
Agregar dimensiones y metricas

Seleccione todas las dimensiones disponibles, incluyendo Supply Source y Ad Format. Agregue las metricas Impressions y Total Cost.

4
Descargar CSV

Ejecute el informe y descarguelo como CSV.

5
Cargar en Carbon Intelligence

Cargue el CSV en Carbon Intelligence.

💡 Supply Source: Amazon DSP separa de forma única el inventario propiedad de Amazon (IMDb TV, Twitch, Fire TV) del inventario de terceros — esta distincion es critica para una modelizacion precisa del carbono ya que las propiedades de Amazon tienen perfiles de infraestructura significativamente diferentes.

Use la API de Amazon Ads para extraer programáticamente los datos de informes de Amazon DSP.

1
Registrarse en la API de Amazon Ads

Vaya al portal de desarrolladores de Amazon Ads y registre su aplicación. Solicite acceso al alcance de informes DSP.

2
Configurar la autenticación

Configure las credenciales OAuth 2.0 — necesitara un CLIENT_ID, CLIENT_SECRET y REFRESH_TOKEN.

3
Configurar el script

Configure sus credenciales, PROFILE_ID y el rango de fechas en el script.

4
Ejecutar el script

Ejecute python carbon-intelligence-amazon-dsp-export.py. El script solicita, consulta y descarga el informe automáticamente.

5
Programar y cargar

Automatice las ejecuciónes semanales y cargue el CSV de salida en Carbon Intelligence.

Use Amazon Marketing Cloud (AMC) para el nivel más profundo de integración de datos de Amazon DSP.

1
Solicitar acceso a AMC

Contacte a su equipo de cuenta de Amazon Ads para aprovisionar una instancia de Amazon Marketing Cloud para su anunciante.

2
Escribir consultas SQL

En la interfaz de AMC, escriba consultas SQL para agregar los datos de impresiónes DSP segun las dimensiones que necesita.

3
Exportar a S3

Configure AMC para enviar los resultados de las consultas a un bucket S3 que usted controle.

4
Ingerir en su Data Warehouse

Cargue los datos de S3 en su Data Warehouse (Redshift, Snowflake, BigQuery o Databricks).

5
Conectar a Carbon Intelligence

Vincule su Data Warehouse a Carbon Intelligence y mapee las tablas de salida de AMC.

🏢 AMC clean room: Amazon Marketing Cloud opera como una sala limpia segura para la privacidad — sus consultas se ejecutan sobre datos a nivel de impresión pero los resultados se agregan, garantizando el cumplimiento mientras proporciona a Carbon Intelligence la granularidad necesaria para cálculos precisos de emisiónes.
🌐

Otras Plataformas

Xandr, Yahoo DSP, TikTok Ads, Spotify Ads, Pinterest Ads, Snapchat Ads, LinkedIn Ads y cualquier otra plataforma publicitaria — Carbon Intelligence™ analiza cualquier dato de campaña via importación CSV.

Exporte sus datos de campaña desde cualquier DSP o plataforma publicitaria en formato CSV. Carbon Intelligence correlaciona su huella de carbono con el rendimiento publicitario (clics, conversiones, vistas de video, ingresos) para demostrar que la reducción de carbono mejora los resultados. Cuantas más dimensiones incluya, más preciso será su análisis de carbono y rendimiento.

📊 Impacto en la precisión de los cálculos

Dimensión Impacto Por qué es importante
🔴 Obligatorio
Impresiones
100%
Base de todo cálculo de carbono — una impresión = un evento energético
País / Región
90%
Determina el mix energético (gCO₂/kWh) — una impresión en Francia emite ~10× menos que en Polonia
Fecha
85%
Análisis temporal, variaciones estacionales del mix energético
Campaña
80%
Segmentación & reporting — atribuir emisiones por campaña
Coste / Spend
75%
Análisis de asignación presupuestaria, optimización coste-por-gramo
Clics
70%
Métrica de rendimiento clave — permite el cálculo del CTR y la optimización de carbono por clic
🟡 Recomendado
Tipo de dispositivo
65%
Móvil vs Desktop vs CTV — el consumo de energía varía ×3 a ×8
Ubicación / Sitio
55%
El peso del sitio impacta directamente la transferencia de datos — sitio pesado vs ligero = ×4 energía
Formato publicitario
45%
Video vs Display vs Nativo — un anuncio de video consume hasta ×8 más energía que un banner
Conversiones
60%
Demuestra que la reducción de carbono mejora los resultados — el carbono por conversión es la métrica de eficiencia definitiva
Vistas de video
50%
Los anuncios de video consumen ×8 más energía que el display — el seguimiento de vistas y completaciones permite un análisis de carbono por formato
🟢 Opcional (mejora la precisión)
Tipo de conexión
35%
WiFi vs 4G vs 5G — las redes móviles consumen ×3,5 más energía por byte que WiFi
Tamaño del creativo
25%
300×250 vs intersticial a pantalla completa — peso de datos y energía de renderizado
Entorno
20%
Web vs In-App vs CTV — diferentes pipelines de renderizado e infraestructura
Fuente de inventario
15%
Directo vs Programático vs Editor — la longitud de la cadena de suministro impacta las emisiones

📋 Cómo preparar su CSV

1
Exportar desde su plataforma

Navegue a la sección de reportes de su plataforma y cree un informe personalizado. Incluya tantas dimensiones de la tabla anterior como sea posible.

2
Verificar las columnas obligatorias

Su CSV debe incluir al menos: Date, Campaign, Impressions, Clicks, Cost y Country. Para un análisis de rendimiento completo, añada también Conversions y Video Views. Sin el país, el mix energético usa un promedio global y pierde precisión.

3
Exportar como CSV

Descargue el informe como archivo CSV. Asegúrese de que la primera fila contenga los encabezados de columna.

4
Subir a Carbon Intelligence™

Arrastre y suelte su CSV en la plataforma. El motor detecta automáticamente las columnas, normaliza los encabezados y lanza el análisis de carbono.

💡 Consejo: Cuantas más dimensiones incluya en su CSV, más preciso será el cálculo de carbono. El país es crítico — determina el mix energético que puede variar el resultado por un factor de 10. Inclúyalo siempre.

Elija su nivel de integración

Tres formás de conectarse

📄

Carga CSV

~2 min
  • No se requiere configuración técnica
  • Exportacion manual desde la interfaz DSP
  • Carga mediante arrastrar y soltar
  • Ideal para análisis puntuales
  • Ideal para comenzar rapidamente

Script API

~10 min
  • Extraccion de datos automatizada
  • Scripts preconstruidos para cada DSP
  • Programe ejecuciónes semanales o diarias
  • Formato consistente garantizado
  • Ideal para monitoreo continuo
🏢

Data Warehouse

Tiempo real
  • Conexion directa al Data Warehouse
  • Sincronizacion en tiempo real o casi en tiempo real
  • Granularidad maxima de datos
  • Fiabilidad de nivel empresarial
  • Ideal para operaciónes a gran escala