📗 This content is the Keywords Ninja Script 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.
Initial setup. In the Google Ads LOADER (the code you pasted from your panel), fill in the URL of your NKNS spreadsheet:
var NKNS_SPREADSHEET_URL = 'https://docs.google.com/spreadsheets/d/...';
In each local sheet: A18 = 'Yes' switches the filter on and A20 names the NKNS tab that holds the whitelist.
Filter logic. When it is on, a term is only accepted if AT LEAST ONE of its words matches the whitelist (as a whole word or by stem).
The filter is applied AFTER the scoring, so it only affects terms that already passed the quality filters. That makes the impact of the whitelist clearly visible in the final statistics.
Test mode (debugging)
When to use it. Set A4 = 'ON' in a local sheet to try out the configuration without adding real keywords. The script will show every term with its detailed evaluation in the 'Test' sheet.
What is shown. For each term: CTR, %Conv, CPC, base Score, semantic bonus, negative penalty, final Score, whether it passes the threshold, matching words (positive and negative), whether it passes the whitelist, final verdict, impressions, clicks, conversions, campaign and ad group.
Colour code. 🟢 Light green — Approved (passes every filter) 🟡 Yellow — Passes the score but fails the whitelist 🔴 Light red — Fails the score 🟢 Bold green text — positive semantic bonus applied 🔴 Bold red text — penalty for negative words applied
Several campaigns. In Test mode you can run several campaigns in the same go and the results pile up in the Test sheet (they are not overwritten). The sheet is only cleared at the start of each new run.