Carbon Intelligence™
Guida all'esportazione DV360 — Script Python
GMSF v1.2
DV360
10 min install
Obiettivo
Questo script Python esporta automaticamente i dati delle vostre campagne DV360 con la massima granularità per l'analisi del carbonio GMSF v1.2 in Carbon Intelligence™. DV360 offre dimensioni esclusive non disponibili in Google Ads: tipo di connessione, exchange, ambiente e modalità di acquisto.
Installation
3 passaggi · 10 minuti
Prerequisiti
- Python 3.8+ installato sulla vostra macchina
- Installare le dipendenze:
pip install google-api-python-client google-auth pandas - Creare un account di servizio in Google Cloud Console
- Abilitare l'API DV360 Reporting nel vostro progetto Cloud
- Scaricare il file JSON dell'account di servizio (chiave privata)
Configurare lo script
- Aprire
carbon-intelligence-dv360-export.py - Nella sezione CONFIG, compilare:
- •
SERVICE_ACCOUNT_PATH: percorso al JSON scaricato - •
ADVERTISER_ID: il vostro ID inserzionista DV360
- •
- Opzionale: configurare
SPREADSHEET_URLper esportare su Google Sheets - Opzionale: configurare
OUTPUT_DIRper l'esportazione CSV locale
Eseguire lo script
- Eseguire:
python carbon-intelligence-dv360-export.py - Per pianificare l'esecuzione:
- • Linux/Mac: usare
cron(es.:0 9 * * 1= lunedì ore 9) - • Windows: usare l'Utilità di pianificazione
- • Linux/Mac: usare
- Consigliato: esecuzione settimanale il lunedì mattina
Cosa viene esportato
12 schede create automaticamente
| Scheda | Contenuto | Utilizzo Carbon Intelligence |
|---|---|---|
| CI_Campaigns | Per ordine di inserzione e settimana | Panoramica delle emissioni |
| CI_Device | Per dispositivo (desktop, mobile, tablet, CTV) | Fattore energetico |
| CI_Geo | Per paese e regione | Mix energetico GMSF v1.2 |
| CI_Placements | Per sito/app e dominio | Posizionamenti ad alto consumo |
| CI_CreativeSize | Per dimensioni creative | Peso del trasferimento dati |
| CI_AdFormat | Per formato (Display, Video, Native, Audio, Rich Media) | Fattore di formato |
| CI_Video | Metriche video dettagliate (durata, quartili) | Calcolo del carbonio video |
| CI_Exchange | Per exchange (Google, Index, OpenX, ecc.) | 🎯 Esclusiva DV360 |
| CI_Connection | Per tipo di connessione (WiFi, 4G, 5G) | 🎯 Esclusiva DV360 |
| CI_Environment | Per ambiente (Web, App, CTV) | 🎯 Esclusiva DV360 |
| CI_Metadata | Informazioni di esportazione e account | Tracciabilità |
| CI_Export_CSV | Tutte le dimensioni consolidate | Importazione diretta CI |
Esportazione CSV
Due opzioni disponibili
Opzione A — CSV automatico
Lo script genera automaticamente i file CSV in
OUTPUT_DIROpzione B — Google Sheets
Configurare
SPREADSHEET_URL per l'esportazione direttaCondivisione con Carbon Intelligence™
Vantaggi vs Google Ads
Dimensioni esclusive DV360
Tipo di connessione (WiFi/4G/5G) — non disponibile in Google Ads
Exchange multipli — non disponibile in Google Ads
Modalità di acquisto (Open/PMP/PG) — non disponibile in Google Ads
Ambiente (Web/App/CTV) — non disponibile in Google Ads
Configurazione avanzata
Sezione CONFIG dello script
# Nello script, sezione CONFIG:
LOOKBACK_DAYS: 90, # Giorni di storico
MIN_IMPRESSIONS: 10, # Soglia minima
INCLUDE_PAUSED: False, # Campagne in pausa
OUTPUT_FORMAT: 'csv', # csv o sheets
LOOKBACK_DAYS: 90, # Giorni di storico
MIN_IMPRESSIONS: 10, # Soglia minima
INCLUDE_PAUSED: False, # Campagne in pausa
OUTPUT_FORMAT: 'csv', # csv o sheets
Risoluzione dei problemi
"Authentication failed"
Verificate il percorso al file JSON dell'account di servizio in
SERVICE_ACCOUNT_PATH."API not enabled"
Abilitate l'API DV360 Reporting in Google Cloud Console per il vostro progetto.
"Advertiser not found"
Verificate l'ID inserzionista in
ADVERTISER_ID — deve corrispondere al vostro account DV360.Timeout
Riducete
LOOKBACK_DAYS a 30 giorni se l'API impiega troppo tempo."No data"
Verificate che esistano campagne attive per il periodo. Aumentate
LOOKBACK_DAYS se necessario.Supporto
Email
support@carbonintelligence.green
Sito web
carbonintelligence.green
Versione script
1.0.0
Metodologia
GMSF v1.2 (Ad Net Zero)