Plantilla de reporte mensual con IA para agencias: el harness con compuerta de cifras, listo para descargar

¿Qué herramientas automatizan el informe mensual de clientes para una agencia?

Antes de bajar la plantilla conviene saber en qué familia estás. Son tres; los nombres salen del mismo dataset que la tabla de la guía de reportes, donde está el precio que cada proveedor publica, por qué unidad cobra y si la IA viene incluida, leídos el 2026-10-19. Acá no se repiten precios: cambian seguido y la fecha de lectura va con ellos.

Ninguna de las herramientas de la tabla verifica por vos que cada cifra del texto exista en la tabla de datos: esa compuerta es lo que especifica esta plantilla, y sirve con cualquiera de las tres familias.

El flujo, paso por paso, y quién firma

Diez pasos. El código ejecuta siete; el modelo, uno; las personas firman tres veces: la configuración, la aprobación y el envío. Nada llega al cliente sin una firma humana, y ninguna cifra llega al modelo sin pasar por el código.

Campos de entrada: tipo, fuente y nombre en la API

Cada cifra del reporte entra por uno de estos campos, con el nombre exacto que tiene en la API de su plataforma (verificado el 2026-09-17; los enlaces van a la documentación). «Si falta» dice qué hace la compuerta: bloquea (no hay reporte), sin-dato (la sección dice «sin dato este mes» y el modelo no puede rellenarla) u omite (la sección desaparece y el anexo lo declara).

Metadatos del reporte

Google Ads · Google Ads API (GoogleAdsService.SearchStream, GAQL)

Meta Ads · Marketing API · Insights (/act_<id>/insights)

GA4 · Google Analytics Data API (runReport)

Search Console · Search Console API (searchanalytics.query)

Tipos

• entero: Número entero ≥ 0.
• decimal: Número con decimales ≥ 0; se publica con un decimal.
• moneda: Importe ≥ 0 en la moneda de la cuenta; se publica con dos decimales y el código ISO.
• fraccion: Número entre 0 y 1 tal como lo devuelve la API; el código lo convierte a porcentaje.
• texto: Cadena no vacía.
• fecha: Fecha ISO (YYYY-MM-DD).
• tabla: Lista de filas con claves fijas; cada celda numérica se valida con el tipo de su columna.

Derivados: los calcula el código, nunca el modelo

• google_ads.ctr_pct = clics ÷ impresiones × 100 (decimal)
• google_ads.cpc = costo ÷ clics (moneda)
• google_ads.cpa = costo ÷ conversiones (null si conversiones = 0) (moneda)
• meta_ads.ctr_pct = clics ÷ impresiones × 100 (decimal)
• meta_ads.cpc = inversión ÷ clics (moneda)
• meta_ads.costo_por_resultado = inversión ÷ resultados (null si resultados = 0) (moneda)
• ga4.tasa_interaccion_pct = tasa_interaccion × 100 (decimal)
• gsc.ctr_pct = ctr × 100 (decimal)
• inversion_total = google_ads.costo + meta_ads.inversion (moneda)
• participacion_google_pct = google_ads.costo ÷ inversion_total × 100 (decimal)
• variacion.<campo>_pct = (mes − mes_anterior) ÷ mes_anterior × 100, por cada campo numérico presente en ambos meses (decimal)

Entrada de ejemplo (paso 2), tal como la produce el extractor

Cliente y cifras inventados para el ejemplo. Pasa la compuerta de entrada: OK; secciones omitidas por campos opcionales ausentes: 3.

{
  "cliente": "Cliente de ejemplo S.A.",
  "periodo": {
    "anio": 2026,
    "mes": 8
  },
  "moneda": "MXN",
  "objetivos": "Bajar el costo por lead de pauta y sostener el tráfico orgánico durante la temporada baja.",
  "acciones_del_mes": "Rehicimos las tres landings de captación y pausamos el conjunto de anuncios de remarketing amplio en Meta.",
  "google_ads": {
    "extraido_el": "2026-09-02",
    "metodo": "api",
    "costo": 48250.75,
    "impresiones": 412380,
    "clics": 9814,
    "conversiones": 236.5,
    "valor_conversiones": null
  },
  "meta_ads": {
    "extraido_el": "2026-09-03",
    "metodo": "api",
    "ventana_atribucion": "7d_click,1d_view",
    "inversion": 31900.2,
    "impresiones": 1284500,
    "clics": 15320,
    "alcance": 402110,
    "frecuencia": 3.19,
    "resultados": 412,
    "tipo_resultado": "lead"
  },
  "ga4": {
    "extraido_el": "2026-09-02",
    "metodo": "api",
    "sesiones": 58420,
    "usuarios_activos": 44190,
    "eventos_clave": 1385,
    "tasa_interaccion": 0.6132,
    "sesiones_por_canal": null
  },
  "gsc": {
    "extraido_el": "2026-09-02",
    "metodo": "api",
    "clics": 21870,
    "impresiones": 1093500,
    "ctr": 0.02,
    "posicion_media": 14.6,
    "consultas_top": null
  },
  "mes_anterior": {
    "google_ads": {
      "costo": 45100.4,
      "impresiones": 398200,
      "clics": 9120,
      "conversiones": 201
    },
    "meta_ads": {
      "inversion": 33410.9,
      "impresiones": 1310200,
      "clics": 14890,
      "resultados": 355
    },
    "ga4": {
      "sesiones": 60120,
      "usuarios_activos": 45510,
      "eventos_clave": 1412
    },
    "gsc": {
      "clics": 22310,
      "impresiones": 1080900
    }
  }
}

La compuerta de cifras, especificada

Antes de que el modelo vea nada (7 validaciones)

1. Cada campo obligatorio existe y tiene el tipo declarado (entero, decimal, moneda, fracción, texto, fecha).
2. Cada fuente trae fecha de extracción, método «api» y, en Meta Ads, la ventana de atribución usada.
3. Las fracciones están entre 0 y 1; los enteros y los importes no son negativos; los importes vienen en la moneda declarada (Google Ads ya dividido por 1.000.000).
4. Los derivados se recalculan en código y, si la API también los devuelve (ctr, average_cpc), se comparan: una discrepancia mayor que la tolerancia detiene la corrida como bug de extracción.
5. Las variaciones contra el mes anterior solo se calculan cuando el mes anterior existe en el registro; si no existe, la columna dice SIN DATO y no se pide al modelo que la estime.
6. Fecha de extracción dentro de la ventana permitida (≥ día 2 o 3 del mes siguiente, ≤ 7 días antes de la corrida).
7. Ninguna dimensión demográfica en el pedido a GA4 (evita filas retenidas por umbral) y dataState final en Search Console.

Después de que el modelo redacta (6 validaciones)

1. Se extrae cada número del texto generado (con separadores de miles y decimales en español o inglés, con o sin símbolo de porcentaje o de moneda).
2. Cada número se busca en la tabla final (entrada + derivados + metadatos del periodo) con la tolerancia declarada; el signo se ignora en la comparación y se verifica aparte con el sentido de la frase.
3. Si alguna cifra no aparece en la tabla, el borrador se rechaza y se regenera una vez con la lista de cifras huérfanas en el prompt; a la segunda falla se escala a una persona.
4. El texto no puede contener las palabras «aproximadamente», «alrededor de», «estimamos» ni «cerca de» delante de una cifra: si la tabla tiene el número, se escribe el número.
5. Las secciones marcadas SIN DATO en la tabla tienen que decir «sin dato este mes» en el texto; una sección redactada sobre un campo SIN DATO se rechaza.
6. Se registran por corrida: cifras verificadas, cifras rechazadas, reintentos, tiempo de máquina y quién aprobó.

Tolerancias y reintentos

Una cifra del texto coincide con una de la tabla si la diferencia absoluta es ≤ 0.05 o la relativa ≤ 0.1 %; para valores de la tabla menores que uno (tasas como fracción) rige solo la relativa. Reintentos antes de escalar a una persona: 1. Los tres valores son criterio propio, no salen de ninguna fuente; están listados más abajo con los demás supuestos nuestros para que los ajustes.

Qué pasa si falta un dato

Probá la compuerta con la tabla de ejemplo

El texto de abajo es una narrativa que pasa: sus 8 cifras están en la tabla del ejemplo (entrada + derivados + variaciones). Editalo, cambiá un número o cargá el ejemplo que no pasa (2 cifras huérfanas y 1 muletilla) y verificá. Corre en tu navegador con la misma función que va en el JSON.

El prompt de narrativa, en español

No contiene ningún número: todas las cifras entran por {{tabla}}, ya formateadas por el código. Variables:

• {{cliente}}: Nombre del cliente tal como figura en la configuración.
• {{periodo}}: Mes y año en palabras (p. ej. «agosto de este año»), generados por código.
• {{tabla}}: La tabla final validada, en JSON, con cada cifra ya formateada como debe aparecer (separadores, decimales, moneda).
• {{anomalias}}: Lista de hechos anómalos marcados por el código, con campo, valor y umbral.
• {{objetivos}}: Objetivos del trimestre acordados con el cliente, o SIN DATO.
• {{acciones_del_mes}}: Texto del account manager sobre qué hizo la agencia, o SIN DATO.
• {{tono}}: Guía de tono del cliente (tratamiento, palabras prohibidas, nivel técnico).
• {{secciones_sin_dato}}: Secciones que la compuerta marcó SIN DATO u omitió.

Sos el analista de una agencia de marketing que redacta el reporte mensual de {{cliente}} correspondiente a {{periodo}}. Escribís en español neutro, para el dueño o el gerente de marketing del cliente.

REGLA CENTRAL. Solo podés usar las cifras que figuran en la tabla de abajo, escritas exactamente como figuran ahí (mismos separadores, mismos decimales, misma moneda). No calculés nada: ni sumas, ni promedios, ni porcentajes, ni redondeos. No completés lo que falta. Si una sección figura en {{secciones_sin_dato}}, escribí «sin dato este mes» y el motivo que indica la tabla, sin estimar.

PROHIBIDO. Escribir «aproximadamente», «alrededor de», «cerca de» o «estimamos» delante de una cifra. Prometer resultados futuros. Recomendar aumentar o bajar presupuesto salvo que {{objetivos}} lo mencione como opción. Inventar causas: toda explicación de una anomalía se escribe como hipótesis («una hipótesis es que…») para que el account manager la confirme o la reemplace.

ESTRUCTURA. Ocho secciones, en este orden y con estos títulos: Resumen ejecutivo; Pauta: Google Ads; Pauta: Meta Ads; Orgánico: Search Console y Google Analytics; Anomalías y explicación; Qué hicimos este mes; Próximos pasos; Anexo: cifras y fuentes.

- Resumen ejecutivo: tres frases como máximo, cada una con una cifra y su variación respecto del mes anterior si la tabla la trae.
- Secciones de pauta y orgánico: primero las cifras de la tabla en el orden en que aparecen; después una lectura de dos frases; después una recomendación como máximo, marcada como «propuesta para revisar».
- Meta Ads: al pie de la sección, escribí la ventana de atribución que figura en la tabla y que la inversión es la estimada por la plataforma.
- Anomalías: una por párrafo, tomadas de {{anomalias}}; primero el hecho con su cifra, después la hipótesis.
- Qué hicimos este mes: transcribí {{acciones_del_mes}} corrigiendo solo ortografía.
- Próximos pasos: entre dos y cuatro puntos coherentes con {{objetivos}}.
- Anexo: no lo redactés; escribí «[el anexo lo genera el sistema]».

TONO. {{tono}}. Frases cortas. Sin adjetivos de entusiasmo. Sin signos de exclamación.

TABLA (única fuente de cifras):
{{tabla}}

ANOMALÍAS MARCADAS POR EL SISTEMA:
{{anomalias}}

Cuando termines, releé el texto y borrá cualquier número que no puedas señalar en la tabla.

Estructura del reporte que recibe el cliente

Checklist anti-alucinación (12 puntos verificables)

Los primeros los verifica el código y deja el resultado en el registro de la corrida; los últimos los verifica el account manager antes de firmar. Están pensados para que un reporte con una cifra inventada no pueda salir aunque todos tengan prisa.

1. Cada cifra del texto se encuentra en la tabla final con la tolerancia declarada (lo verifica el código; el resultado queda en el registro). (verifica: código)
2. Ningún número entró por captura de pantalla, copia manual o memoria: todos los campos tienen fecha de extracción y método «api». (verifica: código)
3. Los importes de Google Ads fueron divididos por un millón antes de la tabla y la moneda coincide con la de la cuenta. (verifica: código)
4. Las variaciones porcentuales las calculó el código contra la corrida anterior guardada, no el modelo contra un número recordado. (verifica: código)
5. La ventana de atribución de Meta figura al pie de su sección y es la misma que en la configuración del cliente. (verifica: código + persona)
6. Las cifras de Meta se extrajeron después del segundo día del mes siguiente y el anexo avisa que pueden revisarse durante veintiocho días. (verifica: código)
7. Ninguna sección redacta sobre un campo marcado SIN DATO; las secciones omitidas están declaradas en el anexo. (verifica: código)
8. No aparece «aproximadamente», «alrededor de», «cerca de» ni «estimamos» delante de una cifra. (verifica: código)
9. Cada anomalía del texto existe en la lista que marcó el código, y cada explicación está escrita como hipótesis. (verifica: persona)
10. No hay promesas de resultado ni recomendaciones de presupuesto que el account manager no haya habilitado. (verifica: persona)
11. El texto de «Qué hicimos este mes» es el del account manager, no una reconstrucción del modelo. (verifica: persona)
12. El reporte lo aprueba y lo envía una persona con su nombre; el registro de la corrida guarda quién, cuándo y qué editó. (verifica: persona)

Lo que es criterio propio

• tolerancia: Una cifra del texto coincide con una de la tabla si la diferencia absoluta es ≤ 0,05 o la relativa ≤ 0,1 %. Para valores de la tabla menores que uno (tasas como fracción) rige solo la relativa. Permite el redondeo a un decimal que pide el prompt y rechaza «unos 4.300» cuando la tabla dice 4.320,45.
• reintentos: Ante una cifra no encontrada el borrador se regenera una vez con el error señalado; a la segunda falla se escala al analista. Más reintentos gastan tokens sin mejorar el texto.
• dia_extraccion: Meta Ads se extrae desde el día 3 del mes siguiente porque sus métricas «pueden seguir actualizándose un par de días» después de terminar un anuncio; las demás fuentes, desde el día 2. El día exacto es criterio nuestro; el motivo está en la documentación citada.
• antiguedad: Una extracción de más de 7 días respecto de la corrida bloquea el reporte: se vuelve a extraer. El plazo es criterio nuestro.
• anomalias: Los umbrales de anomalía por defecto (±30 % mensual en costo por resultado, canal que cae a cero, CTR que se duplica o se reduce a la mitad) son puntos de partida para que el account manager los ajuste por cliente; no salen de ningún estudio.
• longitud: Resumen ejecutivo de tres frases como máximo y una recomendación por canal como máximo: lo que el account manager puede leer y firmar en diez minutos. Es criterio editorial nuestro.

Lo que dicen las APIs, con fecha

Lo que la plantilla asume sobre cada plataforma sale de estas páginas, abiertas el 2026-09-17. Si una cambia, cambia la plantilla y sube la versión.

Lo que no citamos porque no lo pudimos verificar hoy: los meses de historial que conserva cada API (Search Console y Meta publican cifras que no volvimos a leer en la fecha de verificación, así que la plantilla no depende de ellas: el mes anterior sale de la corrida anterior guardada, no de volver a pedirlo).