Informe HTML offline de Amazon Ads

Qué hace

La Skill original de GGRN se llama amazon-ads-analyzer; esta entrada del directorio presenta su caso de uso para informes offline. Convierte exportaciones de publicidad de Amazon aportadas por el vendedor en un informe HTML autocontenido y revisable. El flujo separa filas observadas, métricas calculadas, supuestos y notas de confianza. Está pensado para revisar offline ACOS, TACOS, ROAS, CTR, CVR, CPC, CPM y ACOS de equilibrio, y después compartir el informe de forma controlada. No inicia sesión en Amazon, no obtiene la consola de Ads ni Business Reports del vendedor, no cambia pujas, no lanza campañas ni publica contenido.

Cuándo usarlo

Úsalo cuando el informe ya existe localmente y el equipo necesita una revisión semanal o mensual repetible, una entrega a finanzas, una comparación antes/después o un material de decisión compartible. Es más amplio que un diagnóstico PPC corto de términos de búsqueda en CSV: resume evidencia de cuenta o campaña junto con la economía unitaria. Para obtener informes actuales, empieza con Amazon Ads Report Downloader; si ya tienes un CSV de términos de búsqueda, usa Amazon PPC Analyzer para el diagnóstico y después esta skill para crear el archivo offline.

Entradas

Acepta una exportación XLSX o CSV de Amazon, una captura de pantalla o métricas pegadas. Registra sitio o marketplace, tipo Seller o Vendor, nombre del informe, fechas y zona horaria, moneda, alcance de campañas/SKU/ASIN, objetivo, ACOS objetivo, precio, COGS, coste FBA o de cumplimiento, comisión por referencia, reembolsos o devoluciones y ventas totales. Marca cada valor como observado, derivado o supuesto. Las capturas y los valores pegados requieren transcripción y conciliación manual.

Salidas

El flujo de origen nombra dos archivos locales: report-data.json para datos normalizados y AMAZON-ADS-REPORT.html para la vista autocontenida generada. Un informe útil incluye entradas de las fórmulas, ACOS/TACOS/ROAS, métricas de eficiencia, ACOS de equilibrio, alcance temporal y de marketplace, etiquetas de confianza y notas sobre denominadores ausentes. El HTML puede abrirse offline y solo debe compartirse después de quitar IDs de cuenta, ASIN, nombres de campañas y otros datos sensibles. Esta entrada del directorio no ha generado esos archivos.

Flujo de ejemplo

Solo demostración; no ejecutado. Los valores desidentificados siguientes son inventados para mostrar la aritmética; no son una exportación de Amazon, una respuesta API ni un registro de ejecución real:

seller_ads:
  marketplace: US
  period: 2026-08-01/2026-08-31
  impressions: 500000
  clicks: 10000
  orders: 400
  ad_sales_usd: 10000
  spend_usd: 2000
  total_sales_usd: 20000
unit_economics:
  price_usd: 40
  cogs_usd: 12
  fulfillment_usd: 7
  referral_fee_usd: 6
market_report_context:
  source: hypothetical market-side report context
  keyword: insulated bottle
  estimated_searches: 120000
  sponsored_traffic_share: 0.08

Con esos supuestos, ACOS es 2,000 / 10,000 = 20%, ROAS es 10,000 / 2,000 = 5.0 y TACOS es 2,000 / 20,000 = 10%. CTR es 10,000 / 500,000 = 2%, CVR es 400 / 10,000 = 4%, CPC es $2,000 / 10,000 = $0.20 y CPM es $2,000 / 500,000 * 1,000 = $4.00. El ACOS de equilibrio es ($40 - $12 - $7 - $6) / $40 = 37.5%. El contexto de mercado permanece como anotación separada: no demuestra el rendimiento del vendedor ni completa un campo de vendedor ausente. Aquí no se produjo ningún report-data.json, HTML ni respuesta de una API de mercado.

La fuente documenta este comando; se reproduce como referencia y no se ejecutó durante la revisión:

python scripts/build_report.py --data report-data.json --out AMAZON-ADS-REPORT.html

Agentes compatibles y configuración

La fuente fijada nombra Claude Code, Codex, Cursor, Windsurf, Gemini y Goose. La evidencia revisada el 2026-09-15 incluye el SKILL.md inmutable, su commit, la LICENCIA MIT y la entrada del directorio skills.sh. La LICENSE también contiene un aviso de no afiliación y marcas de Amazon. La instalación es manual: revisa la fuente fijada y sigue después el README del autor. Esta entrada es source-reviewed, no install-tested, y no muestra un comando de instalación.

Cuenta, API y permisos

La ruta offline necesita lectura/escritura del sistema de archivos local y ejecución de shell para el script de informe documentado. Esta entrada no exige una cuenta de Amazon ni una API key. Si el operador obtuvo el archivo desde una cuenta de vendedor autenticada, esa autenticación ocurrió fuera de la skill. Cualquier llamada a Ecommerce Data API tiene sus propios requisitos de cuenta y credenciales y debe aprobarse por separado.

Límites y revisión humana

Las proporciones solo son válidas si coinciden el periodo, la moneda, el marketplace, la ventana de atribución y el alcance. ACOS divide gasto publicitario entre ventas atribuidas a anuncios; TACOS divide gasto publicitario entre ventas totales; el ACOS de equilibrio depende de los costes variables, reembolsos, impuestos y descuentos incluidos. Los informes Seller y Vendor pueden tener campos distintos, y los retrasos o denominadores ausentes pueden cambiar la decisión. Las capturas y métricas pegadas no se validan automáticamente. La confianza es una etiqueta de trazabilidad, no una prueba estadística ni una verificación de seguridad. Revisa los cálculos y elimina datos sensibles antes de compartir; no deduzcas rentabilidad garantizada ni autorices cambios de puja solo por el HTML.

Combinar con Ecommerce Data API

Con aprobación independiente, amazon.keywords.research puede aportar demanda, crecimiento, competencia, conversión o contexto PPC de palabras clave; amazon.traffic.sources puede aportar la composición de fuentes de tráfico; y amazon.keywords.traffic-stats puede aportar estadísticas agregadas de palabras clave de tráfico para un ASIN. Consulta antes la documentación canónica de investigación de palabras clave y la documentación de fuentes de tráfico; para ese contexto de mercado en vivo y opcional, crea una clave de Ecommerce Data API, aunque el informe offline no necesita esa clave. Son interfaces de contexto de mercado. No leen la consola privada de publicidad del vendedor, sus informes publicitarios ni Business Reports. Conserva junto a la exportación el momento, marketplace y origen de cada respuesta API, y nunca trates una estimación de mercado como rendimiento publicitario real.