📗 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.
One of the features that pays for this tool is ticking the irrelevant queries AI Max is triggering to add them as negative keywords. The script supports TWO complementary flows:
FLOW A — EXACT negative per search term (individual queries):
1. Decide the level: If you want to block the query across the WHOLE campaign (the usual case) → go to Top Search Terms. If you want to block it in ONE specific ad group only (because it lands in the wrong group and converts in another one) → go to AI Max Combinations.
2. Tick the checkboxes: In the first column of the tab you will see empty checkboxes. Tick the ones matching queries you want to add as an exact negative. You can tick several at once. The checkboxes stay ticked until the next run of the script.
3. Run the script: On the next scheduled run (or running it manually), before regenerating the tabs the script reads the ticked checkboxes, adds the exact negatives at the matching level, and clears the checkboxes for the next round.
FLOW B — BROAD negative per keyword (patterns that repeat):
1. Read the analysis: In Top Search Terms, to the right (columns O onwards), you have the two blocks of the repeated-words analysis (see the "REPEATED-WORDS ANALYSIS" section). Decide which individual keywords bring noise (typically the ones in the red block, those appearing in ≥2 terms with no conversion).
2. Tick the scope checkbox: Every word in the analysis has TWO checkboxes at the start of its row, and each one fires on its own (you do NOT need to tick both): (a) "Broad negative" → adds the word as a broad negative ONLY in the campaigns where it appears (the ones counted by "# Camp."); (b) "All campaigns" → adds it across ALL your AI Max campaigns in the account. Tick whichever matches the scope you want. If you tick both, "All campaigns" wins.
3. Run the script: On the next run, the script processes the ticked words and adds the negative in broad match with the chosen scope (its campaigns or all of them). Important: it creates the negative with the REAL SPELLING of the word (with and without the accent if both show up) because Google is accent-sensitive — "aplicacion" does not block "aplicación". It is logged in "Negatives Added" with match type "Broad".
For both flows:
- Checking: Open the "Negatives Added" tab to see the history of what was added, when, in which campaign/ad group and its status. If something failed (renamed campaign, search term with characters that are not allowed, etc.) you will see it in the "Status" column. You can also verify it in Google Ads → Keywords → Negative keywords.
IMPORTANT — limitations to be aware of:
Label in Google Ads: Google Ads Scripts does NOT allow applying labels to negative keywords — only to positive ones, campaigns, ad groups and ads. That is why the "Added by Ai Max" label materialises as a history in the "Negatives Added" tab instead of a native Google Ads label. It is the documented and supported way to have traceability.
Match types: FLOW A: always EXACT match (it blocks only that specific query, not variants). FLOW B: always BROAD match (it blocks any query containing that word, in any order). The script does not support PHRASE match — if you need it, add it manually in Google Ads.
Duplicates: If you tick a negative that already existed with the same match type, the script detects it and does NOT add it twice (status "Skipped: it already existed as an exact negative" or "Skipped: it already existed as a broad negative").
Special characters: Google Ads does NOT allow certain symbols in keywords (? ! @ # % * ( ) [ ] { } etc.). The script strips them automatically before adding. If no valid text is left after cleaning, the row is skipped and you will see it in the status.
Maximum length: Google Ads limits keywords to 80 characters. If the search term is longer, the script truncates it to 80 before adding (uncommon — most queries are short).