📗 Este contenido es el manual de uso de AI Max Analyzer, el mismo que el script escribe en la pestaña «Manual» de su hoja de cálculo. Aquí puedes buscarlo, escucharlo, subrayarlo y guardarlo en favoritos.
CUSTOMER_ID: OPCIONAL desde v2.38. Vacío = el script analiza la CUENTA ACTUAL (instalación directa en tu cuenta, el caso normal del script gratuito). Relleno con un ID de 10 dígitos (123-456-7890) = el script debe ejecutarse en un MCC y analizará esa cuenta hija. Si rellenas el ID en una cuenta individual (o lo dejas vacío en un MCC), el script se detiene con un mensaje explicando qué corregir.
DATE_RANGE: LAST_7_DAYS / LAST_14_DAYS / LAST_30_DAYS (default) / LAST_90_DAYS.
EMAIL: Email para reporte mensual + alertas. Vacío = no envía.
TOP_SEARCH_TERMS: Top N search terms (default 500).
SEARCH_TERMS_DAYS: DEFAULT del período propio de la pestaña Top Search Terms. Desde v2.24 el período se controla EN VIVO desde la propia pestaña con un DESPLEGABLE en la celda A1 (amarilla): elige los días (30/60/90/120/150/180) y se aplicará en la próxima ejecución. La pestaña Combinaciones AI Max tiene su propio desplegable igual. Este parámetro de Config solo se usa como valor inicial o si la celda está vacía/inválida. Es independiente del DATE_RANGE global.
TOP_COMBINATIONS: Top N combinaciones (default 200).
CONVERSION_ACTIONS: Vacío = comportamiento estándar (usa la métrica "Conversions" de Google Ads, que respeta el toggle "Incluir en Conversiones" de cada acción). Si pones uno o varios nombres separados por comas, el script SOLO contabilizará esas conversiones para calcular Conv., CPA y ROAS en TODAS las pestañas y emails. Útil si trabajas con Lead Scoring o tienes múltiples conversiones y quieres aislar la métrica que de verdad importa. Ej: "Compras" (solo esa) o "Leads Cualificados, Demos" (suma de ambas). IMPORTANTE: los nombres deben coincidir EXACTAMENTE con los configurados en Google Ads — respeta tildes, mayúsculas y espacios. Si pones un nombre que no existe en la cuenta, no se contará nada (verás 0 conversiones en Logs y pestañas).
MIN_DAYS_AI_MAX: Días mínimos para análisis fiable (default 14).
ALERT_CPA_RATIO: Umbral de alerta de CPA, en PORCENTAJE (default 25%). Es cuánto puede costar AI Max DE MÁS por conversión que tu baseline antes de marcarse rojo / enviar alerta. Escríbelo con %: "50%" = avisar si AI Max cuesta un 50% más. Como AI Max suele costar algo más, muchos ponen 40-60%.
ALERT_MIN_COST_PCT: Solo alerta si AI Max representa al menos este % del coste total de cuenta (default 10). Es el filtro principal: con poco peso, las ratios son ruido y no merece la pena alertar. Funciona bien para cuentas de cualquier tamaño porque escala con el coste total.
PRE_POST_MAX_WINDOW_DAYS: Tope máximo en días de las ventanas PRE y POST del análisis (default 90, rango 14-180). La ventana real es DINÁMICA: cada campaña usa min(días desde su activación, este tope). IMPORTANTE: el POST son los días INMEDIATAMENTE POSTERIORES a la activación, NO los últimos. Ejemplo: campaña activada hace 200 días con tope 90 → PRE = 90 días antes de activar AI Max, POST = los primeros 90 días con AI Max activo (no los últimos 90). Razón: queremos saber si AI Max tuvo un impacto al arrancar, no cómo está rindiendo el negocio últimamente.
FORCE_MONTHLY_EMAIL: Toggle Sí/No (default No). Pónlo en "Sí" si quieres reenviar el email mensual aunque ya se haya enviado este mes — el script saltará el bloqueo del PropertiesService que normalmente impide dos mensuales en el mismo mes natural. Tras enviarse, el campo vuelve automáticamente a "No" para que las ejecuciones semanales posteriores no reenvíen el mensual sin querer. Útil cuando hay cambios en el script y quieres regenerar el mensual con la versión nueva, o simplemente para verificar el formato del email.