Guida all'esportazione Amazon DSP — Script Python

GMSF v1.2 Amazon DSP 15 min install
🎯
Obiettivo
Questo script Python esporta automaticamente i dati delle vostre campagne Amazon DSP con la granularità necessaria per l'analisi del carbonio GMSF v1.2 in Carbon Intelligence™. Amazon DSP offre dati unici sulle fonti di inventario Amazon (IMDb TV, Twitch, Fire TV, ecc.).
⚙️
Installation
3 passaggi · 15 minuti
Prerequisiti
  1. Python 3.8+ installato sulla vostra macchina
  2. Installare le dipendenze: pip install requests pandas
  3. Creare un'applicazione nella Console sviluppatori Amazon Ads
  4. Ottenere le vostre credenziali: Client ID, Client Secret, Refresh Token
  5. Identificare il vostro DSP Profile ID nella console Amazon Ads
Configurare
  1. Aprire il file carbon-intelligence-amazon-dsp-export.py
  2. Compilare le variabili di configurazione all'inizio dello script:
    • • CLIENT_ID = il vostro Client ID
    • • CLIENT_SECRET = il vostro Client Secret
    • • REFRESH_TOKEN = il vostro Refresh Token
    • • PROFILE_ID = il vostro DSP Profile ID
  3. Impostare la directory di output in OUTPUT_DIR
Eseguire
  1. Eseguire lo script: python carbon-intelligence-amazon-dsp-export.py
  2. I dati esportati appaiono in OUTPUT_DIR
  3. Pianificare un'esecuzione regolare tramite cron (Linux/macOS) o Utilità di pianificazione (Windows)
📊
Cosa viene esportato
11 schede create automaticamente
SchedaContenutoUtilizzo Carbon Intelligence
CI_CampaignsPer order/line item + settimanaPanoramica delle emissioni
CI_DeviceDesktop, mobile, tablet, CTV, Fire TabletFattore energetico per dispositivo
CI_GeoPer paese e regioneMix energetico paese GMSF v1.2
CI_PlacementsPer fonte di inventarioPosizionamenti ad alto consumo energetico
CI_CreativeSizePer dimensione della creativitàPeso del trasferimento dati
CI_AdFormatDisplay, Video, OLV, STV, Audio (formati Amazon)Fattore formato pubblicitario
CI_VideoDati video dettagliati (durata, quartili)Calcolo carbonio video
CI_SupplySourceInventario Amazon vs terze parti🎯 Specifico Amazon DSP
CI_EnvironmentContesto di distribuzioneParametri di distribuzione
CI_MetadataInformazioni account ed esportazioneTracciabilità e audit
CI_Export_CSVTutte le dimensioni consolidateImportazione diretta piattaforma CI
📁
Esportazione CSV
Due opzioni disponibili
I file CSV vengono generati automaticamente nella directory specificata da OUTPUT_DIR dopo ogni esecuzione dello script. Potete importarli direttamente in Carbon Intelligence™ o integrarli nella vostra pipeline di dati.
🔗
Condivisione con Carbon Intelligence™
📨
Condividi il Google Sheet con: support@carbonintelligence.green (accès lecteur)
Oppure invia il CSV esportato per email allo stesso indirizzo.
🔧
Configurazione avanzata
Sezione CONFIG dello script
# Variabili di configurazione avanzata:

LOOKBACK_DAYS: 90,                                      # Giorni di storico da esportare
MIN_IMPRESSIONS: 1,                                     # Soglia minima di impressions per riga
REPORT_WAIT_SECONDS: 60,                                # Attesa prima del recupero del report
TOKEN_REFRESH_URL: 'https://api.amazon.com/auth/o2/token'
🛠️
Risoluzione dei problemi
"401 Unauthorized"
Il vostro Refresh Token è scaduto o non è valido. Generate un nuovo token dalla Console sviluppatori Amazon Ads e aggiornate REFRESH_TOKEN nello script.
"Profile not found"
Verificate che il vostro PROFILE_ID sia corretto nella console Amazon Ads e corrisponda al vostro profilo DSP.
"Report failed"
Il report non è stato generato. Verificate l'intervallo di date e riducete LOOKBACK_DAYS se l'intervallo è troppo ampio.
"No access"
Verificate che i permessi della vostra applicazione e il vostro profilo DSP consentano l'accesso ai report. Contattate il vostro account manager Amazon Ads se necessario.
"Rate limit"
L'API Amazon Ads limita le richieste. Attendete almeno 60 secondi tra le esecuzioni dello script, o aumentate REPORT_WAIT_SECONDS.
💬
Supporto
Email support@carbonintelligence.green
Sito web carbonintelligence.green
Versione script 1.0.0
Metodologia GMSF v1.2 (Ad Net Zero)
Carbon Intelligence™ — Guida all'installazione Amazon DSP — v1.0.0
ISO 14064 GHG Protocol ADEME Base Carbone GMSF v1.2 Ad Net Zero