Skip to content

Installation Guide

Jump to bottom
John Williams edited this page Mar 13, 2026 · 1 revision

Installation Guide

Every script in this collection is a standalone JavaScript file designed to run directly in Google Ads Scripts. No external dependencies, npm packages, or build steps required.

Step-by-Step Installation

1. Access Google Ads Scripts

  1. Log into Google Ads
  2. Navigate to Tools & Settings → Bulk Actions → Scripts
  3. Click the + button to create a new script

2. Add the Script

  1. Delete any default code in the editor
  2. Open the .js file from this repository
  3. Copy the entire contents
  4. Paste into the Google Ads Scripts editor
  5. Give your script a descriptive name (e.g., "Anomaly Detection - Production")

3. Configure

Every script has a CONFIG object near the top. At minimum, you'll need to set:

const CONFIG = {
  // Your email for reports/alerts
  emailAddress: 'you@company.com',

  // Google Sheets URL (if the script uses Sheets)
  SPREADSHEET_URL: 'https://docs.google.com/spreadsheets/d/YOUR_SHEET_ID/edit',

  // Script-specific settings...
};

4. Authorize

  1. Click "Authorize" when prompted
  2. Grant permissions for:
    • Google Ads data access
    • Google Sheets (if applicable)
    • Gmail (for email reports)

5. Test

  1. Click "Preview" to run in read-only mode
  2. Check the Logs tab for output
  3. Review any Sheets output
  4. Verify no errors in the Changes tab

6. Deploy

  1. Click "Run" to execute with live changes
  2. Set up a Schedule (click the clock icon):
    • Hourly: monitoring and alerting scripts
    • Daily: reporting and management scripts
    • Weekly: auditing and analysis scripts

MCC (Manager Account) Scripts

Some scripts are designed to run from an MCC account to manage multiple child accounts:

  • mcc-label-assigner.js — runs from MCC
  • account-grader.js — runs on individual accounts

For MCC scripts:

  1. Log into your Manager Account
  2. Navigate to Scripts at the MCC level
  3. Follow the same steps above

Google Sheets Setup

Most scripts can output to Google Sheets. To set up:

  1. Create a new Google Sheet (or use an existing one)
  2. Copy the Sheet URL
  3. Paste into the script's SPREADSHEET_URL config
  4. The script will create tabs/sheets automatically on first run

Troubleshooting

See Troubleshooting for common issues and solutions.

Clone this wiki locally