Guía de exportación The Trade Desk — Script Python

GMSF v1.2 The Trade Desk 10 min install
🎯
Objetivo
Este script Python exporta automáticamente los datos de sus campañas The Trade Desk con la granularidad necesaria para el análisis de carbono GMSF v1.2 en Carbon Intelligence™. The Trade Desk ofrece una granularidad muy fina en exchanges, conexiones y tipos de compra.
⚙️
Installation
3 pasos · 10 minutos
Requisitos previos
  1. Python 3.8+ instalado en su servidor o máquina local
  2. Instalar dependencias: pip install requests pandas
  3. Obtener un API Token y un Partner ID de The Trade Desk
  4. Anotar el Advertiser ID objetivo para la exportación
Configurar el script
  1. Abrir el archivo carbon-intelligence-thetradedesk-export.py
  2. Completar los parámetros de autenticación: API_TOKEN, PARTNER_ID, ADVERTISER_ID
  3. Configurar OUTPUT_DIR para la carpeta de destino de los CSV
Ejecutar
  1. Ejecutar el script: python carbon-intelligence-thetradedesk-export.py
  2. Programar una ejecución recurrente mediante cron (Linux/macOS) o Programador de tareas (Windows)
  3. Recomendación: semanal (cada lunes por la mañana)
📊
Qué se exporta
13 pestañas creadas automáticamente
PestañaContenidoUso Carbon Intelligence
CI_CampaignsResumen por campaña y díaVista general de emisiones
CI_DevicePor dispositivo (móvil, escritorio, CTV)Factor energético por dispositivo
CI_GeoPor país y regiónMix energético país GMSF v1.2
CI_PlacementsPor sitio y aplicaciónUbicaciones de alto consumo energético
CI_CreativeSizePor tamaño de creatividad (300x250, 728x90, etc.)Peso de transferencia de datos
CI_AdFormatPor formato (Display, Video, Native)Factor de formato publicitario
CI_VideoDatos de vídeo detallados (duración, tipo)Cálculo de carbono de vídeo
CI_ExchangePor exchange (Rubicon, OpenX, AppNexus, etc.)🎯 Específico TTD — Fuente de inventario
CI_ConnectionPor tipo de conexión (WiFi, móvil, cableado)🎯 Específico TTD — Eficiencia energética de red
CI_EnvironmentPor contexto (app, web, OTT)🎯 Específico TTD — Tipo de entorno multimedia
CI_BuyTypePor modo de compra (open auction, PMP, PG)🎯 Específico TTD — Transparencia de estrategia de compra
CI_MetadataInfo de cuenta, versión del script, fechasTrazabilidad y auditoría
CI_Export_CSVTodas las dimensiones consolidadasImportación directa plataforma CI
📁
Exportar CSV
Dos opciones disponibles
Después de cada ejecución del script, encontrará en la carpeta OUTPUT_DIR los siguientes archivos CSV:
  • • CI_Export_[DATE].csv — Archivo consolidado para importación directa
  • • CI_Campaigns_[DATE].csv — Detalles de campañas
  • • CI_Device_[DATE].csv — Por dispositivo
  • • CI_Exchange_[DATE].csv — Por exchange (específico TTD)
  • • ...y otras dimensiones
🔗
Compartir con Carbon Intelligence™
📨
Comparta el Google Sheet con: support@carbonintelligence.green (accès lecteur)
O envíe el CSV exportado por email a la misma dirección.
🔧
Configuración avanzada
Sección CONFIG del script
# En el script, sección CONFIG:

LOOKBACK_DAYS: 90,              # Días de historial (predeterminado: 90)
MIN_IMPRESSIONS: 1,             # Umbral mínimo de impresiones por fila
REPORT_TIMEZONE: 'UTC',         # Zona horaria del informe
MAX_RETRIES: 3                # Intentos de reintento API en caso de error
🛠️
Solución de problemas
"401 Unauthorized"
Verifique que su API_TOKEN sea válido y no haya expirado. Regenerelo si es necesario en la consola de The Trade Desk.
"Advertiser not found"
Verifique que el ADVERTISER_ID existe y que su token tiene acceso a esta cuenta.
"Report timeout"
El informe está tardando demasiado. Reduzca LOOKBACK_DAYS de 90 a 30 días.
"Empty report"
Verifique que tiene campañas activas con impresiones para el período definido por LOOKBACK_DAYS.
"Rate limit exceeded"
La API de The Trade Desk tiene una cuota. Espere unos minutos e intente de nuevo. Aumente MAX_RETRIES para mayor resiliencia.
💬
Soporte
Email support@carbonintelligence.green
Sitio web carbonintelligence.green
Versión del script 1.0.0
Metodología GMSF v1.2 (Ad Net Zero)
Carbon Intelligence™ — Guía de instalación The Trade Desk — v1.0.0
ISO 14064 GHG Protocol ADEME Base Carbone GMSF v1.2 Ad Net Zero