Guide d'export The Trade Desk — Script Python

GMSF v1.2 The Trade Desk 10 min install
🎯
Objectif
Ce script Python exporte automatiquement les données de vos campagnes The Trade Desk avec la granularité nécessaire pour l'analyse carbone GMSF v1.2 dans Carbon Intelligence™. The Trade Desk offre une granularité très fine sur les exchanges, connexions, et types d'achat.
⚙️
Installation
3 étapes · 10 minutes
Prérequis
  1. Python 3.8+ installé sur votre serveur ou machine locale
  2. Installer les dépendances : pip install requests pandas
  3. Obtenir un API Token et un Partner ID depuis The Trade Desk
  4. Noter l'Advertiser ID cible pour l'export
Configurer le script
  1. Ouvrir le fichier carbon-intelligence-thetradedesk-export.py
  2. Renseigner les paramètres d'authentification : API_TOKEN, PARTNER_ID, ADVERTISER_ID
  3. Configurer OUTPUT_DIR pour le dossier de destination des CSV
Exécuter
  1. Lancer le script : python carbon-intelligence-thetradedesk-export.py
  2. Planifier une exécution récurrente via cron (Linux/macOS) ou Planificateur de tâches (Windows)
  3. Recommandation : hebdomadaire (chaque lundi matin)
📊
Ce qui est exporté
13 onglets créés automatiquement
OngletContenuUsage Carbon Intelligence
CI_CampaignsRésumé par campagne et par jourVue d'ensemble des émissions
CI_DevicePar appareil (mobile, desktop, CTV)Facteur énergétique par appareil
CI_GeoPar pays et régionMix énergétique pays GMSF v1.2
CI_PlacementsPar site et applicationPlacements énergivores
CI_CreativeSizePar taille de créa (300x250, 728x90, etc.)Poids du transfert de données
CI_AdFormatPar format (Display, Video, Native)Facteur format publicitaire
CI_VideoDonnées vidéo détaillées (durée, type)Calcul carbone vidéo
CI_ExchangePar exchange (Rubicon, OpenX, AppNexus, etc.)🎯 Spécifique TTD — Source d'inventaire
CI_ConnectionPar type de connexion (WiFi, mobile, filaire)🎯 Spécifique TTD — Efficacité énergétique réseau
CI_EnvironmentPar contexte (app, web, OTT)🎯 Spécifique TTD — Type d'environnement média
CI_BuyTypePar mode d'achat (open auction, PMP, PG)🎯 Spécifique TTD — Transparence stratégie d'achat
CI_MetadataInfos compte, version du script, datesTraçabilité et audit
CI_Export_CSVToutes dimensions consolidéesImport direct plateforme CI
📁
Export CSV
Deux options disponibles
Après chaque exécution du script, vous trouverez dans le dossier OUTPUT_DIR les fichiers CSV suivants :
  • • CI_Export_[DATE].csv — Fichier consolidé pour import direct
  • • CI_Campaigns_[DATE].csv — Détails des campagnes
  • • CI_Device_[DATE].csv — Par appareil
  • • CI_Exchange_[DATE].csv — Par exchange (spécifique TTD)
  • • ...et autres dimensions
🔗
Partage avec Carbon Intelligence™
📨
Partagez le Google Sheet avec : support@carbonintelligence.green (accès lecteur)
Ou envoyez le CSV exporté par email à la même adresse.
🔧
Configuration avancée
Section CONFIG du script
# Dans le script, section CONFIG :

LOOKBACK_DAYS: 90,              # Jours d'historique (défaut : 90)
MIN_IMPRESSIONS: 1,             # Seuil minimum d'impressions par ligne
REPORT_TIMEZONE: 'UTC',         # Fuseau horaire du rapport
MAX_RETRIES: 3                # Tentatives de réessai API en cas d'erreur
🛠️
Résolution de problèmes
"401 Unauthorized"
Vérifiez que votre API_TOKEN est valide et non expiré. Régénérez-le si nécessaire dans la console The Trade Desk.
"Advertiser not found"
Vérifiez que l'ADVERTISER_ID existe et que votre token a accès à ce compte.
"Report timeout"
Le rapport prend trop de temps. Réduisez LOOKBACK_DAYS de 90 à 30 jours.
"Empty report"
Vérifiez que vous avez des campagnes actives avec des impressions pour la période définie par LOOKBACK_DAYS.
"Rate limit exceeded"
L'API The Trade Desk a un quota. Attendez quelques minutes et réessayez. Augmentez MAX_RETRIES pour une meilleure résilience.
💬
Support
Email support@carbonintelligence.green
Site web carbonintelligence.green
Version script 1.0.0
Méthodologie GMSF v1.2 (Ad Net Zero)
Carbon Intelligence™ — Guide d'installation The Trade Desk — v1.0.0
ISO 14064 GHG Protocol ADEME Base Carbone GMSF v1.2 Ad Net Zero