Acceso confirmado
Aquí tienes Vigía Smart Bidding

Guarda esta página en favoritos: el código vive aquí y lo actualizo gratis cada vez que Google mueva algo. No tendrás que volver a pedirlo. Son dos piezas y cinco pasos: en cinco minutos lo tienes funcionando.
Empieza por aquí: haz tu copia de la plantilla

Vigía escribe el informe en una hoja de cálculo tuya. Ni yo ni nadie tenemos acceso a ella: la copia es tuya, vive en tu Drive y los datos de tu cuenta no salen de ahí. Haz la copia primero, porque vas a necesitar su URL en el paso 4.
Plantilla del informe Vigía

Ábrela y ve a Archivo → Hacer una copia. Trabaja siempre sobre tu copia, nunca sobre la plantilla original: sobre ella no tienes permisos de escritura y el script fallará.
Abrir la plantilla →
Cuando tengas tu copia abierta, copia la URL de la barra del navegador. Es la que pegarás en SPREADSHEET_URL. Si la dejas vacía, el script te creará una hoja nueva en cada cuenta, pero sin el formato de la plantilla.
Puesta en marcha en 5 pasos

Haz tu copia de la plantilla

Con el botón verde de aquí arriba. Archivo → Hacer una copia, y guarda la URL de tu copia a mano.
Copia el código

Con el botón que hay justo encima del recuadro negro. Se copia entero al portapapeles.
Pégalo en Google Ads

Entra en tu cuenta → Herramientas → Acciones en bloque → Scripts → botón +. Borra el contenido de ejemplo, pega el código y ponle nombre: Vigía Smart Bidding.
Rellena el bloque CONFIG y autoriza

Arriba del todo del código está el bloque CONFIGURACIÓN. Solo tienes que tocar dos líneas, ambas entre comillas simples:
SPREADSHEET_URL → la URL de tu copia del Sheet
EMAILS_ALERTA → tu email (o varios, separados por comas)
Después pulsa Autorizar y acepta los permisos. Si tienes varias cuentas de Google abiertas a la vez, autoriza desde una ventana de incógnito con la cuenta correcta: es el fallo más habitual. Luego dale a Vista previa para probar sin riesgo.
Prográmalo a diario

En Frecuencia, elige diaria a primera hora. Solo te escribirá cuando haya novedades: si un día no recibes email, es que no hay nada nuevo que mirar. A partir de la segunda ejecución empezarás a ver las tendencias.
Antes de que preguntes: el script es de solo lectura. No cambia objetivos, ni pujas, ni presupuestos. Lee tu cuenta y escribe en tu hoja. Los ajustes los aplicas tú, con el número exacto recomendado en cada fila. El código está comentado línea a línea para que lo compruebes tú mismo.
Actualizaciones incluidas: si Google cambia algo que afecte a lo que Vigía vigila, adapto el código y te escribo con la nueva versión. Sin coste y sin que tengas que pedirla.
Código de Vigía Smart Bidding

/*******************************************************************************************
 *
 *   🛡️  VIGÍA SMART BIDDING  ·  v2.0
 *   El vigilante del cambio de Google Ads del 17 de agosto de 2026
 *
 *   Caja Blanca · felixmanuelros.com
 *
 *  ─────────────────────────────────────────────────────────────────────────────────────
 *
 *  ¿QUÉ PROBLEMA RESUELVE?
 *
 *  El 17 de agosto de 2026, Google Ads cambia el comportamiento de las campañas
 *  "Limitadas por presupuesto" con objetivos tCPA o tROAS: dejarán de superar tu
 *  objetivo y pasarán a rendir hacia el número EXACTO que tengas escrito. Si hoy
 *  tienes un tROAS del 400% y tus campañas entregan un 700%, ese excedente
 *  desaparecerá — y Google no actualizará tus objetivos por ti.
 *
 *  Revisarlo una vez no basta: tu rendimiento real cambia cada semana (y en Q4,
 *  cada día), así que el objetivo escrito vuelve a quedarse obsoleto en cuanto lo
 *  ajustas. Este script convierte esa revisión en un sistema de vigilancia:
 *
 *   💶 CUANTIFICA EN DINERO — cuánto valor de conversión al mes (tROAS) o cuántas
 *      conversiones al mes (tCPA) están en juego si no actualizas cada objetivo.
 *   🗄️ GUARDA HISTÓRICO — cada ejecución queda registrada y el informe dibuja la
 *      tendencia de cada campaña. Tras el 17/08 podrás medir el impacto real del
 *      cambio (antes/después), algo que Google no muestra en ninguna pantalla.
 *   🔮 ANTICIPA — detecta campañas que aún no están limitadas por presupuesto pero
 *      van camino de estarlo. En Q4 serán las primeras en caer, y entonces el
 *      cambio les aplicará de lleno.
 *   📬 AVISA SOLO CUANDO IMPORTA — email de alerta únicamente cuando una campaña
 *      entra en riesgo o empeora. Sin ruido diario en tu bandeja.
 *
 *  🔒 100% SOLO LECTURA: este script NO modifica objetivos, pujas ni presupuestos.
 *     Solo analiza tu cuenta y escribe el informe en una hoja de Google Sheets.
 *     Los cambios los aplicas tú, con el número exacto recomendado en cada fila.
 *
 *  ─────────────────────────────────────────────────────────────────────────────────────
 *
 *  INSTALACIÓN (5 minutos)
 *
 *   1. En Google Ads: Herramientas → Acciones en bloque → Scripts → botón (+).
 *   2. Borra el contenido de ejemplo y pega este código completo.
 *   3. En el bloque CONFIG de aquí abajo, escribe tu email en EMAILS_ALERTA.
 *   4. Guarda, pulsa "Autorizar" y acepta los permisos (Google Ads, Hojas de
 *      cálculo y envío de correo). Si trabajas con varias sesiones de Google
 *      abiertas, autoriza desde una ventana de incógnito con la cuenta correcta.
 *   5. Ejecuta una primera vez: la URL de tu informe aparecerá en los registros
 *      y en el email de bienvenida. 
 *   6. Programa el script con frecuencia DIARIA (ideal, a primera hora). A partir
 *      de la segunda ejecución verás las tendencias y las novedades entre pasadas.
 *
 *  ─────────────────────────────────────────────────────────────────────────────────────
 *
 *  Esta es la versión gratuita, de diagnóstico. Si quieres ir un paso más allá
 *  (decisiones escalar/proteger según tu margen, ajuste automático con salvaguardas,
 *  versión MCC multi-cuenta...), sígueme en LinkedIn: ahí anuncio las novedades.
 *
 *  © Félix Manuel Ros · felixmanuelros.com · Prohibida su reventa.
 *
 *******************************************************************************************/

/* ═══════════════════════════════ CONFIGURACIÓN ═══════════════════════════════
   Solo necesitas tocar este bloque. El resto del script no requiere cambios.   */

var CONFIG = {

  // ▸ URL de tu hoja de Google Sheets. Entra en esta plantilla: https://docs.google.com/spreadsheets/d/14AA12cVbo03kzP9RiEJRAu9QDVe1sSzjQQJzxtDyXsg/edit?usp=sharing
  //   Y Create una copia con permisos de escritura.
  //   Después, pega en la fila 70 esa URL entre ('') para que todas las ejecuciones usen el mismo informe.
  SPREADSHEET_URL: '',

  // ▸ Email(s) que recibirán las alertas, separados por comas. ponlo entre ('') en la fila 74
  //   Ejemplo: 'tu@email.com, socio@email.com'. Vacío = no se envían emails.
  EMAILS_ALERTA: '',

  // ▸ false = solo recibes email cuando hay novedades (campañas que entran en
  //   riesgo o empeoran). true = resumen en cada ejecución, aunque no haya cambios.
  EMAIL_SIEMPRE: false,

  // ▸ Días de rendimiento real que se analizan. 30 funciona bien para la mayoría.
  //   Si tus clientes tardan semanas en convertir (ticket alto, B2B), sube a 60.
  LOOKBACK_DAYS: 30,
  
  /* ═══════════════════════════════ FIN CONFIGURACIÓN  NO TOCAR CÓDIGO A PARTIR DE AQUÍ═══════════════════════════════ */

  // ▸ Umbrales del semáforo de riesgo, según el % de eficiencia excedente
  //   (cuánto rinde la campaña por encima del objetivo escrito).
  UMBRAL_MODERADO: 0.05,   //  a partir de un  5% → MODERADO
  UMBRAL_ALTO:     0.10,   //  a partir de un 10% → ALTO
  UMBRAL_CRITICO:  0.25,   //  a partir de un 25% → CRÍTICO

  // ▸ Detección de campañas "⏳ En camino a limitación" (aún no limitadas, pero cerca):
  RATIO_GASTO_PRESUPUESTO: 0.85,  // gasto diario medio ≥ 85% del presupuesto diario
  LOST_IS_PRESUPUESTO:     0.05,  // o ≥ 5% de impresiones perdidas por presupuesto

  // ▸ Conversiones mínimas en el periodo para dar un veredicto fiable.
  //   Por debajo, la campaña se marca "SIN DATOS" en lugar de arriesgar una
  //   recomendación basada en ruido estadístico.
  MIN_CONVERSIONES: 5,

  // ▸ Nº de campañas del ranking "Top por valor en juego" del dashboard.
  TOP_N: 10,

  // ▸ Firma que aparece al pie del informe y del email.
  BRANDING: 'Caja Blanca · felixmanuelros.com'
};

var FECHA_CAMBIO = new Date(2026, 7, 17); // 17 de agosto de 2026

var COLOR = {
  FONDO: '#F7F8FA', TINTA: '#1B1F3B', TINTA2: '#2A2F55', TINTA_SUAVE: '#5C6178',
  BLANCO: '#FFFFFF', AZUL: '#2563EB', MORADO: '#7C3AED', AMBAR: '#F59E0B', ROJO: '#DC2626',
  ROJO_SUAVE: '#FEE2E2', ROJO_TEXTO: '#991B1B', NARANJA_SUAVE: '#FFEDD5', NARANJA_TEXTO: '#9A3412',
  AMARILLO_SUAVE: '#FEF9C3', AMARILLO_TEXTO: '#854D0E', VERDE_SUAVE: '#DCFCE7', VERDE_TEXTO: '#166534',
  AZUL_SUAVE: '#DBEAFE', AZUL_TEXTO: '#1E40AF', LILA_TEXTO: '#5B21B6',
  GRIS_SUAVE: '#E5E7EB', GRIS_TEXTO: '#6B7280', BORDE: '#D8DBE3'
};

var CANALES_AFECTADOS = {
  'SEARCH': 'Búsqueda', 'SHOPPING': 'Shopping', 'PERFORMANCE_MAX': 'PMax',
  'DEMAND_GEN': 'Demand Gen', 'TRAVEL': 'Travel'
};

var RANGO_RIESGO = { 'CRÍTICO': 6, 'ALTO': 5, 'MODERADO': 4, 'VIGILAR': 3, 'OK': 2, 'SIN DATOS': 1, 'NO AFECTADO': 0 };

function main() {

  var cuenta = AdsApp.currentAccount();
  var moneda = cuenta.getCurrencyCode();
  var tz     = cuenta.getTimeZone();
  var ahora  = new Date();
  var desde  = new Date(ahora.getTime() - CONFIG.LOOKBACK_DAYS * 864e5);
  var fDesde = Utilities.formatDate(desde, tz, 'yyyy-MM-dd');
  var fHasta = Utilities.formatDate(ahora, tz, 'yyyy-MM-dd');
  var sello  = Utilities.formatDate(ahora, tz, 'yyyy-MM-dd HH:mm');
  var factorMes = 30 / CONFIG.LOOKBACK_DAYS;

  Logger.log('🛡️ Vigía Smart Bidding · "' + cuenta.getName() + '" · ' + fDesde + ' → ' + fHasta);

  // ── Lectura (solo lectura, GAQL) ──
  var portfolios = leerPortfolios();
  var estados    = leerEstados();
  var brutos     = leerCampanas(fDesde, fHasta);

  // ── Análisis ──
  var filas = [];
  for (var i = 0; i < brutos.length; i++) {
    var f = analizarCampana(brutos[i], estados, portfolios, moneda, factorMes);
    if (f) filas.push(f);
  }
  if (!filas.length) {
    Logger.log('⚠️ Sin campañas activas con tCPA/tROAS y gasto en el periodo.');
    return;
  }
  filas.sort(function (a, b) {
    if (RANGO_RIESGO[b.riesgo] !== RANGO_RIESGO[a.riesgo]) return RANGO_RIESGO[b.riesgo] - RANGO_RIESGO[a.riesgo];
    if (b.eurosMes !== a.eurosMes) return b.eurosMes - a.eurosMes;
    return b.excedente - a.excedente;
  });

  // ── Histórico: leer snapshot anterior, comparar y registrar el de hoy ──
  var ss = obtenerSpreadsheet();
  var hHist = obtenerHistorico(ss);
  var anterior = leerUltimoSnapshot(hHist);
  var cambios = detectarCambios(filas, anterior);
  registrarSnapshot(hHist, filas, sello, moneda);
  var series = leerSeries(hHist);   // evolución del excedente por campaña (incluye hoy)

  // ── Informe visual ──
  pintarDetalle(ss, filas, series, moneda);
  pintarDashboard(ss, filas, cambios, cuenta.getName(), fDesde, fHasta, moneda, ahora, tz);
  pintarLeeme(ss);

  // ── Alertas ──
  gestionarEmail(ss, filas, cambios, cuenta.getName(), moneda, sello);

  Logger.log('✅ Informe actualizado: ' + ss.getUrl());
  Logger.log('🗄️ Ejecuciones acumuladas en el histórico: ' + numeroDeEjecuciones(hHist));
}

/* ══════════════════════════ LECTURA DE DATOS (GAQL) ══════════════════════════ */

function leerPortfolios() {
  var mapa = {};
  var q =
    'SELECT bidding_strategy.resource_name, bidding_strategy.name, ' +
    '       bidding_strategy.target_cpa.target_cpa_micros, bidding_strategy.target_roas.target_roas, ' +
    '       bidding_strategy.maximize_conversions.target_cpa_micros, ' +
    '       bidding_strategy.maximize_conversion_value.target_roas ' +
    'FROM bidding_strategy';
  try {
    var it = AdsApp.search(q);
    while (it.hasNext()) {
      var r = it.next();
      var t = extraerTarget(r.biddingStrategy);
      mapa[r.biddingStrategy.resourceName] = { nombre: r.biddingStrategy.name, tipo: t.tipo, valor: t.valor };
    }
  } catch (e) { Logger.log('Aviso portfolios: ' + e); }
  return mapa;
}

// Query separada: la API no permite combinar primary_status_reasons con métricas/fechas
function leerEstados() {
  var mapa = {};
  var it = AdsApp.search(
    'SELECT campaign.id, campaign.primary_status_reasons FROM campaign WHERE campaign.status = "ENABLED"'
  );
  while (it.hasNext()) {
    var r = it.next();
    mapa[r.campaign.id] = { limitada: (r.campaign.primaryStatusReasons || []).indexOf('BUDGET_CONSTRAINED') > -1 };
  }
  return mapa;
}

function leerCampanas(fDesde, fHasta) {
  var filas = [];
  var it = AdsApp.search(
    'SELECT campaign.id, campaign.name, campaign.advertising_channel_type, ' +
    '       campaign.bidding_strategy, ' +
    '       campaign.target_cpa.target_cpa_micros, campaign.target_roas.target_roas, ' +
    '       campaign.maximize_conversions.target_cpa_micros, ' +
    '       campaign.maximize_conversion_value.target_roas, ' +
    '       campaign_budget.amount_micros, campaign_budget.explicitly_shared, ' +
    '       metrics.cost_micros, metrics.conversions, metrics.conversions_value, ' +
    '       metrics.search_budget_lost_impression_share ' +
    'FROM campaign ' +
    'WHERE campaign.status = "ENABLED" AND metrics.cost_micros > 0 ' +
    '  AND segments.date BETWEEN "' + fDesde + '" AND "' + fHasta + '"'
  );
  while (it.hasNext()) filas.push(it.next());
  return filas;
}

/* ══════════════════════════════ ANÁLISIS ═════════════════════════════════════ */

function extraerTarget(obj) {
  if (!obj) return { tipo: null, valor: null };
  if (obj.targetCpa && obj.targetCpa.targetCpaMicros)
    return { tipo: 'CPA', valor: Number(obj.targetCpa.targetCpaMicros) / 1e6 };
  if (obj.maximizeConversions && obj.maximizeConversions.targetCpaMicros)
    return { tipo: 'CPA', valor: Number(obj.maximizeConversions.targetCpaMicros) / 1e6 };
  if (obj.targetRoas && obj.targetRoas.targetRoas)
    return { tipo: 'ROAS', valor: Number(obj.targetRoas.targetRoas) };
  if (obj.maximizeConversionValue && obj.maximizeConversionValue.targetRoas)
    return { tipo: 'ROAS', valor: Number(obj.maximizeConversionValue.targetRoas) };
  return { tipo: null, valor: null };
}

function analizarCampana(r, estados, portfolios, moneda, factorMes) {
  var c = r.campaign, m = r.metrics;

  var target = extraerTarget(c);
  var ambito = 'Campaña', nombrePortfolio = '';
  if (!target.tipo && c.biddingStrategy && portfolios[c.biddingStrategy]) {
    var p = portfolios[c.biddingStrategy];
    target = { tipo: p.tipo, valor: p.valor };
    ambito = 'Portfolio';
    nombrePortfolio = p.nombre;
  }
  if (!target.tipo || !target.valor) return null;

  var canal = c.advertisingChannelType;
  var canalAfectado = CANALES_AFECTADOS.hasOwnProperty(canal);
  var limitada = estados[c.id] ? estados[c.id].limitada : false;

  var coste = Number(m.costMicros) / 1e6;
  var conv  = Number(m.conversions) || 0;
  var valor = Number(m.conversionsValue) || 0;
  var lostIS = Number(m.searchBudgetLostImpressionShare) || 0;
  var presupuesto = Number(r.campaignBudget.amountMicros) / 1e6;
  var gastoDiario = coste / CONFIG.LOOKBACK_DAYS;

  var realCPA  = conv > 0 ? coste / conv : null;
  var realROAS = coste > 0 ? valor / coste : null;

  var excedente = 0, real = null;
  if (target.tipo === 'CPA' && realCPA !== null) {
    excedente = (target.valor - realCPA) / target.valor;
    real = realCPA;
  } else if (target.tipo === 'ROAS' && realROAS !== null) {
    excedente = (realROAS - target.valor) / target.valor;
    real = realROAS;
  }

  // 🔮 Capa predictiva: aún no limitada, pero rozando el presupuesto
  var caminoLimitacion = !limitada && canalAfectado &&
    (presupuesto > 0 && gastoDiario / presupuesto >= CONFIG.RATIO_GASTO_PRESUPUESTO ||
     lostIS >= CONFIG.LOST_IS_PRESUPUESTO);

  // 💶 Valor mensual en juego si el objetivo se queda como está tras el 17/08
  var eurosMes = 0, convMes = 0;
  var datosFiables = conv >= CONFIG.MIN_CONVERSIONES;
  if (canalAfectado && datosFiables && excedente > 0) {
    if (target.tipo === 'ROAS') eurosMes = coste * factorMes * (real - target.valor);
    else convMes = coste * factorMes * (1 / real - 1 / target.valor);
  }

  var sufijoPortfolio = ambito === 'Portfolio'
    ? ' ⚠ Ajustar en el PORTFOLIO "' + nombrePortfolio + '", no en la campaña.' : '';

  var riesgo, recomendacion;
  if (!canalAfectado) {
    riesgo = 'NO AFECTADO';
    recomendacion = 'Este tipo de campaña no cambia el 17/08.';
  } else if (!datosFiables) {
    riesgo = 'SIN DATOS';
    recomendacion = 'Menos de ' + CONFIG.MIN_CONVERSIONES + ' conversiones en el periodo: dato poco fiable.';
    excedente = Math.max(excedente, 0);
  } else if (excedente >= CONFIG.UMBRAL_MODERADO && !limitada) {
    riesgo = 'VIGILAR';
    recomendacion = (caminoLimitacion
      ? '🔮 Va CAMINO de quedar limitada (gasto al ' + Math.round(100 * gastoDiario / Math.max(presupuesto, 0.01)) + '% del presupuesto). Cuando entre en limitación, el cambio del 17/08 le aplicará de lleno: prepara ya el nuevo objetivo.'
      : 'Hoy no está limitada por presupuesto, pero rinde por encima del objetivo. Si entra en limitación —típico en Q4— ajusta el objetivo.') + sufijoPortfolio;
  } else if (excedente >= CONFIG.UMBRAL_CRITICO) {
    riesgo = 'CRÍTICO';
    recomendacion = textoAjuste(target, real, moneda, eurosMes, convMes) + sufijoPortfolio;
  } else if (excedente >= CONFIG.UMBRAL_ALTO) {
    riesgo = 'ALTO';
    recomendacion = textoAjuste(target, real, moneda, eurosMes, convMes) + sufijoPortfolio;
  } else if (excedente >= CONFIG.UMBRAL_MODERADO) {
    riesgo = 'MODERADO';
    recomendacion = textoAjuste(target, real, moneda, eurosMes, convMes) + sufijoPortfolio;
  } else {
    riesgo = 'OK';
    recomendacion = 'Objetivo alineado con el rendimiento real. Sin acción necesaria.';
  }

  return {
    id: String(c.id), nombre: c.name,
    canal: canalAfectado ? CANALES_AFECTADOS[canal] : canal,
    estrategia: 't' + target.tipo + (ambito === 'Portfolio' ? ' (portfolio)' : ''),
    tipoTarget: target.tipo, objetivo: target.valor, real: real,
    excedente: Math.max(excedente, 0),
    limitada: limitada, caminoLimitacion: caminoLimitacion,
    presupuesto: presupuesto, gastoDiario: gastoDiario,
    coste: coste, conversiones: conv, valorConv: valor,
    eurosMes: eurosMes, convMes: convMes,
    riesgo: riesgo, recomendacion: recomendacion
  };
}

function textoAjuste(target, real, moneda, eurosMes, convMes) {
  if (target.tipo === 'CPA') {
    return 'Bajar el tCPA de ' + fmtN(target.valor) + ' ' + moneda + ' a ' + fmtN(real) + ' ' + moneda +
           ' antes del 17/08. En juego: ~' + fmtN(convMes, 1) + ' conversiones/mes.';
  }
  return 'Subir el tROAS del ' + Math.round(target.valor * 100) + '% al ' + Math.round(real * 100) +
         '% antes del 17/08. En juego: ~' + fmtN(eurosMes, 0) + ' ' + moneda + '/mes de valor de conversión.';
}

function fmtN(n, dec) {
  if (dec === undefined) dec = 2;
  return Number(n).toFixed(dec).replace('.', ',').replace(/\B(?=(\d{3})+(?!\d))/g, '.');
}

/* ═══════════════════════════ GRÁFICOS DE TEXTO ═══════════════════════════════
   Las barras y tendencias se generan con caracteres (█░ y ▁▂▄▆█) en lugar de
   fórmulas: así el informe funciona igual en cualquier idioma y configuración
   regional de Google Sheets.                                                   */

// Barra horizontal: ███████░░░  (proporcional a valor/max)
function barraTexto(valor, max, longitud) {
  longitud = longitud || 10;
  if (!max || max <= 0 || !valor || valor <= 0) return '';
  var llenos = Math.max(1, Math.round(longitud * Math.min(valor / max, 1)));
  return repetir('█', llenos) + repetir('░', longitud - llenos);
}

// Mini-gráfico de tendencia: ▁▂▄▆█ (serie de valores normalizada)
function tendenciaTexto(serie) {
  if (!serie || !serie.length) return '·';
  if (serie.length === 1) return '▪ (1ª ejecución)';
  var niveles = ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█'];
  var min = Math.min.apply(null, serie), max = Math.max.apply(null, serie);
  var rango = max - min;
  var out = '';
  // Máximo 20 puntos: si hay más ejecuciones, muestra las últimas 20
  var datos = serie.slice(-20);
  for (var i = 0; i < datos.length; i++) {
    var idx = rango === 0 ? 3 : Math.round((datos[i] - min) / rango * (niveles.length - 1));
    out += niveles[idx];
  }
  return out;
}

function repetir(ch, n) {
  return n > 0 ? new Array(n + 1).join(ch) : '';
}

/* ═══════════════════════ HISTÓRICO Y COMPARATIVA ═════════════════════════════ */

var HIST_CAB = ['Fecha', 'ID', 'Campaña', 'Tipo', 'Objetivo', 'Real', 'Excedente', 'Riesgo',
                'Limitada', 'Coste periodo', 'Valor conv.', '€/mes en juego', 'Conv/mes en juego'];

function obtenerHistorico(ss) {
  var h = ss.getSheetByName('🗄️ Histórico');
  if (!h) {
    h = ss.insertSheet('🗄️ Histórico');
    h.getRange(1, 1, 1, HIST_CAB.length).setValues([HIST_CAB])
      .setFontWeight('bold').setBackground(COLOR.TINTA).setFontColor(COLOR.BLANCO)
      .setFontSize(10).setVerticalAlignment('middle').setWrap(true);
    h.setRowHeight(1, 34);
    h.setFrozenRows(1);
    h.getRange('B:B').setNumberFormat('@'); // IDs como texto
  }
  // Formatos que conviene reafirmar en cada ejecución (también arreglan hojas antiguas)
  var anchos = [130, 95, 250, 60, 90, 90, 90, 100, 70, 105, 105, 110, 110];
  for (var a = 0; a < anchos.length; a++) h.setColumnWidth(a + 1, anchos[a]);
  h.getRange('G:G').setNumberFormat('0.0%');      // Excedente
  h.getRange('M:M').setNumberFormat('#,##0.0');   // Conv/mes en juego
  try { h.getRange(1, 1, Math.max(h.getLastRow(), 1), HIST_CAB.length).createFilter(); } catch (e) {}
  return h;
}

function leerUltimoSnapshot(hHist) {
  var ultima = hHist.getLastRow();
  if (ultima < 2) return null;
  var datos = hHist.getRange(2, 1, ultima - 1, HIST_CAB.length).getValues();
  var ultimaFecha = datos[datos.length - 1][0];
  var mapa = {};
  for (var i = datos.length - 1; i >= 0; i--) {
    if (String(datos[i][0]) !== String(ultimaFecha)) break;
    mapa[String(datos[i][1])] = { excedente: Number(datos[i][6]) || 0, riesgo: String(datos[i][7]) };
  }
  return mapa;
}

// Serie temporal del excedente por campaña (en orden cronológico, incluye la de hoy)
function leerSeries(hHist) {
  var mapa = {};
  var ultima = hHist.getLastRow();
  if (ultima < 2) return mapa;
  var datos = hHist.getRange(2, 1, ultima - 1, HIST_CAB.length).getValues();
  for (var i = 0; i < datos.length; i++) {
    var id = String(datos[i][1]);
    if (!mapa[id]) mapa[id] = [];
    mapa[id].push(Number(datos[i][6]) || 0);
  }
  return mapa;
}

function detectarCambios(filas, anterior) {
  var nuevas = [], empeoradas = [], mejoradas = [];
  if (anterior) {
    for (var i = 0; i < filas.length; i++) {
      var f = filas[i], prev = anterior[f.id];
      var esRiesgo = RANGO_RIESGO[f.riesgo] >= RANGO_RIESGO['MODERADO'];
      if (!prev) { if (esRiesgo) nuevas.push(f); continue; }
      var subida = RANGO_RIESGO[f.riesgo] - (RANGO_RIESGO[prev.riesgo] || 0);
      if (esRiesgo && subida > 0) (RANGO_RIESGO[prev.riesgo] >= RANGO_RIESGO['MODERADO'] ? empeoradas : nuevas).push(f);
      else if (subida < 0 && RANGO_RIESGO[prev.riesgo] >= RANGO_RIESGO['MODERADO']) mejoradas.push(f);
    }
  }
  return { primeraEjecucion: !anterior, nuevas: nuevas, empeoradas: empeoradas, mejoradas: mejoradas };
}

function registrarSnapshot(hHist, filas, sello, moneda) {
  var out = [];
  for (var i = 0; i < filas.length; i++) {
    var f = filas[i];
    out.push([sello, f.id, f.nombre, 't' + f.tipoTarget, f.objetivo, f.real === null ? '' : f.real,
              f.excedente, f.riesgo, f.limitada ? 'SÍ' : 'NO', f.coste, f.valorConv, f.eurosMes, f.convMes]);
  }
  var filaIni = hHist.getLastRow() + 1;
  hHist.getRange(filaIni, 1, out.length, HIST_CAB.length).setValues(out)
    .setFontSize(9).setVerticalAlignment('middle');

  // Formato de las filas recién registradas
  var fmtMoneda = '#,##0.00 "' + moneda + '"';
  hHist.getRange(filaIni, 1, out.length, 1).setFontColor(COLOR.GRIS_TEXTO);              // Fecha
  hHist.getRange(filaIni, 10, out.length, 2).setNumberFormat(fmtMoneda);                 // Coste y Valor conv.
  hHist.getRange(filaIni, 12, out.length, 1).setNumberFormat('#,##0 "' + moneda + '"');  // €/mes en juego
  hHist.getRange(filaIni, 9, out.length, 1).setHorizontalAlignment('center');            // Limitada
  for (var j = 0; j < filas.length; j++) {
    var fr = filaIni + j;
    var esRoas = filas[j].tipoTarget === 'ROAS';
    hHist.getRange(fr, 5, 1, 2).setNumberFormat(esRoas ? '0%' : fmtMoneda);              // Objetivo y Real
    var est = estiloRiesgo(filas[j].riesgo);                                             // Semáforo
    hHist.getRange(fr, 8).setBackground(est.bg).setFontColor(est.fg)
      .setFontWeight('bold').setHorizontalAlignment('center').setFontSize(9);
  }
}

function numeroDeEjecuciones(hHist) {
  var ultima = hHist.getLastRow();
  if (ultima < 2) return 0;
  var fechas = hHist.getRange(2, 1, ultima - 1, 1).getValues();
  var set = {};
  for (var i = 0; i < fechas.length; i++) set[String(fechas[i][0])] = true;
  return Object.keys(set).length;
}

/* ═══════════════════════ INFORME VISUAL EN SHEETS ════════════════════════════ */

function obtenerSpreadsheet() {
  if (CONFIG.SPREADSHEET_URL) return SpreadsheetApp.openByUrl(CONFIG.SPREADSHEET_URL);
  return SpreadsheetApp.create('🛡️ Vigía Smart Bidding — Cambio 17 de agosto');
}

function limpiarHoja(ss, nombre, indice) {
  var h = ss.getSheetByName(nombre);
  if (h) { h.clear(); h.clearFormats(); }
  else { h = ss.insertSheet(nombre, indice); }
  var def = ss.getSheetByName('Sheet1') || ss.getSheetByName('Hoja 1');
  if (def && ss.getSheets().length > 1) { try { ss.deleteSheet(def); } catch (e) {} }
  try { h.setHiddenGridlines(true); } catch (e) {}
  return h;
}

function estiloRiesgo(riesgo) {
  switch (riesgo) {
    case 'CRÍTICO':  return { bg: COLOR.ROJO_SUAVE, fg: COLOR.ROJO_TEXTO, barra: COLOR.ROJO };
    case 'ALTO':     return { bg: COLOR.NARANJA_SUAVE, fg: COLOR.NARANJA_TEXTO, barra: COLOR.AMBAR };
    case 'MODERADO': return { bg: COLOR.AMARILLO_SUAVE, fg: COLOR.AMARILLO_TEXTO, barra: COLOR.AMBAR };
    case 'VIGILAR':  return { bg: COLOR.AZUL_SUAVE, fg: COLOR.AZUL_TEXTO, barra: COLOR.AZUL };
    case 'OK':       return { bg: COLOR.VERDE_SUAVE, fg: COLOR.VERDE_TEXTO, barra: COLOR.VERDE_TEXTO };
    default:         return { bg: COLOR.GRIS_SUAVE, fg: COLOR.GRIS_TEXTO, barra: COLOR.GRIS_TEXTO };
  }
}

/* ---------- Pestaña 2: Detalle ---------- */

function pintarDetalle(ss, filas, series, moneda) {
  var h = limpiarHoja(ss, '🔍 Detalle por campaña', 1);
  var COLS = 13;

  h.getRange(1, 1, 1, COLS).merge()
    .setValue('DETALLE POR CAMPAÑA — objetivo vs. real (' + CONFIG.LOOKBACK_DAYS + ' días) · con tendencia histórica')
    .setBackground(COLOR.TINTA).setFontColor(COLOR.BLANCO).setFontSize(13).setFontWeight('bold')
    .setVerticalAlignment('middle');
  h.setRowHeight(1, 40);

  var cab = ['Campaña', 'Canal', 'Estrategia', 'Presupuesto', 'Objetivo', 'Real',
             'Eficiencia en juego', '▮▮▮', '📈 Tendencia', '€/mes en juego', 'Conv/mes en juego',
             'Riesgo', '✅ Recomendación'];
  h.getRange(2, 1, 1, COLS).setValues([cab])
    .setBackground(COLOR.TINTA2).setFontColor(COLOR.BLANCO).setFontWeight('bold')
    .setFontSize(10).setVerticalAlignment('middle').setWrap(true);
  h.setRowHeight(2, 38);
  h.setFrozenRows(2);

  var maxExc = 0;
  for (var x = 0; x < filas.length; x++) maxExc = Math.max(maxExc, filas[x].excedente);

  var datos = [];
  for (var i = 0; i < filas.length; i++) {
    var f = filas[i];
    var estadoPresu = f.limitada ? '🔒 Limitada' : (f.caminoLimitacion ? '⏳ En camino' : 'Holgada');
    var esRoas = f.tipoTarget === 'ROAS';
    datos.push([
      f.nombre, f.canal, f.estrategia, estadoPresu,
      f.objetivo, f.real === null ? '—' : f.real,
      f.excedente,
      barraTexto(f.excedente, maxExc, 10),
      tendenciaTexto(series[f.id]),
      esRoas ? f.eurosMes : '—',          // €/mes solo aplica a tROAS
      esRoas ? '—' : f.convMes,           // conv/mes solo aplica a tCPA
      f.riesgo, f.recomendacion
    ]);
  }
  var nF = datos.length;
  h.getRange(3, 1, nF, COLS).setValues(datos).setFontSize(10).setVerticalAlignment('middle');

  for (var j = 0; j < nF; j++) {
    var fila = 3 + j;
    var f2 = filas[j];
    var est = estiloRiesgo(f2.riesgo);
    var esRoas2 = f2.tipoTarget === 'ROAS';

    // Formato objetivo/real según tipo de estrategia
    h.getRange(fila, 5, 1, 2).setNumberFormat(esRoas2 ? '0%' : '#,##0.00 "' + moneda + '"');
    // €/mes y conv/mes: formato numérico solo si aplica
    if (esRoas2) h.getRange(fila, 10).setNumberFormat('#,##0 "' + moneda + '"');
    else h.getRange(fila, 11).setNumberFormat('#,##0.0');
    h.getRange(fila, 10, 1, 2).setHorizontalAlignment('center');

    // Barra y tendencia (texto coloreado, sin fórmulas)
    h.getRange(fila, 8).setFontColor(est.barra).setFontFamily('Roboto Mono').setFontSize(9);
    h.getRange(fila, 9).setFontColor(COLOR.AZUL).setFontFamily('Roboto Mono').setFontSize(10)
      .setHorizontalAlignment('center');

    // Semáforo
    h.getRange(fila, 12).setBackground(est.bg).setFontColor(est.fg)
      .setFontWeight('bold').setHorizontalAlignment('center');
    if (f2.riesgo === 'CRÍTICO') {
      h.getRange(fila, 1, 1, COLS).setBackground('#FFF5F5');
      h.getRange(fila, 12).setBackground(est.bg);
    }
    if (f2.caminoLimitacion) h.getRange(fila, 4).setFontColor(COLOR.LILA_TEXTO).setFontWeight('bold');
  }

  h.getRange(3, 7, nF, 1).setNumberFormat('0.0%');
  h.getRange(3, 13, nF, 1).setWrap(true).setFontColor('#333944');

  h.getRange(2, 1, nF + 1, COLS).setBorder(true, true, true, true, true, true, COLOR.BORDE, SpreadsheetApp.BorderStyle.SOLID);
  var anchos = [250, 85, 100, 95, 95, 95, 100, 95, 110, 105, 105, 100, 420];
  for (var a = 0; a < anchos.length; a++) h.setColumnWidth(a + 1, anchos[a]);
  try { h.getRange(2, 1, nF + 1, COLS).createFilter(); } catch (e) {}
}

/* ---------- Pestaña 1: Dashboard ---------- */

function pintarDashboard(ss, filas, cambios, nombreCuenta, fDesde, fHasta, moneda, ahora, tz) {
  var h = limpiarHoja(ss, '📊 Dashboard', 0);
  ss.setActiveSheet(h); ss.moveActiveSheet(1);
  h.getRange(1, 1, 70, 12).setBackground(COLOR.FONDO);

  var post17 = ahora.getTime() >= FECHA_CAMBIO.getTime();
  var diasRestantes = Math.ceil((FECHA_CAMBIO.getTime() - ahora.getTime()) / 864e5);

  h.getRange(1, 1, 2, 11).merge()
    .setValue('🛡️  VIGÍA SMART BIDDING — CAMBIO DEL 17 DE AGOSTO' +
              (post17 ? '  ·  MODO IMPACTO (post-cambio)' : '  ·  ⏰ QUEDAN ' + diasRestantes + ' DÍAS'))
    .setBackground(COLOR.TINTA).setFontColor(COLOR.BLANCO).setFontSize(17).setFontWeight('bold')
    .setVerticalAlignment('middle').setHorizontalAlignment('center');
  h.getRange(3, 1, 1, 11).merge()
    .setValue('Cuenta: ' + nombreCuenta + '   ·   Periodo: ' + fDesde + ' → ' + fHasta +
              '   ·   Vigilancia continua de SOLO LECTURA: este script no modifica tu cuenta')
    .setBackground(COLOR.TINTA).setFontColor('#B9BDD4').setFontSize(10)
    .setHorizontalAlignment('center').setVerticalAlignment('middle');
  h.setRowHeight(1, 28); h.setRowHeight(2, 28); h.setRowHeight(3, 22);

  var enRiesgo = filas.filter(function (f) { return f.riesgo === 'CRÍTICO' || f.riesgo === 'ALTO'; });
  var eurosTotal = filas.reduce(function (s, f) { return s + (f.eurosMes || 0); }, 0);
  var convTotal  = filas.reduce(function (s, f) { return s + (f.convMes || 0); }, 0);
  var camino     = filas.filter(function (f) { return f.caminoLimitacion; });
  var hayCPA     = filas.some(function (f) { return f.tipoTarget === 'CPA'; });
  var hayROAS    = filas.some(function (f) { return f.tipoTarget === 'ROAS'; });

  var kpis = [
    { n: hayROAS ? eurosTotal : '—', t: '€ / MES\nEN JUEGO (tROAS)', c: COLOR.ROJO, fmt: '#,##0 "' + moneda + '"' },
    { n: hayCPA ? convTotal : '—',   t: 'CONV. / MES\nEN JUEGO (tCPA)', c: COLOR.AMBAR, fmt: '#,##0.0' },
    { n: enRiesgo.length, t: 'CAMPAÑAS EN RIESGO\nCRÍTICO / ALTO', c: COLOR.MORADO, fmt: '0' },
    { n: camino.length,   t: '🔮 EN CAMINO A\nLIMITACIÓN', c: COLOR.AZUL, fmt: '0' }
  ];
  var col = 2;
  for (var i = 0; i < kpis.length; i++) {
    var celda = h.getRange(5, col, 2, 2).merge().setValue(kpis[i].n)
      .setBackground(kpis[i].c).setFontColor(COLOR.BLANCO).setFontSize(24).setFontWeight('bold')
      .setHorizontalAlignment('center').setVerticalAlignment('middle');
    if (typeof kpis[i].n === 'number') celda.setNumberFormat(kpis[i].fmt);
    h.getRange(7, col, 1, 2).merge().setValue(kpis[i].t)
      .setBackground(kpis[i].c).setFontColor(COLOR.BLANCO).setFontSize(9).setFontWeight('bold')
      .setWrap(true).setHorizontalAlignment('center').setVerticalAlignment('middle');
    col += 3;
  }
  h.setRowHeight(5, 34); h.setRowHeight(6, 34); h.setRowHeight(7, 30);

  // Novedades vs. ejecución anterior
  var novedades;
  if (cambios.primeraEjecucion) {
    novedades = '📌 Primera ejecución: a partir de ahora, cada pasada queda registrada en "🗄️ Histórico" y aquí verás qué ha cambiado desde la anterior.';
  } else if (!cambios.nuevas.length && !cambios.empeoradas.length && !cambios.mejoradas.length) {
    novedades = '✔ Sin novedades desde la ejecución anterior.';
  } else {
    var partes = [];
    if (cambios.nuevas.length) partes.push('🆕 ' + cambios.nuevas.length + ' campaña(s) NUEVAS en riesgo: ' + nombres(cambios.nuevas));
    if (cambios.empeoradas.length) partes.push('📈 ' + cambios.empeoradas.length + ' han EMPEORADO: ' + nombres(cambios.empeoradas));
    if (cambios.mejoradas.length) partes.push('📉 ' + cambios.mejoradas.length + ' han mejorado: ' + nombres(cambios.mejoradas));
    novedades = partes.join('   ·   ');
  }
  h.getRange(9, 2, 2, 9).merge().setValue(novedades)
    .setBackground(cambios.nuevas.length || cambios.empeoradas.length ? COLOR.ROJO_SUAVE : COLOR.AZUL_SUAVE)
    .setFontColor(cambios.nuevas.length || cambios.empeoradas.length ? COLOR.ROJO_TEXTO : COLOR.AZUL_TEXTO)
    .setFontSize(10.5).setFontWeight('bold').setWrap(true)
    .setVerticalAlignment('middle').setHorizontalAlignment('center');

  // Ranking Top-N por valor en juego
  h.getRange(12, 2, 1, 9).merge()
    .setValue('🔥 TOP CAMPAÑAS POR VALOR EN JUEGO')
    .setBackground(COLOR.TINTA2).setFontColor(COLOR.BLANCO).setFontSize(12).setFontWeight('bold')
    .setVerticalAlignment('middle');
  h.setRowHeight(12, 30);

  var top = filas.filter(function (f) { return f.eurosMes > 0 || f.convMes > 0; }).slice(0, CONFIG.TOP_N);
  var base = 13;
  h.getRange(base, 2, 1, 9).setValues([['Campaña', 'Riesgo', 'Objetivo', 'Real', 'En juego / mes', '', '', '', '']])
    .setFontWeight('bold').setFontSize(10).setFontColor(COLOR.TINTA_SUAVE);
  h.getRange(base, 6, 1, 3).merge();

  var maxJuego = 1;
  for (var mj = 0; mj < top.length; mj++) {
    maxJuego = Math.max(maxJuego, top[mj].tipoTarget === 'ROAS' ? top[mj].eurosMes : top[mj].convMes * 50);
  }
  for (var t = 0; t < top.length; t++) {
    var f = top[t], fr = base + 1 + t;
    var esRoas = f.tipoTarget === 'ROAS';
    var enJuego = esRoas ? f.eurosMes : f.convMes;
    var est = estiloRiesgo(f.riesgo);
    h.getRange(fr, 2).setValue(f.nombre).setFontSize(10);
    h.getRange(fr, 3).setValue(f.riesgo).setBackground(est.bg).setFontColor(est.fg)
      .setFontWeight('bold').setFontSize(9).setHorizontalAlignment('center');
    h.getRange(fr, 4).setValue(f.objetivo).setNumberFormat(esRoas ? '0%' : '#,##0.00 "' + moneda + '"').setFontSize(10);
    h.getRange(fr, 5).setValue(f.real).setNumberFormat(esRoas ? '0%' : '#,##0.00 "' + moneda + '"').setFontSize(10);
    // Barra de texto (sin fórmulas → sin errores de locale)
    h.getRange(fr, 6, 1, 3).merge()
      .setValue(barraTexto(esRoas ? f.eurosMes : f.convMes * 50, maxJuego, 14))
      .setFontColor(est.barra).setFontFamily('Roboto Mono').setFontSize(10);
    h.getRange(fr, 9).setValue(esRoas ? fmtN(enJuego, 0) + ' ' + moneda : fmtN(enJuego, 1) + ' conv.')
      .setFontWeight('bold').setFontSize(10)
      .setFontColor(f.riesgo === 'CRÍTICO' ? COLOR.ROJO : COLOR.TINTA);
    h.setRowHeight(fr, 26);
  }
  if (top.length) {
    h.getRange(base, 2, top.length + 1, 9)
      .setBorder(true, true, true, true, false, true, COLOR.BORDE, SpreadsheetApp.BorderStyle.SOLID);
  }

  // Leyenda
  var frLey = base + Math.max(top.length, 1) + 3;
  h.getRange(frLey, 2, 1, 9).merge().setValue('LEYENDA DE RIESGO')
    .setFontSize(9).setFontWeight('bold').setFontColor(COLOR.TINTA_SUAVE);
  var leyenda = [
    ['CRÍTICO',  'Limitada por presupuesto con excedente > ' + Math.round(CONFIG.UMBRAL_CRITICO * 100) + '%: máxima pérdida potencial el 17/08'],
    ['ALTO',     'Limitada por presupuesto con excedente ' + Math.round(CONFIG.UMBRAL_ALTO * 100) + '–' + Math.round(CONFIG.UMBRAL_CRITICO * 100) + '%'],
    ['MODERADO', 'Limitada por presupuesto con excedente ' + Math.round(CONFIG.UMBRAL_MODERADO * 100) + '–' + Math.round(CONFIG.UMBRAL_ALTO * 100) + '%'],
    ['VIGILAR',  'Sobrecumple pero hoy NO está limitada. Si además pone "⏳ En camino", el sistema prevé que caerá en limitación'],
    ['OK',       'Objetivo alineado con el rendimiento real'],
    ['SIN DATOS','Conversiones insuficientes para un veredicto fiable']
  ];
  for (var l = 0; l < leyenda.length; l++) {
    var frL = frLey + 1 + l, estL = estiloRiesgo(leyenda[l][0]);
    h.getRange(frL, 2).setValue(leyenda[l][0]).setBackground(estL.bg).setFontColor(estL.fg)
      .setFontWeight('bold').setFontSize(9).setHorizontalAlignment('center');
    h.getRange(frL, 3, 1, 8).merge().setValue(leyenda[l][1]).setFontSize(9).setFontColor(COLOR.TINTA_SUAVE);
  }

  if (CONFIG.BRANDING) {
    h.getRange(frLey + leyenda.length + 3, 2, 1, 9).merge()
      .setValue('Última ejecución: ' + Utilities.formatDate(ahora, tz, 'dd/MM/yyyy HH:mm') + '  ·  ' + CONFIG.BRANDING)
      .setFontSize(9).setFontColor(COLOR.GRIS_TEXTO).setHorizontalAlignment('center');
  }

  h.setColumnWidth(1, 20); h.setColumnWidth(2, 250);
  for (var w = 3; w <= 10; w++) h.setColumnWidth(w, 95);
  h.setColumnWidth(11, 20);
}

function nombres(lista) {
  return lista.slice(0, 3).map(function (f) { return '"' + f.nombre + '"'; }).join(', ') +
         (lista.length > 3 ? ' (+' + (lista.length - 3) + ')' : '');
}

/* ---------- Pestaña 3: Léeme ---------- */

function pintarLeeme(ss) {
  var h = limpiarHoja(ss, 'ℹ️ Léeme', 2);
  h.getRange(1, 1, 1, 8).merge().setValue('¿QUÉ ES ESTO Y POR QUÉ IMPORTA?')
    .setBackground(COLOR.TINTA).setFontColor(COLOR.BLANCO).setFontSize(14).setFontWeight('bold')
    .setVerticalAlignment('middle');
  h.setRowHeight(1, 36);

  var textos = [
    ['📅', 'El 17/08/2026 Google Ads cambia la puja de las campañas "Limitadas por presupuesto" con tCPA/tROAS: pasarán a rendir hacia el objetivo EXACTO que tengas escrito, en lugar de superarlo. Google NO ajustará tus objetivos por ti.'],
    ['🛡️', 'Esto no es un informe puntual (eso ya lo hace la Bid Target Adjustment Tool de Google). Es un VIGILANTE: prográmalo a diario y te avisará por email solo cuando una campaña entre en riesgo o empeore. Tu rendimiento real cambia cada semana; tus objetivos escritos, no.'],
    ['💶', 'Cuantifica el problema en dinero: cuánto valor de conversión al mes (tROAS) o cuántas conversiones al mes (tCPA) están en juego si no actualizas cada objetivo. En cada campaña solo aplica una de las dos métricas — la otra muestra "—". Google no te enseña ese número en ninguna pantalla.'],
    ['🗄️', 'Cada ejecución queda en "🗄️ Histórico". La columna "📈 Tendencia" del detalle dibuja la evolución de cada campaña (▁▂▄▆█); con una sola ejecución verás "▪": necesita al menos dos pasadas. Tras el 17/08 podrás medir el impacto REAL del cambio, campaña a campaña.'],
    ['🔮', 'Capa predictiva: marca "⏳ En camino" las campañas que aún no están limitadas pero gastan ≥85% de su presupuesto o pierden impresiones por presupuesto. En Q4 son las primeras que caerán en limitación — y entonces el cambio les aplicará de lleno.'],
    ['⚠️', 'Si el objetivo vive en una estrategia de PORTFOLIO, el ajuste se hace a nivel de portfolio, no de campaña. El informe te lo indica y te dice en cuál.'],
    ['🔒', '100% SOLO LECTURA: el script no modifica objetivos, pujas ni presupuestos. Los cambios los aplicas tú, con el número exacto recomendado en cada fila. Tras ajustar, espera 1–2 ciclos de conversión antes de evaluar.']
  ];
  for (var i = 0; i < textos.length; i++) {
    var fr = 3 + i * 2;
    h.getRange(fr, 1).setValue(textos[i][0]).setFontSize(18).setHorizontalAlignment('center');
    h.getRange(fr, 2, 1, 7).merge().setValue(textos[i][1])
      .setFontSize(11).setWrap(true).setVerticalAlignment('middle').setFontColor('#333944');
    h.setRowHeight(fr, 54);
  }
  if (CONFIG.BRANDING) {
    h.getRange(3 + textos.length * 2 + 1, 2, 1, 7).merge()
      .setValue(CONFIG.BRANDING).setFontWeight('bold').setFontColor(COLOR.TINTA);
  }
  h.setColumnWidth(1, 50);
  for (var c = 2; c <= 8; c++) h.setColumnWidth(c, 112);
}

/* ═══════════════════════════════ ALERTAS EMAIL ═══════════════════════════════ */

function gestionarEmail(ss, filas, cambios, nombreCuenta, moneda, sello) {
  if (!CONFIG.EMAILS_ALERTA) return;

  var hayNovedades = cambios.primeraEjecucion || cambios.nuevas.length > 0 || cambios.empeoradas.length > 0;
  if (!CONFIG.EMAIL_SIEMPRE && !hayNovedades) {
    Logger.log('📭 Sin novedades relevantes: no se envía email.');
    return;
  }

  var enRiesgo = filas.filter(function (f) { return f.riesgo === 'CRÍTICO' || f.riesgo === 'ALTO'; });
  var eurosTotal = filas.reduce(function (s, f) { return s + (f.eurosMes || 0); }, 0);
  var convTotal  = filas.reduce(function (s, f) { return s + (f.convMes || 0); }, 0);

  var asunto = cambios.primeraEjecucion
    ? '🛡️ Vigía Smart Bidding activado en "' + nombreCuenta + '" — primer diagnóstico dentro'
    : '🚨 [' + nombreCuenta + '] ' + (cambios.nuevas.length + cambios.empeoradas.length) +
      ' campaña(s) en riesgo por el cambio del 17/08 — ' + fmtN(eurosTotal, 0) + ' ' + moneda + '/mes en juego';

  var html = '<div style="font-family:Arial,sans-serif;max-width:640px;margin:0 auto;color:#1B1F3B">' +
    '<div style="background:#1B1F3B;color:#fff;padding:18px 24px;border-radius:8px 8px 0 0">' +
      '<h2 style="margin:0;font-size:18px">🛡️ Vigía Smart Bidding</h2>' +
      '<p style="margin:6px 0 0;color:#B9BDD4;font-size:12px">' + nombreCuenta + ' · ' + sello + '</p>' +
    '</div>' +
    '<div style="border:1px solid #D8DBE3;border-top:0;padding:20px 24px;border-radius:0 0 8px 8px">' +
      '<table style="width:100%;border-collapse:collapse;margin-bottom:16px"><tr>' +
        celdaKpi(fmtN(eurosTotal, 0) + ' ' + moneda, '€/mes en juego', '#DC2626') +
        celdaKpi(fmtN(convTotal, 1), 'conv/mes en juego', '#F59E0B') +
        celdaKpi(String(enRiesgo.length), 'campañas crítico/alto', '#7C3AED') +
      '</tr></table>';

  if (cambios.nuevas.length) {
    html += '<p style="font-size:13px"><b>🆕 Nuevas en riesgo:</b></p>' + listaHtml(cambios.nuevas, moneda);
  }
  if (cambios.empeoradas.length) {
    html += '<p style="font-size:13px"><b>📈 Han empeorado:</b></p>' + listaHtml(cambios.empeoradas, moneda);
  }
  if (cambios.primeraEjecucion && enRiesgo.length) {
    html += '<p style="font-size:13px"><b>Diagnóstico inicial — campañas en riesgo:</b></p>' + listaHtml(enRiesgo.slice(0, 5), moneda);
  }

  html += '<p style="margin:18px 0 6px"><a href="' + ss.getUrl() + '" ' +
      'style="background:#2563EB;color:#fff;text-decoration:none;padding:10px 18px;border-radius:6px;font-size:13px;font-weight:bold">' +
      'Abrir el informe completo →</a></p>' +
      '<p style="font-size:11px;color:#6B7280;margin-top:16px">Vigilancia de solo lectura: este sistema no modifica tu cuenta. ' +
      (CONFIG.BRANDING ? '· ' + CONFIG.BRANDING : '') + '</p>' +
    '</div></div>';

  MailApp.sendEmail({ to: CONFIG.EMAILS_ALERTA, subject: asunto, htmlBody: html });
  Logger.log('📬 Alerta enviada a: ' + CONFIG.EMAILS_ALERTA);
}

function celdaKpi(valor, etiqueta, color) {
  return '<td style="background:' + color + ';color:#fff;text-align:center;padding:12px 6px;border-radius:6px;width:33%">' +
    '<div style="font-size:20px;font-weight:bold">' + valor + '</div>' +
    '<div style="font-size:10px;text-transform:uppercase;letter-spacing:.5px">' + etiqueta + '</div></td>' +
    '<td style="width:6px"></td>';
}

function listaHtml(lista, moneda) {
  var out = '<ul style="font-size:12.5px;line-height:1.6;padding-left:18px;margin:4px 0 12px">';
  for (var i = 0; i < lista.length; i++) {
    var f = lista[i];
    var enJuego = f.tipoTarget === 'ROAS'
      ? '~' + fmtN(f.eurosMes, 0) + ' ' + moneda + '/mes'
      : '~' + fmtN(f.convMes, 1) + ' conv/mes';
    out += '<li><b>' + f.nombre + '</b> — ' + f.riesgo + ' · objetivo ' +
      (f.tipoTarget === 'ROAS' ? Math.round(f.objetivo * 100) + '%' : fmtN(f.objetivo) + ' ' + moneda) +
      ' vs. real ' + (f.tipoTarget === 'ROAS' ? Math.round(f.real * 100) + '%' : fmtN(f.real) + ' ' + moneda) +
      ' · en juego: ' + enJuego + '</li>';
  }
  return out + '</ul>';
}
Si el botón no te funciona por el navegador, haz clic dentro del recuadro y pulsa Ctrl+A y luego Ctrl+C (Cmd en Mac).
Vigía te dice qué está en riesgo. La siguiente pregunta es si ese riesgo te importa.

Porque una campaña puede subir el CPA un 40 % y seguir siendo rentable, y otra puede tener un ROAS estupendo y estarte comiendo el margen. La diferencia no está en el ROAS: está en el POAS, en tu beneficio real.