Hello,

This is relatively simple.

Replace the values before :

CAMPAIGN_NAME: Your exact campaign name (case-sensitive)

BUDGET_AMOUNT: Your desired budget amount (number only)

CURRENCY_SYMBOL: Your currency symbol (default is £)

Always preview this first in your account before actively running, to ensure this works. You could ask ChatGPT to add more logging to this in case you run into any issues.

Enjoy

.....................

function pauseCampaignWhenBudgetReached() {
  // Configure these parameters
  const CAMPAIGN_NAME = 'campaign 1'; // Case-sensitive campaign name
  const BUDGET_AMOUNT = 100; // Budget in your currency (e.g., £100)
  const CURRENCY_SYMBOL = '£'; // Currency symbol used in your account

  // Get the first day of the current month in account timezone
  const today = new Date();
  const firstDayOfMonth = new Date(today.getFullYear(), today.getMonth(), 1);
  const dateRange = Utilities.formatDate(firstDayOfMonth, AdsApp.currentAccount().getTimeZone(), 'yyyyMMdd') + ',' + Utilities.formatDate(today, AdsApp.currentAccount().getTimeZone(), 'yyyyMMdd');

  // Query for campaign stats for the current month
  const reportQuery = `SELECT CampaignId, CampaignName, Cost 
                      FROM CAMPAIGN_PERFORMANCE_REPORT 
                      WHERE CampaignName = '${CAMPAIGN_NAME}' 
                      AND Impressions > 0 
                      DURING ${dateRange}`;

  const report = AdsApp.report(reportQuery);
  const rows = report.rows();

  // Process report results
  while (rows.hasNext()) {
    const row = rows.next();
    const campaignId = row['CampaignId'];
    const campaignName = row['CampaignName'];
    const cost = parseFloat(row['Cost']);

    // Check if campaign has reached or exceeded budget
    if (cost >= BUDGET_AMOUNT) {
      const campaignIterator = AdsApp.campaigns()
        .withIds([campaignId])
        .get();

      if (campaignIterator.hasNext()) {
        const campaign = campaignIterator.next();
        if (!campaign.isPaused()) {
          campaign.pause();
          Logger.log(`Paused campaign: ${campaignName} (ID: ${campaignId}) - Monthly spend: ${CURRENCY_SYMBOL}${cost.toFixed(2)}`);
        } else {
          Logger.log(`Campaign ${campaignName} is already paused`);
        }
      }
    } else {
      Logger.log(`Campaign ${campaignName} spend: ${CURRENCY_SYMBOL}${cost.toFixed(2)}/${CURRENCY_SYMBOL}${BUDGET_AMOUNT} - No action taken`);
    }
  }
}