Guida all'esportazione Google Ads

GMSF v1.2 Google Ads 5 min install
🎯
Obiettivo
Questo script esporta automaticamente i dati delle vostre campagne Google Ads con la granularità necessaria per l'analisi delle emissioni di carbonio GMSF v1.2 in Carbon Intelligence™.
⚙️
Installation
3 passaggi · 5 minuti
Creare il Google Sheet di destinazione
  1. Andate su sheets.new
  2. Rinominate il file: CI_Export_GoogleAds_[NomeCliente]
  3. Copiate l'URL del Sheet
Installare lo script
  1. Accedete a Google Ads
  2. Andate su Strumenti e impostazioni → Azioni collettive → Script
  3. Cliccate su + (Nuovo script)
  4. Nominate lo script: Carbon Intelligence Export
  5. Incollate il contenuto del file carbon-intelligence-google-ads-export.js
  6. Sostituite COLLER_URL_GOOGLE_SHEET_ICI con l'URL del vostro Google Sheet
  7. Cliccate su Autorizza e poi su Esegui
Programmare l'esecuzione
  1. Dopo la prima esecuzione riuscita, cliccate su Crea una pianificazione
  2. Selezionate Settimanale (lunedì mattina consigliato)
  3. Lo script verrà eseguito automaticamente ogni settimana
📊
Cosa viene esportato
10 schede create automaticamente
SchedaContenutoUtilizzo Carbon Intelligence
CI_CampaignsRiepilogo per campagna e settimanaPanoramica delle emissioni
CI_DevicePer dispositivo (mobile, desktop, tablet)Fattore energetico per dispositivo
CI_GeoPer paese e regioneMix energetico per paese GMSF v1.2
CI_PlacementsPer sito e applicazionePosizionamenti ad alto consumo energetico
CI_CreativeSizePer dimensione della creativitàPeso del trasferimento dati
CI_AdFormatPer formato (Search, Display, Video)Fattore formato pubblicitario
CI_VideoDati video dettagliatiCalcolo del carbonio video (durata, quartili)
CI_MetadataInformazioni su account ed esportazioneTracciabilità e audit
CI_DiagnosticTest di ogni queryIdentificazione dei problemi
CI_Export_CSVTutte le dimensioni consolidateImportazione diretta nella piattaforma CI
📁
Esportazione CSV
Due opzioni disponibili
Opzione A — Da Google Sheets
  1. Andate alla scheda CI_Export_CSV
  2. File → Scarica → CSV (.csv)
Opzione B — Tramite lo script
  1. Cambiate la funzione in exportToCSV
  2. Eseguite — un file CSV verrà creato nel vostro Google Drive
  3. Il link del file appare nei log
🔗
Condivisione con Carbon Intelligence™
📨
Condividi il Google Sheet con: support@carbonintelligence.green (accès lecteur)
Oppure invia il CSV esportato per email allo stesso indirizzo.
⚠️
Dimensioni non coperte
DimensionPerchéAlternative
Tipo di connessione (Wi-Fi/4G/5G)Non disponibile in Google AdsDisponibile tramite DV360 o TTD
Exchange (SSP)Google Ads = walled gardenDisponibile tramite DV360 o TTD
Modalità di acquisto (Open/PMP)Specifico del programmatic openDisponibile tramite DV360 o TTD
Peso creativo (KB)Non riportato da Google AdsStima GMSF per tipo di formato
Active View / ViewabilityIn fase di sunset da GoogleMetriche rimosse in v1.2.0
Se utilizzi DV360 o un altro DSP, contattaci per uno script dedicato.
🔧
Configurazione avanzata
Sezione CONFIG dello script
// Nello script, sezione CONFIG:

LOOKBACK_DAYS: 90,       // Giorni di storico (predefinito: 90)
MIN_IMPRESSIONS: 1,      // Soglia minima di impressioni per riga
INCLUDE_PAUSED: true     // Includere le campagne in pausa (consigliato)
🔍
Diagnostica
Funzione di diagnostica integrata
  1. In Google Ads > Script, aprite lo script
  2. Nel menu a tendina accanto a Esegui, selezionate diagnose
  3. Cliccate su Esegui
  4. Aprite il Google Sheet e andate alla scheda CI_Diagnostic

La diagnostica testa: accesso all'account Google Ads, ogni tipo di query individualmente, numero di campagne attive e in pausa, disponibilità dei dati per tipo (Device, Geo, Placements, Video...). Ogni test è colorato: verde (OK), giallo (vuoto ma normale), rosso (errore). In caso di errore, inviate uno screenshot della scheda CI_Diagnostic a support@carbonintelligence.green.

🛠️
Risoluzione dei problemi
"Authorization required"
Normale alla prima esecuzione. Cliccate su Autorizza e accettate i permessi.
"Spreadsheet not found"
Verificate che l'URL del Google Sheet sia corretto in CONFIG.SPREADSHEET_URL.
Colonne vuote (tutte)
Eseguite la funzione diagnose (menu a tendina accanto a Esegui > selezionate "diagnose"). Consultate poi la scheda CI_Diagnostic nel Google Sheet che identifica il problema esatto.
Campagne in pausa
Se le vostre campagne sono in pausa, lo script non esporta dati per impostazione predefinita. In v1.2.0, INCLUDE_PAUSED è impostato su true per impostazione predefinita. Per le versioni precedenti, impostate INCLUDE_PAUSED: true nella sezione CONFIG.
Dati mancanti
Verificate che le campagne abbiano impressioni per il periodo. Regolate LOOKBACK_DAYS se necessario.
Timeout
Se l'account ha molti dati, riducete LOOKBACK_DAYS a 30 giorni.
Schede vuote
Alcune schede (Video, Placements) si riempiono solo se i tipi di campagna corrispondenti sono attivi.
💬
Supporto
Email support@carbonintelligence.green
Sito web carbonintelligence.green
Versione script 1.3.0
Metodologia GMSF v1.2 (Ad Net Zero)
Carbon Intelligence™ — Guida all'installazione Google Ads — v1.3.0
ISO 14064 GHG Protocol ADEME Base Carbone GMSF v1.2 Ad Net Zero