Carbon Intelligence™ · Collega i tuoi dati
La nostra piattaforma è stata progettata per integrarsi nativamente con tutti i DSP e le piattaforme pubblicitarie dell'ecosistema adtech globale. Questa guida vi accompagna passo dopo passo per collegare le vostre piattaforme pubblicitarie a Carbon Intelligence™ — in pochi minuti.
Display & Video 360
Il DSP programmatico di Google — la fonte di dati più ricca per l'analisi delle emissioni di carbonio con accesso esclusivo alle dimensioni di tipo di connessione, exchange e ambiente.
Dimensioni disponibili
In DV360, vai su Reporting → Create Report.
Seleziona le dimensioni elencate sopra — includi Exchange, Connection Type ed Environment per la massima granularità.
Aggiungi Impressions, Clicks, Total Media Cost e qualsiasi altro KPI che monitori.
Esegui il report e scaricalo come file CSV.
Trascina e rilascia il CSV nella piattaforma Carbon Intelligence™ — i tuoi dati sulle emissioni saranno pronti in pochi secondi.
Assicurati che Python 3.8+ sia installato. Esegui pip install google-api-python-client google-auth.
In Google Cloud Console, crea un account di servizio con accesso all'API DV360 e lo scope Display & Video 360.
Scarica il file della chiave dell'account di servizio e salvalo in modo sicuro. Farai riferimento a questo percorso nello script.
Apri lo script e imposta il tuo ADVERTISER_ID, il percorso KEY_FILE e l'intervallo di date desiderato.
Esegui python carbon-intelligence-dv360-export.py. Lo script estrarra i dati tramite l'API DV360 e generera un CSV pronto per il caricamento.
Usa cron (Linux/Mac) o l'Utilita di pianificazione (Windows) per automatizzare le estrazioni settimanali.
In Google Cloud Console, attiva il servizio BigQuery Data Transfer per il tuo progetto.
Configura un trasferimento pianificato da DV360 a BigQuery, selezionando gli ID inserzionista e le dimensioni necessarie.
Crea o seleziona un dataset BigQuery per ricevere i dati DV360. Imposta la regione e le policy di scadenza appropriate.
In Carbon Intelligence™, aggiungi una fonte dati BigQuery e autenticati con le tue credenziali Google Cloud.
Seleziona le tabelle da sincronizzare e imposta la frequenza di aggiornamento. I dati confluiranno automaticamente nella tua dashboard delle emissioni.
Google Ads
Search, Display, Video, Performance Max — la piattaforma pubblicitària più utilizzata. I Google Ads Scripts nativi rendono l'automazione senza soluzione di continuita.
Dimensioni disponibili
Vai su Reports → Predefined reports nel tuo account Google Ads.
Aggiungi le dimensioni Campaign, Device, Geography, Placements, Creative Size e Ad Format.
Includi Impressions, Clicks, Cost e qualsiasi altra metrica che monitori.
Esegui il report e scaricalo come file CSV.
Trascina e rilascia il CSV nella piattaforma Carbon Intelligence™.
I Google Ads Scripts vengono eseguiti nativamente in Google Ads — nessuna configurazione locale richiesta. Lo script esporta i dati in un Google Sheet, che puoi poi scaricare o collegare direttamente.
In Google Ads, vai su Tools & Settings → Scripts.
Clicca il pulsante + per creare un nuovo script e incolla lo script di esportazione Google Ads di Carbon Intelligence™.
Crea un nuovo Google Sheet e incolla il suo URL nella variabile SPREADSHEET_URL dello script.
Clicca Authorize, poi Run. Lo script popolera 9 schede nel tuo Google Sheet.
Imposta lo script per l'esecuzione settimanale sotto Scripts → Frequency.
Schede Google Sheet create dallo script
| Nome scheda | Contenuto |
|---|---|
| CI_Campaigns | Dati a livello di campagna con ID, tipi e strategie di offerta |
| CI_Device | Suddivisione delle performance per tipo di dispositivo |
| CI_Geo | Performance geografiche per paese e regione |
| CI_Placements | Dettagli dei posizionamenti su siti e app |
| CI_CreativeSize | Dimensioni dei creativi e tipi di annuncio |
| CI_AdFormat | Suddivisione Search, Display, Video, Discovery |
| CI_Video | Quartili video, durata e tassi di visualizzazione |
| CI_Metadata | Informazioni account, intervalli di date e metadati di esportazione |
| CI_Export_CSV | Esportazione combinata pronta per il download CSV |
In Google Cloud Console, attiva il servizio BigQuery Data Transfer.
Crea una configurazione di trasferimento Google Ads, collegando il tuo account Ads (MCC o individuale) a BigQuery.
Seleziona le tabelle di Google Ads da trasferire e imposta la pianificazione degli aggiornamenti (si consiglia giornaliero).
In Carbon Intelligence™, aggiungi BigQuery come fonte dati e autenticati.
Mappa le tabelle BigQuery alle dimensioni di Carbon Intelligence™ e abilita la sincronizzazione automatica.
Meta Ads
Facebook, Instagram, Audience Network, Messenger — il più grande ecosistema pubblicitàrio social. Granularita unica sui posizionamenti (Feed, Stories, Reels) e sui dispositivi di impression effettivi.
Dimensioni disponibili
Vai su Meta Ads Manager e seleziona le campagne che desideri analizzare.
Clicca Columns → Customize Columns e aggiungi le dimensioni elencate sopra.
Usa Breakdown → By Delivery per aggiungere le suddivisioni per Device, Platform, Placement e Impression Device.
Clicca Export → Export Table Data e scegli il formato CSV.
Carica il CSV su Carbon Intelligence™ per un'analisi delle emissioni istantanea.
Usa l'API Marketing di Meta v19.0 per estrarre programmaticamente i dati delle campagne con tutte le suddivisioni disponibili.
Vai su developers.facebook.com e crea una nuova app con accesso all'API Marketing.
Genera un token di accesso utente di sistema con il permesso ads_read sugli account pubblicitàri necessari.
Imposta il tuo ACCESS_TOKEN, AD_ACCOUNT_ID e l'intervallo di date desiderato nello script.
Esegui python carbon-intelligence-meta-ads-export.py. Lo script gestisce automaticamente la paginazione e i limiti di frequenza.
Pianifica l'esecuzione settimanale dello script e carica il CSV di output su Carbon Intelligence™.
Collega Meta Ads al tuo data warehouse tramite un connettore ETL per un flusso di dati automatizzato in tempo reale.
Seleziona un connettore che supporta Meta Ads: Fivetran, Supermetrics, Funnel.io o Adverity.
Collega il tuo account Meta Ads allo strumento ETL tramite OAuth. Seleziona gli account pubblicitàri da sincronizzare.
Configura il tuo warehouse di destinazione (BigQuery, Snowflake, Redshift o Databricks).
Scegli le tabelle Meta Ads da sincronizzare (insights campagna, suddivisioni, report creativi) e imposta la frequenza di sincronizzazione.
Collega il tuo data warehouse a Carbon Intelligence™ e mappa le tabelle Meta Ads alle dimensioni di carbonio.
The Trade Desk
Il DSP indipendente leader — piena trasparenza programmatica con dimensioni di tipo di acquisto, fornitore e ambiente per un'analisi granulare delle emissioni di carbonio.
Dimensioni disponibili
In The Trade Desk, vai su Analytics → My Reports.
Clicca New Report e seleziona l'inserzionista e l'intervallo di date.
Aggiungi le dimensioni elencate sopra, inclusi Supply Vendor, Buy Type ed Environment. Aggiungi le metriche Impressions e Cost.
Esegui il report e scaricalo come CSV.
Carica il CSV su Carbon Intelligence™.
Usa l'API REDS v3 di The Trade Desk per esportare programmaticamente i dati dei report con granularità completa delle dimensioni.
Ottieni il tuo token API dalla piattaforma The Trade Desk sotto Settings → API Tokens.
Imposta il tuo API_TOKEN, PARTNER_ID e ADVERTISER_ID nello script.
Esegui python carbon-intelligence-thetradedesk-export.py. Lo script interroga l'API REDS e genera un CSV.
Automatizza con uno scheduler e carica l'output su Carbon Intelligence™.
Collega i dati a livello di log di The Trade Desk o usa un connettore ETL per un'integrazione basata su warehouse.
Contatta il tuo account manager TTD per attivare la consegna dei dati a livello di log (LLD) al tuo cloud storage (S3, GCS o Azure Blob).
Configura il tuo bucket cloud e imposta il tuo data warehouse per ingerire i file LLD secondo una pianificazione.
Costruisci viste SQL o modelli dbt per aggregare i dati a livello di log nelle dimensioni necessarie per Carbon Intelligence™.
Collega il tuo warehouse a Carbon Intelligence™ e mappa le tabelle aggregate alle dimensioni di carbonio.
Amazon DSP
Accesso all'inventario esclusivo di Amazon — IMDb TV, Twitch, Fire TV, Prime Video Ads. Dimensione unica della fonte di fornitura che separa l'inventario di proprieta Amazon dall'inventario di terze parti.
Dimensioni disponibili
In Amazon DSP, vai su Measurement & Reporting → Reports.
Clicca Create Report e seleziona il tuo inserzionista, l'intervallo di date e il tipo di report.
Seleziona tutte le dimensioni disponibili, incluse Supply Source e Ad Format. Aggiungi le metriche Impressions e Total Cost.
Esegui il report e scaricalo come CSV.
Carica il CSV su Carbon Intelligence™.
Usa l'API Amazon Ads per estrarre programmaticamente i dati di reporting da Amazon DSP.
Vai al portale sviluppatori Amazon Ads e registra la tua applicazione. Richiedi l'accesso allo scope di reporting DSP.
Configura le credenziali OAuth 2.0 — avrai bisogno di un CLIENT_ID, CLIENT_SECRET e REFRESH_TOKEN.
Imposta le tue credenziali, PROFILE_ID e l'intervallo di date nello script.
Esegui python carbon-intelligence-amazon-dsp-export.py. Lo script richiede, interroga e scarica il report automaticamente.
Automatizza le esecuzioni settimanali e carica il CSV di output su Carbon Intelligence™.
Usa Amazon Marketing Cloud (AMC) per il livello più profondo di integrazione dati di Amazon DSP.
Contatta il tuo team account Amazon Ads per il provisioning di un'istanza Amazon Marketing Cloud per il tuo inserzionista.
Nell'interfaccia AMC, scrivi query SQL per aggregare i dati DSP a livello di impression secondo le dimensioni necessarie.
Configura AMC per inviare i risultati delle query a un bucket S3 che controlli.
Carica i dati S3 nel tuo warehouse (Redshift, Snowflake, BigQuery o Databricks).
Collega il tuo warehouse a Carbon Intelligence™ e mappa le tabelle di output AMC.
Altre Piattaforme
Xandr, Yahoo DSP, TikTok Ads, Spotify Ads, Pinterest Ads, Snapchat Ads, LinkedIn Ads e qualsiasi altra piattaforma pubblicitaria — Carbon Intelligence™ analizza qualsiasi dato di campagna tramite importazione CSV.
Esporta i dati della tua campagna da qualsiasi DSP o piattaforma pubblicitaria in formato CSV. Carbon Intelligence™ correla la tua impronta di carbonio con le performance pubblicitarie (clic, conversioni, visualizzazioni video, ricavi) per dimostrare che la riduzione del carbonio migliora i risultati. Più dimensioni includi, più precisa sarà la tua analisi del carbonio e delle performance.
📊 Impatto sulla precisione dei calcoli
📋 Come preparare il tuo CSV
Accedi alla sezione reporting della tua piattaforma e crea un report personalizzato. Includi quante più dimensioni possibili dalla tabella sopra.
Il tuo CSV deve includere almeno: Date, Campaign, Impressions, Clicks, Cost e Country. Per un'analisi completa delle performance, aggiungi anche Conversions e Video Views. Senza il paese, il mix energetico usa una media globale e perde precisione.
Scarica il report come file CSV. Assicurati che la prima riga contenga le intestazioni delle colonne.
Trascina e rilascia il tuo CSV nella piattaforma. Il motore rileva automaticamente le colonne, normalizza le intestazioni e avvia l'analisi del carbonio.
Scegli il tuo livello di integrazione
Tre modi per connettersi
Caricamento CSV
~2 min- Nessuna configurazione tecnica richiesta
- Esportazione manuale dall'interfaccia DSP
- Caricamento tramite trascinamento
- Ideale per analisi una tantum
- Ideale per iniziare rapidamente
Script API
~10 min- Estrazione dati automatizzata
- Script predefiniti per ogni DSP
- Pianifica esecuzioni settimanali o giornaliere
- Formattazione coerente garantita
- Ideale per il monitoraggio continuo
Data Warehouse
Tempo reale- Connessione diretta al warehouse
- Sincronizzazione in tempo reale o quasi in tempo reale
- Massima granularità dei dati
- Affidabilita di livello aziendale
- Ideale per operazioni su larga scala