Guide d'export DV360 — Script Python

GMSF v1.2 DV360 10 min install
🎯
Objectif
Ce script Python exporte automatiquement les données de vos campagnes DV360 avec la granularité maximale pour l'analyse carbone GMSF v1.2 dans Carbon Intelligence. DV360 offre des dimensions exclusives non disponibles dans Google Ads : type de connexion, exchange, environnement, et mode d'achat.
⚙️
Installation
3 étapes · 10 minutes
Prérequis
  1. Python 3.8+ installé sur votre machine
  2. Installer les dépendances : pip install google-api-python-client google-auth pandas
  3. Créer un compte de service dans Google Cloud Console
  4. Activer l'API DV360 Reporting dans votre projet Cloud
  5. Télécharger le fichier JSON du compte de service (clé privée)
Configurer le script
  1. Ouvrir carbon-intelligence-dv360-export.py
  2. Dans la section CONFIG, renseigner :
    • SERVICE_ACCOUNT_PATH : chemin vers le JSON téléchargé
    • ADVERTISER_ID : votre identifiant annonceur DV360
  3. Optionnel : configurer SPREADSHEET_URL pour exporter vers Google Sheets
  4. Optionnel : configurer OUTPUT_DIR pour l'export CSV local
Lancer le script
  1. Exécuter : python carbon-intelligence-dv360-export.py
  2. Pour planifier l'exécution :
    • Linux/Mac : utiliser cron (ex. : 0 9 * * 1 = lundi 9h)
    • Windows : utiliser le Planificateur de tâches
  3. Recommandé : exécution hebdomadaire le lundi matin
📊
Ce qui est exporté
12 onglets créés automatiquement
OngletContenuUsage Carbon Intelligence
CI_CampaignsPar ordre d'insertion et semaineVue d'ensemble des émissions
CI_DevicePar appareil (desktop, mobile, tablette, CTV)Facteur énergétique
CI_GeoPar pays et régionMix énergétique GMSF v1.2
CI_PlacementsPar site/app et domainePlacements énergivores
CI_CreativeSizePar dimensions créativesPoids du transfert de données
CI_AdFormatPar format (Display, Video, Native, Audio, Rich Media)Facteur de format
CI_VideoMétriques vidéo détaillées (durée, quartiles)Calcul carbone vidéo
CI_ExchangePar exchange (Google, Index, OpenX, etc.)🎯 Exclusif DV360
CI_ConnectionPar type de connexion (WiFi, 4G, 5G)🎯 Exclusif DV360
CI_EnvironmentPar environnement (Web, App, CTV)🎯 Exclusif DV360
CI_MetadataInformations d'export et de compteTraçabilité
CI_Export_CSVToutes les dimensions consolidéesImport direct CI
📁
Export CSV
Deux options disponibles
Option A — CSV automatique
Le script génère automatiquement les fichiers CSV dans OUTPUT_DIR
Option B — Google Sheets
Configurer SPREADSHEET_URL pour un export direct
🔗
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.
Avantages vs Google Ads
Dimensions exclusives DV360
Type de connexion (WiFi/4G/5G) — non disponible Google Ads
Exchanges multiples — non disponible Google Ads
Mode d'achat (Open/PMP/PG) — non disponible Google Ads
Environnement (Web/App/CTV) — non disponible Google Ads
🔧
Configuration avancée
Section CONFIG du script
# Dans le script, section CONFIG :

LOOKBACK_DAYS: 90,           # Jours d'historique
MIN_IMPRESSIONS: 10,          # Seuil minimum
INCLUDE_PAUSED: False,          # Campagnes en pause
OUTPUT_FORMAT: 'csv',          # csv ou sheets
🛠️
Résolution de problèmes
"Authentication failed"
Vérifiez le chemin vers le fichier JSON du compte de service dans SERVICE_ACCOUNT_PATH.
"API not enabled"
Activez l'API DV360 Reporting dans Google Cloud Console pour votre projet.
"Advertiser not found"
Vérifiez l'identifiant annonceur dans ADVERTISER_ID — doit correspondre à votre compte DV360.
Timeout
Réduisez LOOKBACK_DAYS à 30 jours si l'API prend trop de temps.
"No data"
Vérifiez que des campagnes actives existent pour la période. Augmentez LOOKBACK_DAYS si nécessaire.
💬
Support
Email support@carbonintelligence.green
Version script 1.0.0
Méthodologie GMSF v1.2 (Ad Net Zero)