📗 This content is the AI Max Analyzer user manual, the same one the script writes in the «Manual» tab of its spreadsheet. Here you can search it, listen to it, highlight it and save it to favourites.
CUSTOMER_ID: OPTIONAL since v2.38. Empty = the script analyses the CURRENT ACCOUNT (direct install in your account, the normal case for the free script). Filled in with a 10-digit ID (123-456-7890) = the script must run in a manager account (MCC) and will analyse that child account. If you fill in the ID on a single account (or leave it empty under an MCC), the script stops with a message explaining what to fix.
DATE_RANGE: LAST_7_DAYS / LAST_14_DAYS / LAST_30_DAYS (default) / LAST_90_DAYS.
EMAIL: Email for the monthly report + alerts. Empty = nothing is sent.
TOP_SEARCH_TERMS: Top N search terms (default 500).
SEARCH_TERMS_DAYS: The DEFAULT for the Top Search Terms tab own period. Since v2.24 the period is controlled LIVE from the tab itself with a DROPDOWN in cell A1 (yellow): pick the days (30/60/90/120/150/180) and it applies on the next run. The AI Max Combinations tab has its own dropdown just the same. This Config parameter is only used as the starting value or if the cell is empty/invalid. It is independent from the global DATE_RANGE.
TOP_COMBINATIONS: Top N combinations (default 200).
CONVERSION_ACTIONS: Empty = standard behaviour (it uses the Google Ads "Conversions" metric, which respects the "Include in Conversions" toggle of each action). If you set one or more names separated by commas, the script will ONLY count those conversions to compute Conv., CPA and ROAS on ALL tabs and emails. Useful if you work with Lead Scoring or have several conversions and want to isolate the metric that really matters. E.g. "Purchases" (that one only) or "Qualified Leads, Demos" (the sum of both). IMPORTANT: the names must match EXACTLY the ones configured in Google Ads — mind accents, capitals and spaces. If you set a name that does not exist in the account, nothing will be counted (you will see 0 conversions in Logs and tabs).
MIN_DAYS_AI_MAX: Minimum days for a reliable analysis (default 14).
ALERT_CPA_RATIO: CPA alert threshold, as a PERCENTAGE (default 25%). It is how much more AI Max may cost per conversion than your baseline before being flagged red / sending an alert. Write it with %: "50%" = warn me if AI Max costs 50% more. Since AI Max usually costs a bit more, many people set 40-60%.
ALERT_MIN_COST_PCT: Only alert if AI Max accounts for at least this % of the total account cost (default 10). It is the main filter: with little weight, the ratios are noise and are not worth alerting on. It works well for accounts of any size because it scales with total cost.
PRE_POST_MAX_WINDOW_DAYS: Maximum cap in days for the PRE and POST windows of the analysis (default 90, range 14-180). The real window is DYNAMIC: each campaign uses min(days since its activation, this cap). IMPORTANT: the POST window is the days IMMEDIATELY AFTER activation, NOT the last ones. Example: a campaign activated 200 days ago with a cap of 90 → PRE = the 90 days before AI Max was turned on, POST = the first 90 days with AI Max on (not the last 90). Reason: we want to know whether AI Max had an impact at launch, not how the business is performing lately.
FORCE_MONTHLY_EMAIL: Yes/No toggle (default No). Set it to "Yes" if you want to re-send the monthly email even though it was already sent this month — the script will skip the PropertiesService lock that normally prevents two monthlies in the same calendar month. Once sent, the field goes back to "No" automatically so later weekly runs do not re-send the monthly by accident. Useful when the script changes and you want to regenerate the monthly with the new version, or simply to check the email format.