Guía de exportación Amazon DSP — Script Python

GMSF v1.2 Amazon DSP 15 min install
🎯
Objetivo
Este script Python exporta automáticamente los datos de sus campañas Amazon DSP con la granularidad necesaria para el análisis de carbono GMSF v1.2 en Carbon Intelligence™. Amazon DSP ofrece datos únicos sobre las fuentes de inventario de Amazon (IMDb TV, Twitch, Fire TV, etc.).
⚙️
Installation
3 pasos · 15 minutos
Requisitos previos
  1. Python 3.8+ instalado en su máquina
  2. Instalar dependencias: pip install requests pandas
  3. Crear una aplicación en la Consola de desarrolladores de Amazon Ads
  4. Obtener sus credenciales: Client ID, Client Secret, Refresh Token
  5. Identificar su DSP Profile ID en la consola de Amazon Ads
Configurar
  1. Abrir el archivo carbon-intelligence-amazon-dsp-export.py
  2. Completar las variables de configuración al inicio del script:
    • • CLIENT_ID = su Client ID
    • • CLIENT_SECRET = su Client Secret
    • • REFRESH_TOKEN = su Refresh Token
    • • PROFILE_ID = su DSP Profile ID
  3. Establecer el directorio de salida en OUTPUT_DIR
Ejecutar
  1. Ejecutar el script: python carbon-intelligence-amazon-dsp-export.py
  2. Los datos exportados aparecen en OUTPUT_DIR
  3. Programar una ejecución regular mediante cron (Linux/macOS) o Programador de tareas (Windows)
📊
Qué se exporta
11 pestañas creadas automáticamente
PestañaContenidoUso Carbon Intelligence
CI_CampaignsPor order/line item + semanaVista general de emisiones
CI_DeviceDesktop, móvil, tablet, CTV, Fire TabletFactor energético por dispositivo
CI_GeoPor país y regiónMix energético país GMSF v1.2
CI_PlacementsPor fuente de inventarioUbicaciones de alto consumo energético
CI_CreativeSizePor tamaño de creatividadPeso de transferencia de datos
CI_AdFormatDisplay, Video, OLV, STV, Audio (formatos Amazon)Factor de formato publicitario
CI_VideoDatos de vídeo detallados (duración, cuartiles)Cálculo de carbono de vídeo
CI_SupplySourceInventario Amazon vs terceros🎯 Específico Amazon DSP
CI_EnvironmentContexto de distribuciónParámetros de distribución
CI_MetadataInformación de cuenta y exportaciónTrazabilidad y auditoría
CI_Export_CSVTodas las dimensiones consolidadasImportación directa plataforma CI
📁
Exportar CSV
Dos opciones disponibles
Los archivos CSV se generan automáticamente en el directorio especificado por OUTPUT_DIR después de cada ejecución del script. Puede importarlos directamente en Carbon Intelligence™ o integrarlos en su pipeline de datos.
🔗
Compartir con Carbon Intelligence™
📨
Comparta el Google Sheet con: support@carbonintelligence.green (accès lecteur)
O envíe el CSV exportado por email a la misma dirección.
🔧
Configuración avanzada
Sección CONFIG del script
# Variables de configuración avanzada:

LOOKBACK_DAYS: 90,                                      # Días de historial a exportar
MIN_IMPRESSIONS: 1,                                     # Umbral mínimo de impresiones por fila
REPORT_WAIT_SECONDS: 60,                                # Espera antes de obtener el informe
TOKEN_REFRESH_URL: 'https://api.amazon.com/auth/o2/token'
🛠️
Solución de problemas
"401 Unauthorized"
Su Refresh Token ha expirado o es inválido. Genere un nuevo token desde la Consola de desarrolladores de Amazon Ads y actualice REFRESH_TOKEN en el script.
"Profile not found"
Verifique que su PROFILE_ID sea correcto en la consola de Amazon Ads y corresponda a su perfil DSP.
"Report failed"
El informe no pudo ser generado. Verifique el rango de fechas y reduzca LOOKBACK_DAYS si el rango es demasiado grande.
"No access"
Verifique que los permisos de su aplicación y su perfil DSP permitan acceso a los informes. Contacte a su gestor de cuenta Amazon Ads si es necesario.
"Rate limit"
La API de Amazon Ads limita las solicitudes. Espere al menos 60 segundos entre ejecuciones del script, o aumente REPORT_WAIT_SECONDS.
💬
Soporte
Email support@carbonintelligence.green
Sitio web carbonintelligence.green
Versión del script 1.0.0
Metodología GMSF v1.2 (Ad Net Zero)
Carbon Intelligence™ — Guía de instalación Amazon DSP — v1.0.0
ISO 14064 GHG Protocol ADEME Base Carbone GMSF v1.2 Ad Net Zero