Carbon Intelligence · Connectez vos données

Notre plateforme a été conçue pour s'intégrer nativement à l'ensemble des DSP et plateformes publicitaires de l'écosystème adtech mondial. Ce guide vous accompagne pas à pas pour connecter vos plateformes publicitaires à Carbon Intelligence™ — en quelques minutes seulement.

1 Exporter Extrayez les données de votre DSP
2 Upload Envoyer vers Carbon Intelligence
3 Analyser Consultez les émissions par impression

Display & Video 360

Le DSP programmatique de Google — la source de données la plus riche pour l'analyse carbone avec un accès exclusif aux dimensions de type de connexion, d'exchange et d'environnement.

DV360 API v4 Dimensions exclusives GMSF v1.2

Dimensions disponibles

Campaign
IO, Line Item, Creative
Device
Desktop, Mobile, Tablet, CTV
Geography
Country, Region, City
Placements
Sites, Apps, URLs
Creative Size
Width × Height, Rich Media
Ad Format
Display, Video, Native, Audio
★ Exchange
SSP / inventory source
★ Connection Type
WiFi, 4G, 5G, Carrier
★ Environment
Web, In-App, CTV
1
Créer un rapport

Dans DV360, allez dans Reporting → Create Report.

2
Ajouter des dimensions

Sélectionnez les dimensions listees ci-dessus — incluez Exchange, Connection Type et Environment pour une granularité maximale.

3
Ajouter des métriques

Ajoutez Impressions, Clicks, Total Media Cost et tout autre KPI que vous suivez.

4
Exécuter et exporter en CSV

Exécutez le rapport et téléchargez-le en fichier CSV.

5
Uploader vers Carbon Intelligence

Glissez-déposez le CSV dans la plateforme Carbon Intelligence — vos données d'émissions seront prêtes en quelques secondes.

💡 Conseil : Inclure les dimensions Environment + Connection Type vous donne l'empreinte carbone la plus précise — elles sont exclusives à DV360 et impactent directement les calculs d'énergie par impression.
1
Installer Python et les dependances

Assurez-vous que Python 3.8+ est installe. Exécutez pip install google-api-python-client google-auth.

2
Créer un compte de service

Dans Google Cloud Console, créez un compte de service avec l'accès à l'API DV360 et le scope Display & Video 360.

3
Télécharger la clé JSON

Téléchargez le fichier de clé du compte de service et enregistrez-le en lieu sur. Vous référencerez ce chemin dans le script.

4
Configurer le script

Ouvrez le script et définissez votre ADVERTISER_ID, le chemin KEY_FILE et la plage de dates souhaitee.

5
Exécuter le script

Exécutez python carbon-intelligence-dv360-export.py. Le script extraira les données via l'API DV360 et générera un CSV prêt à être charge.

6
Planifier des executions hebdomadaires

Utilisez cron (Linux/Mac) ou le Planificateur de taches (Windows) pour automatisér les extractions hebdomadaires.

1
Activer BigQuery Data Transfer

Dans Google Cloud Console, activez le service BigQuery Data Transfer pour votre projet.

2
Créer une configuration de transfert DV360

Configurez un transfert planifie de DV360 vers BigQuery, en selectionnant les identifiants annonceur et les dimensions nécessaires.

3
Configurer le dataset de destination

Créez ou sélectionnez un dataset BigQuery pour recevoir les données DV360. Définissez la region et les politiques d'expiration appropriees.

4
Connecter BigQuery à Carbon Intelligence

Dans Carbon Intelligence, ajoutez une source de données BigQuery et authentifiez-vous avec vos identifiants Google Cloud.

5
Mapper les tables et planifier les synchronisations

Sélectionnez les tables à synchroniser et définissez la fréquence de rafraîchissement. Les données alimenteront automatiquement votre tableau de bord carbone.

🏢 Granularité maximale : BigQuery Data Transfer preserve toutes les dimensions DV360, y compris les champs exclusifs Exchange, Connection Type et Environment — vous offrant les calculs d'émissions les plus précis possibles.

Google Ads

Search, Display, Video, Performance Max — la plateforme publicitaire la plus utilisée. Les Google Ads Scripts natifs rendent l'automatisation fluide.

Google Ads Scripts BigQuery Transfer GMSF v1.2

Dimensions disponibles

Campaign
Name, ID, type, bidding
Device
Mobile, Desktop, Tablet
Geography
Country, Region
Placements
Sites, Apps, URLs
Creative Size
Ad type, image dimensions
Ad Format
Search, Display, Video, Discovery
Video
Duration, quartiles, view rate
Non disponible
Connection type, Exchange, Buy type
1
Ouvrir les rapports Google Ads

Naviguez vers Reports → Predefined reports dans votre compte Google Ads.

2
Sélectionner les dimensions

Ajoutez les dimensions Campaign, Device, Geography, Placements, Creative Size et Ad Format.

3
Ajouter des métriques

Incluez Impressions, Clicks, Cost et toute autre metrique que vous suivez.

4
Télécharger le CSV

Exécutez le rapport et téléchargez-le en fichier CSV.

5
Uploader vers Carbon Intelligence

Glissez-déposez le CSV dans la plateforme Carbon Intelligence.

Les Google Ads Scripts s'exécutent nativement dans Google Ads — aucune installation locale requise. Le script exporte les données vers un Google Sheet, que vous pouvez ensuite télécharger ou connecter directement.

1
Ouvrir Google Ads Scripts

Dans Google Ads, naviguez vers Tools & Settings → Scripts.

2
Créer un nouveau script

Cliquez sur le bouton + pour créér un nouveau script et collez le script d'export Google Ads de Carbon Intelligence.

3
Definir l'URL de votre Google Sheet

Créez un nouveau Google Sheet et collez son URL dans la variable SPREADSHEET_URL du script.

4
Autoriser et exécuter

Cliquez sur Authorize, puis Run. Le script remplira 9 onglets dans votre Google Sheet.

5
Planifier des executions hebdomadaires

Configurez le script pour s'exécuter chaque semaine sous Scripts → Frequency.

Onglets Google Sheet créés par le script

Nom de l'ongletContenu
CI_CampaignsDonnees au niveau campagne avec IDs, types et strategies d'encheres
CI_DeviceRepartition des performances par type d'appareil
CI_GeoPerformance geographique par pays et region
CI_PlacementsDetails des placements sur les sites et applications
CI_CreativeSizeDimensions des creations et types de publicités
CI_AdFormatRepartition Search, Display, Video, Discovery
CI_VideoQuartiles video, durée et taux de visionnage
CI_MetadataInformations du compte, plages de dates et metadonnées d'export
CI_Export_CSVExport combine prêt pour le téléchargement CSV
1
Activer BigQuery Data Transfer

Dans Google Cloud Console, activez le service BigQuery Data Transfer.

2
Associer votre compte Google Ads

Créez une configuration de transfert Google Ads, en associant votre compte Ads (MCC ou individuel) à BigQuery.

3
Configurer les tables et le calendrier

Sélectionnez les tables Google Ads à transférer et définissez le calendrier de rafraîchissement (quotidien recommandé).

4
Connecter BigQuery à Carbon Intelligence

Dans Carbon Intelligence, ajoutez BigQuery comme source de données et authentifiez-vous.

5
Mapper et synchroniser

Mappez les tables BigQuery aux dimensions Carbon Intelligence et activez la synchronisation automatique.

Meta Ads

Facebook, Instagram, Audience Network, Messenger — le plus grand écosystème de publicité sociale. Granularité unique sur les placements (Feed, Stories, Reels) et les impression devices réels.

Marketing API v19.0 Feed · Stories · Reels GMSF v1.2

Dimensions disponibles

Campaign
Campaign, Ad Set, Ad
Device Platform
Mobile, Desktop, Tablet
Geography
Country, Region
★ Placements
Feed, Stories, Reels, Right Column
Publisher Platform
Facebook, Instagram, AN, Messenger
Video
Quartiles p25–p100, avg watch time
★ Impression Device
iPhone, iPad, Android, Desktop
Creative
Ad name, format, dimensions
1
Ouvrir le Gestionnaire de publicités

Allez dans Meta Ads Manager et sélectionnez les campagnes que vous souhaitez analyser.

2
Personnaliser les colonnes

Cliquez sur Columns → Customize Columns et ajoutez les dimensions listees ci-dessus.

3
Ajouter des breakdowns

Utilisez Breakdown → By Delivery pour ajouter les breakdowns par Device, Platform, Placement et Impression Device.

4
Exporter en CSV

Cliquez sur Export → Export Table Data et choisissez le format CSV.

5
Uploader vers Carbon Intelligence

Chargez le CSV dans Carbon Intelligence pour une analyse instantanee des émissions.

💡 Impression Device: Meta est l'une des rares plateformes qui rapporte l'appareil réel utilise pour voir votre publicité (ex. iPhone 14, Galaxy S23) — cela permet à Carbon Intelligence de calculer la consommation d'énergie spécifique à l'appareil.

Utilisez l'API Marketing Meta v19.0 pour extraire programmatiquement les données de campagne avec toutes les breakdowns disponibles.

1
Créer une application Meta

Allez sur developers.facebook.com et créez une nouvelle application avec l'accès à l'API Marketing.

2
Generer un jeton à longue durée

Generez un jeton d'accès utilisateur systeme avec la permission ads_read sur les comptes publicitaires nécessaires.

3
Configurer le script

Définissez votre ACCESS_TOKEN, AD_ACCOUNT_ID et la plage de dates souhaitee dans le script.

4
Exécuter le script

Exécutez python carbon-intelligence-meta-ads-export.py. Le script gere automatiquement la pagination et les limites de debit.

5
Planifier et uploader

Planifiez l'execution hebdomadaire du script et chargez le CSV de sortie dans Carbon Intelligence.

Connectez Meta Ads à votre Data Warehouse via un connecteur ETL pour un flux de données automatisé en temps réel.

1
Choisir un connecteur ETL

Sélectionnez un connecteur compatible avec Meta Ads : Fivetran, Supermetrics, Funnel.io ou Adverity.

2
Authentifier Meta Ads

Connectez votre compte Meta Ads à l'outil ETL via OAuth. Sélectionnez les comptes publicitaires à synchroniser.

3
Configurer l'Data Warehouse de destination

Configurez votre Data Warehouse de destination (BigQuery, Snowflake, Redshift ou Databricks).

4
Sélectionner les tables et planifier

Choisissez les tables Meta Ads à synchroniser (insights campagne, breakdowns, rapports creatifs) et définissez la fréquence de synchronisation.

5
Connecter le warehouse a Carbon Intelligence

Associez votre Data Warehouse à Carbon Intelligence et mappez les tables Meta Ads aux dimensions carbone.

The Trade Desk

Le DSP indépendant leader — transparence programmatique complète avec les dimensions de type d'achat, fournisseur et environnement pour une analyse carbone granulaire.

REDS API v3 Open · PMP · PG GMSF v1.2

Dimensions disponibles

Campaign
Campaign, Ad Group, Creative
Device
Desktop, Mobile, Tablet, CTV
Geography
Country, Region, Metro
Domain / App
Sites, App bundles
Creative Size
Width × Height, format
Ad Format
Display, Video, Native, Audio, CTV
★ Supply Vendor
SSP / exchange source
★ Buy Type
Open Auction, PMP, PG
★ Environment
Web, App, CTV, DOOH
1
Ouvrir Mes rapports

Dans The Trade Desk, naviguez vers Analytics → My Reports.

2
Créer un nouveau rapport

Cliquez sur New Report et sélectionnez l'annonceur et la plage de dates.

3
Ajouter des dimensions et métriques

Ajoutez les dimensions listees ci-dessus, y compris Supply Vendor, Buy Type et Environment. Ajoutez les métriques Impressions et Cost.

4
Exporter en CSV

Exécutez le rapport et téléchargez-le au format CSV.

5
Uploader vers Carbon Intelligence

Chargez le CSV dans Carbon Intelligence.

Utilisez l'API REDS v3 de The Trade Desk pour exporter programmatiquement les données de rapport avec une granularité complète des dimensions.

1
Obtenir les identifiants API

Obtenez votre jeton API depuis la plateforme The Trade Desk sous Settings → API Tokens.

2
Configurer le script

Définissez votre API_TOKEN, PARTNER_ID et ADVERTISER_ID dans le script.

3
Exécuter le script

Exécutez python carbon-intelligence-thetradedesk-export.py. Le script interroge l'API REDS et généré un CSV.

4
Planifier et uploader

Automatisez avec un planificateur et chargez la sortie dans Carbon Intelligence.

Connectez les données au niveau log de The Trade Desk ou utilisez un connecteur ETL pour une intégration basée sur un Data Warehouse.

1
Activer les données au niveau log

Contactez votre responsable de compte TTD pour activer la livraison des données au niveau log (LLD) vers votre stockage cloud (S3, GCS ou Azure Blob).

2
Configurer le stockage et l'ingestion

Configurez votre bucket cloud et paramétrez votre Data Warehouse pour ingérer les fichiers LLD selon un calendrier.

3
Transformer et agréger

Construisez des vues SQL ou des modèles dbt pour agréger les données au niveau log dans les dimensions nécessaires pour Carbon Intelligence.

4
Connecter a Carbon Intelligence

Associez votre Data Warehouse à Carbon Intelligence et mappez les tables agrégées aux dimensions carbone.

Amazon DSP

Acces à l'inventaire exclusif d'Amazon — IMDb TV, Twitch, Fire TV, Prime Video Ads. Dimension unique de source d'approvisionnement séparant l'inventaire propriété d'Amazon de l'inventaire tiers.

Unified Reporting API OLV · STV · Audio GMSF v1.2

Dimensions disponibles

Campaign
Order, Line Item, Creative
Device
Desktop, Mobile, Tablet, CTV, Fire TV
Geography
Country, State, DMA
Creative Size
Dimensions, format type
★ Supply Source
Amazon-owned vs 3rd party
★ Ad Format
Display, OLV, STV, Audio
Environment
Web, App, Streaming
Video
Completions, quartiles, VAST errors
1
Ouvrir les rapports Amazon DSP

Dans Amazon DSP, naviguez vers Measurement & Reporting → Reports.

2
Créer un nouveau rapport

Cliquez sur Create Report et sélectionnez votre annonceur, la plage de dates et le type de rapport.

3
Ajouter des dimensions et métriques

Sélectionnez toutes les dimensions disponibles, y compris Supply Source et Ad Format. Ajoutez les métriques Impressions et Total Cost.

4
Télécharger le CSV

Exécutez le rapport et téléchargez-le au format CSV.

5
Uploader vers Carbon Intelligence

Chargez le CSV dans Carbon Intelligence.

💡 Supply Source: Amazon DSP séparé de maniere unique l'inventaire propriété d'Amazon (IMDb TV, Twitch, Fire TV) de l'inventaire tiers — cette distinction est essentielle pour une modelisation carbone précise car les propriétés d'Amazon ont des profils d'infrastructure significativement differents.

Utilisez l'API Amazon Ads pour extraire programmatiquement les données de reporting d'Amazon DSP.

1
S'inscrire à l'API Amazon Ads

Allez sur le portail developpeur Amazon Ads et enregistrez votre application. Demandez l'accès au scope de reporting DSP.

2
Configurer l'authentification

Configurez les identifiants OAuth 2.0 — vous aurez besoin d'un CLIENT_ID, CLIENT_SECRET et REFRESH_TOKEN.

3
Configurer le script

Définissez vos identifiants, PROFILE_ID et la plage de dates dans le script.

4
Exécuter le script

Exécutez python carbon-intelligence-amazon-dsp-export.py. Le script effectue la requête, interroge et telecharge le rapport automatiquement.

5
Planifier et uploader

Automatisez les executions hebdomadaires et chargez le CSV de sortie dans Carbon Intelligence.

Utilisez Amazon Marketing Cloud (AMC) pour le niveau d'intégration de données Amazon DSP le plus approfondi.

1
Demander l'accès à AMC

Contactez votre equipe de compte Amazon Ads pour provisionner une instance Amazon Marketing Cloud pour votre annonceur.

2
Écrire des requêtes SQL

Dans l'interface AMC, ecrivez des requêtes SQL pour agréger les données DSP au niveau impression selon les dimensions nécessaires.

3
Exporter vers S3

Configurez AMC pour envoyer les resultats des requêtes vers un bucket S3 que vous controlez.

4
Ingérer dans votre Data Warehouse

Chargez les données S3 dans votre Data Warehouse (Redshift, Snowflake, BigQuery ou Databricks).

5
Connecter a Carbon Intelligence

Associez votre Data Warehouse à Carbon Intelligence et mappez les tables de sortie AMC.

🏢 AMC clean room: Amazon Marketing Cloud fonctionne comme une clean room respectueuse de la vie privee — vos requêtes s'exécutent sur des données au niveau impression mais les resultats sont agreges, assurant la conformite tout en donnant à Carbon Intelligence la granularité nécessaire pour des calculs d'émissions précis.
🌐

Autres Plateformes

Xandr, Yahoo DSP, TikTok Ads, Spotify Ads, Pinterest Ads, Snapchat Ads, LinkedIn Ads et toute autre plateforme publicitaire — Carbon Intelligence™ analyse n'importe quelles données de campagne via import CSV.

Exportez vos données de campagne depuis n'importe quel DSP ou plateforme publicitaire au format CSV. Carbon Intelligence corrèle votre empreinte carbone avec les performances publicitaires (clics, conversions, vues vidéo, revenus) pour prouver que la réduction carbone améliore les résultats. Plus vous incluez de dimensions, plus votre analyse carbone et performance sera précise.

📊 Impact sur la précision des calculs

Dimension Impact Pourquoi c'est important
🔴 Obligatoire
Impressions
100%
Base de tout calcul carbone — une impression = un événement énergétique
Pays / Région
90%
Détermine le mix énergétique (gCO₂/kWh) — une impression en France émet ~10× moins qu'en Pologne
Date
85%
Analyse temporelle, variations saisonnières du mix énergétique
Campagne
80%
Segmentation & reporting — attribuer les émissions par campagne
Coût / Spend
75%
Analyse d'allocation budgétaire, optimisation coût-par-gramme
Clics
70%
Métrique de performance clé — permet le calcul du CTR et l'optimisation carbone par clic
🟡 Recommandé
Type d'appareil
65%
Mobile vs Desktop vs CTV — la consommation d'énergie varie de ×3 à ×8
Placement / Site
55%
Le poids du site impacte directement le transfert de données — un site lourd vs léger = ×4 énergie
Format publicitaire
45%
Video vs Display vs Native — une pub vidéo consomme jusqu'à ×8 plus d'énergie qu'un banner
Conversions
60%
Prouve que la réduction carbone améliore les résultats — le carbone par conversion est la métrique d'efficacité ultime
Vues vidéo
50%
Les pubs vidéo consomment ×8 plus d'énergie que le display — tracker les vues et complétions permet une analyse carbone par format
🟢 Optionnel (améliore la précision)
Type de connexion
35%
WiFi vs 4G vs 5G — les réseaux mobiles consomment ×3,5 plus d'énergie par octet que le WiFi
Taille de la créa
25%
300×250 vs interstitiel pleine page — poids des données et énergie de rendu
Environnement
20%
Web vs In-App vs CTV — pipelines de rendu et infrastructures différents
Source d'inventaire
15%
Direct vs Programmatique vs Éditeur — la longueur de la supply chain impacte les émissions

📋 Comment préparer votre CSV

1
Exporter depuis votre plateforme

Accédez à la section reporting de votre plateforme et créez un rapport personnalisé. Incluez autant de dimensions du tableau ci-dessus que possible.

2
Vérifier les colonnes obligatoires

Votre CSV doit inclure au minimum : Date, Campaign, Impressions, Clicks, Cost et Country. Pour une analyse de performance complète, ajoutez aussi Conversions et Video Views. Sans le pays, le mix énergétique utilise une moyenne mondiale et perd en précision.

3
Exporter en CSV

Téléchargez le rapport au format CSV. Assurez-vous que la première ligne contient les en-têtes de colonnes.

4
Uploader vers Carbon Intelligence™

Glissez-déposez votre CSV dans la plateforme. Le moteur détecte automatiquement les colonnes, normalise les en-têtes et lance l'analyse carbone.

💡 Conseil : Plus vous incluez de dimensions dans votre CSV, plus le calcul carbone sera précis. Le pays est critique — il détermine le mix énergétique qui peut faire varier le résultat d'un facteur 10. Incluez-le systématiquement.

Choisissez votre niveau d'intégration

Trois façons de se connecter

📄

Import CSV

~2 min
  • Aucune configuration technique requise
  • Export manuel depuis l'interface DSP
  • Chargement par glisser-deposer
  • Idéal pour les analyses ponctuelles
  • Idéal pour demarrer rapidement

Script API

~10 min
  • Extraction de données automatisée
  • Scripts pre-construits pour chaque DSP
  • Planifiez des executions hebdomadaires ou quotidiennes
  • Formatage cohérent garanti
  • Idéal pour le suivi continu
🏢

Data Warehouse

Temps réel
  • Connexion directe au warehouse
  • Synchronisation en temps réel ou quasi temps réel
  • Granularité maximale des données
  • Fiabilite de niveau entreprise
  • Idéal pour les opérations à grande échelle