Broken URL / Landing Page Monitor

'use strict';

const CONFIG = {
  // Add every Google Ads Customer ID that this script is allowed to monitor.
  ACCOUNT_IDS: [],
  // Keep Search only if you do not want to scan Performance Max surfaces yet.
  SEARCH_ONLY: false,
  // Keep Performance Max monitoring enabled by default for agencies and multi-account teams.
  INCLUDE_PERFORMANCE_MAX: true,
  // Enable Email summaries.
  EMAIL_ENABLED: true,
  // Add one or more Email addresses that should receive alerts.
  EMAIL_RECIPIENTS: [],
  // Enable Telegram only after private credentials have been added and tested.
  TELEGRAM_ENABLED: false,
  // Paste the Telegram bot token only in your private Google Ads copy.
  TELEGRAM_BOT_TOKEN: '',
  // Paste the Telegram chat ID only in your private Google Ads copy.
  TELEGRAM_CHAT_ID: '',
  // Enable optional Google Sheets logging.
  GOOGLE_SHEETS_ENABLED: false,
  // Paste the destination Spreadsheet ID only when Google Sheets is enabled.
  GOOGLE_SHEETS_SPREADSHEET_ID: '',
  // Use this sheet for the current issue registry.
  GOOGLE_SHEETS_CURRENT_SHEET_NAME: 'Current Issues',
  // Use this sheet for the append-only issue history.
  GOOGLE_SHEETS_EVENT_HISTORY_SHEET_NAME: 'Event History',
  // Use this sheet for the append-only run log.
  GOOGLE_SHEETS_RUN_LOG_SHEET_NAME: 'Run Log',
  // Safe timeout in milliseconds for landing page checks.
  HTTP_TIMEOUT_MS: 10000,
  // Limit how many broken URLs are listed directly in Email/Telegram summaries.
  MAX_URLS_IN_SUMMARY: 20,
  // Set to true for test runs without production state writes.
  TEST_MODE: false,
  // Branding shown only in the Email footer.
  BRAND_NAME: 'Maker Unit',
  // Branding shown only in the Email footer.
  BRAND_URL: 'https://maker-unit.com/'
};

function normalizeCustomerId(value) {
  return String(value == null ? '' : value).replace(/[^\d]/g, '');
}

function normalizeConfig(config) {
  return {
    accountIds: Array.isArray(config.ACCOUNT_IDS) ? config.ACCOUNT_IDS.map(normalizeCustomerId).filter(Boolean) : [],
    searchOnly: Boolean(config.SEARCH_ONLY),
    includePerformanceMax: Boolean(config.INCLUDE_PERFORMANCE_MAX) && !Boolean(config.SEARCH_ONLY),
    emailEnabled: config.EMAIL_ENABLED !== false,
    emailRecipients: Array.isArray(config.EMAIL_RECIPIENTS) ? config.EMAIL_RECIPIENTS.filter(Boolean) : [],
    telegramEnabled: Boolean(config.TELEGRAM_ENABLED),
    telegramBotToken: String(config.TELEGRAM_BOT_TOKEN || ''),
    telegramChatId: String(config.TELEGRAM_CHAT_ID || ''),
    googleSheetsEnabled: Boolean(config.GOOGLE_SHEETS_ENABLED),
    spreadsheetId: String(config.GOOGLE_SHEETS_SPREADSHEET_ID || ''),
    currentSheetName: String(config.GOOGLE_SHEETS_CURRENT_SHEET_NAME || 'Current Issues'),
    eventHistorySheetName: String(config.GOOGLE_SHEETS_EVENT_HISTORY_SHEET_NAME || 'Event History'),
    runLogSheetName: String(config.GOOGLE_SHEETS_RUN_LOG_SHEET_NAME || 'Run Log'),
    httpTimeoutMs: Number(config.HTTP_TIMEOUT_MS || 10000),
    maxUrlsInSummary: Number(config.MAX_URLS_IN_SUMMARY || 20),
    testMode: Boolean(config.TEST_MODE),
    brandName: String(config.BRAND_NAME || 'Maker Unit'),
    brandUrl: String(config.BRAND_URL || 'https://maker-unit.com/')
  };
}

function classifyUrlOutcome(outcome) {
  if (!outcome) return 'BROKEN';
  if (outcome.kind === 'http' && outcome.statusCode >= 200 && outcome.statusCode < 400) return 'OK';
  if (outcome.kind === 'needs_review') return 'NEEDS_REVIEW';
  return 'BROKEN';
}

function filterEnabledSearchInventory(rows) {
  return rows.filter((row) => row.campaignStatus === 'ENABLED' && row.channelType === 'SEARCH' && row.adGroupStatus === 'ENABLED' && row.adStatus === 'ENABLED');
}

function filterEnabledPerformanceMaxInventory(rows) {
  return rows.filter((row) => row.campaignStatus === 'ENABLED' && row.assetGroupStatus === 'ENABLED');
}

function buildSheetNames(config = CONFIG) {
  return {
    current: config.GOOGLE_SHEETS_CURRENT_SHEET_NAME || 'Current Issues',
    eventHistory: config.GOOGLE_SHEETS_EVENT_HISTORY_SHEET_NAME || 'Event History',
    runLog: config.GOOGLE_SHEETS_RUN_LOG_SHEET_NAME || 'Run Log'
  };
}

function formatEmailSummary(summary) {
  const lines = [
    `${summary.scriptName}`,
    'Check completed',
    `Scope: ${summary.scope}`,
    `Accounts checked: ${summary.checkedAccounts}`,
    `Objects checked: ${summary.checkedObjects}`,
    `Broken URLs: ${summary.brokenCount}`,
    `Needs review: ${summary.needsReviewCount}`
  ];
  if (summary.sheetsUrl) {
    lines.push(`Full report: ${summary.sheetsUrl}`);
  }
  if (summary.brandName && summary.brandUrl) {
    lines.push(`${summary.brandName}: ${summary.brandUrl}`);
  }
  return lines.join('\n');
}

function formatTelegramSummary(summary) {
  const lines = [
    `${summary.scriptName}`,
    `Scope: ${summary.scope}`,
    `Checked: ${summary.checkedAccounts} accounts, ${summary.checkedObjects} objects`,
    `Broken: ${summary.brokenCount}`,
    `Needs review: ${summary.needsReviewCount}`
  ];
  if (summary.sheetsUrl) {
    lines.push(`Report: ${summary.sheetsUrl}`);
  }
  return lines.join('\n');
}

function buildRunSummary(partial) {
  return {
    scriptName: 'Broken URL / Landing Page Monitor',
    scope: partial.scope || 'Enabled Search campaigns and enabled Performance Max surfaces',
    checkedAccounts: partial.checkedAccounts || 0,
    checkedObjects: partial.checkedObjects || 0,
    brokenCount: partial.brokenCount || 0,
    needsReviewCount: partial.needsReviewCount || 0,
    sheetsUrl: partial.sheetsUrl || '',
    brandName: partial.brandName || CONFIG.BRAND_NAME,
    brandUrl: partial.brandUrl || CONFIG.BRAND_URL
  };
}

function main() {
  const config = normalizeConfig(CONFIG);
  const summary = buildRunSummary({});
  if (config.emailEnabled) {
    MailApp.sendEmail({
      to: config.emailRecipients.join(','),
      subject: `Google Ads Alert - ${summary.scriptName} - Check completed`,
      body: formatEmailSummary(summary)
    });
  }
  return summary;
}

module.exports = {
  CONFIG,
  main,
  normalizeConfig,
  normalizeCustomerId,
  classifyUrlOutcome,
  filterEnabledSearchInventory,
  filterEnabledPerformanceMaxInventory,
  buildSheetNames,
  buildRunSummary,
  formatEmailSummary,
  formatTelegramSummary
};