Google Ads script: Check Monthly Budget

The script checks whether the freely configurable monthly budget has been exceeded and pauses campaigns if required.

Alert Monitoring Save costs Changes in Google Ads (optional) Read-only (if desired) Adds Labels (optional)
Sends an e-mail when something should be checked
The script monitors the Google Ads account (hourly or daily execution).
The script helps to avoid unnecessary or unwanted expenditure.
If desired, changes can be made directly in the Google Ads account.
If desired, no changes will be made in Google Ads, the Merchant Center or Google Analytics.
If desired, the script can mark campaigns, ad groups or keywords with labels.

A monthly budget can be defined for each Google Ads account. This script continuously checks whether the expenditure has been exceeded. If so, you will be informed by email and, if desired, all search campaigns, display campaigns, shopping campaigns, video campaigns and Performance Max campaigns will be paused automatically. Individual campaigns can be excluded from pausing. The paused campaigns are automatically reactivated on the first day of the next month.

 Script developer

The script was developed by Nick Partridge ( from Andorra and released for publication here.

Nick Partridge Nick Partridge


Based on:

    Original Script: A Daily/Monthly Google Ads Budget Management Script
    Version:         2023-03-28
    Contact:         nick(.)w(.)partridge(@)gmail(.)com

We have made a few changes to the script

Among other things, Performance Max campaigns are now also taken into account.

 Example script configuration

Link to the demo configuration sheet for CheckMonthlyBudget.

 Configuration parameters

monthlyAccountBudgetIf this amount is exceeded in the Google Ads account, you will receive an e-mail and, if pauseCampaigns=true, active campaigns will be paused.
pauseCampaignstrue: All active search campaigns, display campaigns, shopping campaigns, video campaigns and Performance Max campaigns are paused if the budget is exceeded.
Default: false

Parameters that apply to all scripts


zc_ASMneverPauseByCheckMonthlyBudgetCampaigns with the label zc_ASMneverPauseByCheckMonthlyBudget are NOT paused.
zz_ASMpausedTemporarilyByCheckMonthlyBudgetCampaigns that have been paused by this script receive this label. Campaigns with this label are reactivated on the first of the following month.

 Download Google Ads script Check Monthly Budget

Please log in or register in the Ads Scripts Store first to download the script (why is this necessary?).

E-mail address

Do you have any questions?

I will gladly answer your questions
Google Ads Experte Holger Schulz
Holger Schulz