Guida all'esportazione The Trade Desk — Script Python

GMSF v1.2 The Trade Desk 10 min install
🎯
Obiettivo
Questo script Python esporta automaticamente i dati delle vostre campagne The Trade Desk con la granularità necessaria per l'analisi del carbonio GMSF v1.2 in Carbon Intelligence™. The Trade Desk offre una granularità molto fine su exchange, connessioni e tipi di acquisto.
⚙️
Installation
3 passaggi · 10 minuti
Prerequisiti
  1. Python 3.8+ installato sul vostro server o macchina locale
  2. Installare le dipendenze: pip install requests pandas
  3. Ottenere un API Token e un Partner ID da The Trade Desk
  4. Annotare l'Advertiser ID di destinazione per l'esportazione
Configurare lo script
  1. Aprire il file carbon-intelligence-thetradedesk-export.py
  2. Compilare i parametri di autenticazione: API_TOKEN, PARTNER_ID, ADVERTISER_ID
  3. Configurare OUTPUT_DIR per la cartella di destinazione dei CSV
Eseguire
  1. Eseguire lo script: python carbon-intelligence-thetradedesk-export.py
  2. Pianificare un'esecuzione ricorrente tramite cron (Linux/macOS) o Utilità di pianificazione (Windows)
  3. Raccomandazione: settimanale (ogni lunedì mattina)
📊
Cosa viene esportato
13 schede create automaticamente
SchedaContenutoUtilizzo Carbon Intelligence
CI_CampaignsRiepilogo per campagna e giornoPanoramica delle emissioni
CI_DevicePer dispositivo (mobile, desktop, CTV)Fattore energetico per dispositivo
CI_GeoPer paese e regioneMix energetico paese GMSF v1.2
CI_PlacementsPer sito e applicazionePosizionamenti ad alto consumo energetico
CI_CreativeSizePer dimensione della creatività (300x250, 728x90, ecc.)Peso del trasferimento dati
CI_AdFormatPer formato (Display, Video, Native)Fattore formato pubblicitario
CI_VideoDati video dettagliati (durata, tipo)Calcolo carbonio video
CI_ExchangePer exchange (Rubicon, OpenX, AppNexus, ecc.)🎯 Specifico TTD — Fonte di inventario
CI_ConnectionPer tipo di connessione (WiFi, mobile, cablato)🎯 Specifico TTD — Efficienza energetica della rete
CI_EnvironmentPer contesto (app, web, OTT)🎯 Specifico TTD — Tipo di ambiente media
CI_BuyTypePer modalità di acquisto (open auction, PMP, PG)🎯 Specifico TTD — Trasparenza della strategia di acquisto
CI_MetadataInfo account, versione script, dateTracciabilità e audit
CI_Export_CSVTutte le dimensioni consolidateImportazione diretta piattaforma CI
📁
Esportazione CSV
Due opzioni disponibili
Dopo ogni esecuzione dello script, troverete nella cartella OUTPUT_DIR i seguenti file CSV:
  • • CI_Export_[DATE].csv — File consolidato per importazione diretta
  • • CI_Campaigns_[DATE].csv — Dettagli delle campagne
  • • CI_Device_[DATE].csv — Per dispositivo
  • • CI_Exchange_[DATE].csv — Per exchange (specifico TTD)
  • • ...e altre dimensioni
🔗
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.
🔧
Configurazione avanzata
Sezione CONFIG dello script
# Nello script, sezione CONFIG:

LOOKBACK_DAYS: 90,              # Giorni di storico (predefinito: 90)
MIN_IMPRESSIONS: 1,             # Soglia minima di impressions per riga
REPORT_TIMEZONE: 'UTC',         # Fuso orario del report
MAX_RETRIES: 3                # Tentativi di ripetizione API in caso di errore
🛠️
Risoluzione dei problemi
"401 Unauthorized"
Verificate che il vostro API_TOKEN sia valido e non scaduto. Rigeneratelo se necessario nella console The Trade Desk.
"Advertiser not found"
Verificate che l'ADVERTISER_ID esista e che il vostro token abbia accesso a questo account.
"Report timeout"
Il report sta impiegando troppo tempo. Riducete LOOKBACK_DAYS da 90 a 30 giorni.
"Empty report"
Verificate di avere campagne attive con impressions per il periodo definito da LOOKBACK_DAYS.
"Rate limit exceeded"
L'API The Trade Desk ha un limite di quota. Attendete qualche minuto e riprovate. Aumentate MAX_RETRIES per una maggiore resilienza.
💬
Supporto
Email support@carbonintelligence.green
Sito web carbonintelligence.green
Versione script 1.0.0
Metodologia GMSF v1.2 (Ad Net Zero)
Carbon Intelligence™ — Guida all'installazione The Trade Desk — v1.0.0
ISO 14064 GHG Protocol ADEME Base Carbone GMSF v1.2 Ad Net Zero