Guide d'export Amazon DSP — Script Python

GMSF v1.2 Amazon DSP 15 min install
🎯
Objectif
Ce script Python exporte automatiquement les données de vos campagnes Amazon DSP avec la granularité nécessaire pour l'analyse carbone GMSF v1.2 dans Carbon Intelligence™. Amazon DSP offre des données uniques sur les sources d'inventaire Amazon (IMDb TV, Twitch, Fire TV, etc.).
⚙️
Installation
3 étapes · 15 minutes
Prérequis
  1. Python 3.8+ installé sur votre machine
  2. Installer les dépendances : pip install requests pandas
  3. Créer une application dans la Console développeur Amazon Ads
  4. Obtenir vos identifiants : Client ID, Client Secret, Refresh Token
  5. Identifier votre DSP Profile ID dans la console Amazon Ads
Configurer
  1. Ouvrir le fichier carbon-intelligence-amazon-dsp-export.py
  2. Renseigner les variables de configuration au début du script :
    • • CLIENT_ID = votre Client ID
    • • CLIENT_SECRET = votre Client Secret
    • • REFRESH_TOKEN = votre Refresh Token
    • • PROFILE_ID = votre DSP Profile ID
  3. Définir le répertoire de sortie dans OUTPUT_DIR
Exécuter
  1. Lancer le script : python carbon-intelligence-amazon-dsp-export.py
  2. Les données exportées apparaissent dans OUTPUT_DIR
  3. Planifier une exécution régulière via cron (Linux/macOS) ou Planificateur de tâches (Windows)
📊
Ce qui est exporté
11 onglets créés automatiquement
OngletContenuUsage Carbon Intelligence
CI_CampaignsPar order/line item + semaineVue d'ensemble des émissions
CI_DeviceDesktop, mobile, tablette, CTV, Fire TabletFacteur énergétique par appareil
CI_GeoPar pays et régionMix énergétique pays GMSF v1.2
CI_PlacementsPar source d'inventairePlacements énergivores
CI_CreativeSizePar taille de créaPoids du transfert de données
CI_AdFormatDisplay, Video, OLV, STV, Audio (formats Amazon)Facteur format publicitaire
CI_VideoDonnées vidéo détaillées (durée, quartiles)Calcul carbone vidéo
CI_SupplySourceInventaire Amazon vs tiers🎯 Spécifique Amazon DSP
CI_EnvironmentContexte de diffusionParamètres de diffusion
CI_MetadataInformations compte et exportTraçabilité et audit
CI_Export_CSVToutes dimensions consolidéesImport direct plateforme CI
📁
Export CSV
Deux options disponibles
Les fichiers CSV sont automatiquement générés dans le répertoire spécifié par OUTPUT_DIR après chaque exécution du script. Vous pouvez les importer directement dans Carbon Intelligence™ ou les intégrer dans votre pipeline de données.
🔗
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
# Variables de configuration avancée :

LOOKBACK_DAYS: 90,                                      # Jours d'historique à exporter
MIN_IMPRESSIONS: 1,                                     # Seuil minimum d'impressions par ligne
REPORT_WAIT_SECONDS: 60,                                # Attente avant récupération du rapport
TOKEN_REFRESH_URL: 'https://api.amazon.com/auth/o2/token'
🛠️
Résolution de problèmes
"401 Unauthorized"
Votre Refresh Token a expiré ou est invalide. Générez un nouveau token depuis la Console développeur Amazon Ads et mettez à jour REFRESH_TOKEN dans le script.
"Profile not found"
Vérifiez que votre PROFILE_ID est correct dans la console Amazon Ads et correspond à votre profil DSP.
"Report failed"
Le rapport n'a pas pu être généré. Vérifiez la plage de dates et réduisez LOOKBACK_DAYS si la période est trop grande.
"No access"
Vérifiez que les permissions de votre application et votre profil DSP autorisent l'accès aux rapports. Contactez votre gestionnaire de compte Amazon Ads si nécessaire.
"Rate limit"
L'API Amazon Ads limite les requêtes. Attendez au moins 60 secondes entre les exécutions du script, ou augmentez REPORT_WAIT_SECONDS.
💬
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 Amazon DSP — v1.0.0
ISO 14064 GHG Protocol ADEME Base Carbone GMSF v1.2 Ad Net Zero