اسکریپت گوگل ادز | کد آماده گزارش ماهانه + ۵ اسکریپت کاربردی

اسکریپت گوگل ادز چیست؟

بیایید خیلی ساده توضیح بدهیم. فرض کنید شما یک مغازه دارید و هر روز صبح باید موجودی انبار را چک کنید، قیمت‌ها را تنظیم کنید و ببینید کدام محصول بیشتر فروش رفته. حالا تصور کنید یک دستیار هوشمند دارید که تمام این کارها را خودکار انجام می‌دهد و فقط گزارش نهایی را به ایمیل‌تان می‌فرستد. اسکریپت گوگل ادز دقیقاً همین دستیار هوشمند است، اما برای تبلیغات گوگل شما.

از نظر فنی، Google Ads Scripts تکه‌کدهایی به زبان JavaScript هستند که مستقیماً داخل داشبورد گوگل ادز اجرا می‌شوند. این کدها می‌توانند اطلاعات اکانت شما را بخوانند، تحلیل کنند و حتی تغییرات خودکار اعمال کنند.

اسکریپت‌های گوگل ادز چگونه کار می‌کنند؟

ساز و کار اسکریپت‌ها بسیار ساده است:

1. شما یک کد JavaScript را داخل بخش Scripts در اکانت Google Ads وارد می‌کنید
2. مشخص می‌کنید این اسکریپت هر چند وقت یکبار اجرا شود (مثلاً هر روز، هر هفته یا هر ساعت)
3. اسکریپت به صورت خودکار اجرا شده، داده‌ها را جمع‌آوری و تحلیل می‌کند
4. نتیجه نهایی (مثلاً یک گزارش ایمیلی یا تغییر خودکار در bid) اعمال می‌شود

«اسکریپت‌های گوگل ادز مثل یک کارمند شبانه‌روزی هستند که هیچ وقت خسته نمی‌شوند، اشتباه نمی‌کنند و دقیقاً همان کاری را انجام می‌دهند که شما خواسته‌اید.»

— احسان قسیمی، متخصص گوگل ادز در وبینیو

اهمیت استفاده از اسکریپت در اکانت گوگل ادز

داشبورد گوگل ادز فوق‌العاده بزرگ و پیچیده است. ده‌ها منو، صدها تنظیم مختلف و هزاران نقطه داده وجود دارد. وقتی کمپین‌های تبلیغاتی شما زیاد می‌شوند، بررسی دستی تمام این اطلاعات عملاً غیرممکن است. اینجاست که اسکریپت‌های گوگل ادز وارد بازی می‌شوند.

• صرفه‌جویی در زمان: کارهایی که ساعت‌ها وقت می‌برد، در چند ثانیه انجام می‌شود
• کاهش خطای انسانی: ماشین اشتباه محاسباتی نمی‌کند
• مانیتورینگ ۲۴ ساعته: اسکریپت حتی نیمه‌شب هم کمپین‌ها را زیر نظر دارد
• شناسایی گلوگاه‌های بودجه: دقیقاً مشخص می‌کند کجا پول شما هدر می‌رود
• تصمیم‌گیری داده‌محور: به جای حدس و گمان، بر اساس داده واقعی عمل می‌کنید

تجربه واقعی وبینیو: کاهش ۴۵٪ هزینه کلیک با اسکریپت گوگل ادز (پروژه دامون کارز)

بگذارید یک داستان واقعی تعریف کنیم. ما در آژانس وبینیو پروژه‌ای داشتیم به نام «دامون کارز» — یک شرکت خودرویی که تبلیغات گوگل ادز گسترده‌ای داشت. مشکل اصلی چه بود؟ هزینه هر کلیک (CPC) حدود ۲۰ درهم بود و مشتری حس می‌کرد بودجه‌اش دارد آب می‌شود بدون بازگشت سرمایه مناسب.

مشکل چه بود؟

داشبورد گوگل ادز خیلی بزرگ است و آپشن‌های فراوانی دارد. وقتی کمپین‌های متعددی فعال هستند، پیدا کردن اینکه دقیقاً کجا بودجه هدر می‌رود مثل پیدا کردن سوزن در انبار کاه است. ما نمی‌دانستیم:

• کدام ساعات روز بیشترین هزینه و کمترین بازدهی را دارند؟
• کدام کمپین‌ها زودتر از موعد بودجه‌شان تمام می‌شود؟
• کدام روزهای هفته بهتر عمل می‌کنند؟

راه‌حل: اسکریپت سفارشی گوگل ادز

ما یک اسکریپت گزارش‌دهی ماهانه نوشتیم که سه تحلیل اساسی را خودکار انجام می‌داد:

1. تحلیل ساعتی: عملکرد هر ساعت از شبانه‌روز را بررسی و بهترین و بدترین ساعت‌ها را مشخص می‌کرد
2. تحلیل بودجه: به طور میانگین هر کمپین چه ساعتی بودجه‌اش تمام می‌شد و چند درصد از بودجه روزانه مصرف می‌شد
3. تحلیل روز هفته: عملکرد هر روز هفته را مقایسه و پیشنهاد افزایش یا کاهش bid می‌داد

نتیجه شگفت‌انگیز بود. با مانیتور روزانه موارد مهم از طریق اسکریپت، توانستیم دقیقاً همان گلوگاه‌هایی که بودجه ما را می‌خورد شناسایی و هدف بگیریم. هم هزینه‌مان پایین آمد و هم لید بیشتر و با کیفیت‌تری جذب کردیم.

«بزرگ‌ترین مشکل اکثر تبلیغ‌دهندگان این نیست که بودجه کم دارند. مشکل این است که نمی‌دانند بودجه‌شان کجا خرج می‌شود. اسکریپت گوگل ادز این مشکل را حل می‌کند.»

— احسان قسیمی، وبینیو

اسکریپت گزارش ماهانه گوگل ادز — توضیح ساده کد (مثل آب خوردن!)

حالا بیایید اسکریپتی که در پروژه دامون کارز استفاده کردیم را خیلی ساده توضیح بدهیم. نگران نباشید؛ قرار نیست کد بنویسید. فقط می‌خواهیم بدانید این اسکریپت چه کار می‌کند تا ارزش آن را درک کنید.

این اسکریپت دقیقاً چه کار می‌کند؟

تصور کنید هر ماه یک گزارش حرفه‌ای و رنگی مثل زیر به ایمیل‌تان می‌آید:

• بخش ۱ — آمار کلی: کل هزینه ماه، تعداد کلیک، تعداد Conversion (تبدیل)، میانگین هزینه هر تبدیل و نرخ تبدیل. مثل یک داشبورد مدیریتی کوچک
• بخش ۲ — تحلیل ساعتی: برای هر ساعت از شبانه‌روز (۰۰:۰۰ تا ۲۳:۰۰) نشان می‌دهد چند کلیک، چقدر هزینه و چند تبدیل داشته‌اید. سپس پیشنهاد می‌دهد: «این ساعت bid را ۲۵٪ بالا ببر» یا «این ساعت bid را ۳۰٪ کم کن»
• بخش ۳ — الگوی بودجه: برای هر کمپین نشان می‌دهد به طور میانگین ساعت چند بودجه تمام می‌شود. اگر کمپینی ساعت ۱۴:۰۰ بودجه‌اش تمام شود، یعنی نیمی از روز تبلیغ نداشته‌اید!
• بخش ۴ — تحلیل روز هفته: مشخص می‌کند شنبه بهتر است یا سه‌شنبه. کدام روز بیشترین تبدیل و کمترین هزینه را دارد
• بخش ۵ — توصیه‌های کلیدی: خودکار پیشنهاد می‌دهد کجا بودجه اضافه کنید و کجا کم کنید

چرا این اسکریپت ارزشمند است؟

فرض کنید بودجه روزانه کمپین شما ۱۰۰ درهم است. بدون اسکریپت ممکن است متوجه نشوید که:

1. بودجه شما ساعت ۱۵:۰۰ تمام می‌شود و از ۱۵:۰۰ تا ۲۳:۰۰ هیچ تبلیغی نمایش داده نمی‌شود
2. بهترین ساعت برای تبدیل شما ۲۰:۰۰ تا ۲۲:۰۰ است — دقیقاً ساعاتی که تبلیغ‌تان آفلاین است!
3. روزهای جمعه هزینه بالا اما تبدیل صفر دارید

اسکریپت تمام این اطلاعات را استخراج، تحلیل و به زبان ساده با نمودار رنگی به ایمیل‌تان می‌فرستد.

آموزش اضافه کردن اسکریپت به اکانت گوگل ادز (قدم به قدم)

اضافه کردن اسکریپت به اکانت Google Ads کار بسیار ساده‌ای است. حتی اگر هیچ تجربه فنی ندارید، با دنبال کردن این مراحل می‌توانید در کمتر از ۱۰ دقیقه اولین اسکریپت گوگل ادز خود را راه‌اندازی کنید.

مرحله ۱: ورود به بخش Scripts در گوگل ادز

1. وارد اکانت Google Ads خود شوید
2. در منوی بالا سمت چپ، روی آیکون Tools & Settings (آچار) کلیک کنید
3. در بخش Bulk Actions، گزینه Scripts را انتخاب کنید

مرحله ۲: ایجاد اسکریپت جدید

1. روی دکمه آبی رنگ + (New Script) کلیک کنید
2. یک نام مناسب برای اسکریپت خود انتخاب کنید (مثلاً: «Monthly Hourly Report»)
3. ممکن است گوگل از شما درخواست Authorization (مجوز دسترسی) کند — دکمه Authorize را بزنید و اکانت خود را تأیید کنید

مرحله ۳: کپی و پیست کردن کد اسکریپت

1. کد اسکریپت مورد نظر را کپی کنید
2. محتوای پیش‌فرض ویرایشگر را پاک کنید
3. کد را در ویرایشگر Scripts پیست کنید
4. تنظیمات مورد نیاز را ویرایش کنید (مثلاً آدرس ایمیل گیرنده گزارش)

مرحله ۴: تست اسکریپت (Preview)

1. روی دکمه Preview کلیک کنید
2. صبر کنید تا اسکریپت اجرای آزمایشی انجام دهد
3. بخش Logs را بررسی کنید — اگر خطایی نباشد، همه چیز درست است
4. اگر اسکریپت ایمیل ارسال می‌کند، ایمیل خود را چک کنید

مرحله ۵: زمان‌بندی و ذخیره

1. روی Save کلیک کنید
2. فرکانس اجرای اسکریپت را تنظیم کنید (مثلاً: Weekly — هر هفته یکشنبه)
3. اسکریپت از این به بعد به صورت خودکار در زمان تعیین‌شده اجرا می‌شود

۵ اسکریپت کاربردی گوگل ادز که حتماً باید امتحان کنید

علاوه بر اسکریپت گزارش ماهانه‌ای که بالاتر توضیح دادیم، اسکریپت‌های کاربردی دیگری هم وجود دارد که می‌تواند عملکرد کمپین‌های گوگل ادز شما را متحول کند. در ادامه ۵ مورد از پرکاربردترین آن‌ها را معرفی می‌کنیم:

۱. اسکریپت گزارش ساعتی و بودجه (Hourly & Budget Pacing Report)

همان اسکریپتی که در پروژه دامون کارز استفاده کردیم. این اسکریپت:

• عملکرد هر ساعت از شبانه‌روز را تحلیل می‌کند
• ساعت تمام شدن بودجه هر کمپین را مشخص می‌کند
• پیشنهاد bid adjustment بر اساس نرخ تبدیل ارائه می‌دهد
• الگوی روز هفته را نشان می‌دهد
• گزارش رنگی و حرفه‌ای به ایمیل ارسال می‌کند

لینک دانلود این اسکریپت رو بالاتر قرار دادیم.

۲. اسکریپت بررسی لینک‌های خراب (Broken URL Checker)

فرض کنید لندینگ پیج یکی از تبلیغات‌تان خراب شده و خطای ۴۰۴ می‌دهد. شما دارید برای هر کلیک پول می‌دهید ولی کاربر به صفحه‌ای می‌رسد که وجود ندارد! این اسکریپت به صورت خودکار تمام URL های تبلیغات‌تان را بررسی و لینک‌های خراب را گزارش می‌کند.

/**
 * Google Ads — Broken Link Checker
 * بررسی URL نهایی تبلیغ‌ها، کلمات کلیدی و سایت‌لینک‌ها
 * و ارسال گزارش لینک‌های شکسته به ایمیل (RTL فارسی)
 *
 * نحوه اجرا: Tools › Bulk actions › Scripts › ساخت اسکریپت جدید
 * زمان‌بندی پیشنهادی: روزانه (Daily)
 */

var CONFIG = {
  // ایمیل گیرنده (چند ایمیل را با کاما جدا کنید)
  RECIPIENT_EMAIL: 'you@example.com',

  // فقط این کدها سالم محسوب می‌شوند؛ بقیه «شکسته» گزارش می‌شوند
  // اگر می‌خواهید ریدایرکت‌ها هم سالم باشند، followRedirects روی true است و فقط 200 می‌ماند
  OK_STATUS_CODES: [200],

  // بررسی سایت‌لینک‌ها (اگر خطا داد، false کنید)
  CHECK_SITELINKS: true,

  // بررسی URL نسخه موبایل علاوه بر URL اصلی
  CHECK_MOBILE_URLS: true,

  // ارسال ایمیل حتی وقتی هیچ لینک شکسته‌ای نیست
  SEND_EMAIL_WHEN_NO_ERRORS: false,

  // حداکثر تعداد منبع نمایشی برای هر URL در جدول
  MAX_SOURCES_PER_URL: 5,

  // User-Agent برای کاهش خطای کاذب 403 از سمت بعضی سرورها
  USER_AGENT: 'Mozilla/5.0 (compatible; AdsLinkChecker/1.0; +https://www.google.com/adsbot.html)'
};

function main() {
  var urlMap = {}; // url -> { sources: {} }

  collectAdUrls(urlMap);
  collectKeywordUrls(urlMap);
  if (CONFIG.CHECK_SITELINKS) {
    try { collectSitelinkUrls(urlMap); }
    catch (e) { Logger.log('خطا در خواندن سایت‌لینک‌ها (نادیده گرفته شد): ' + e.message); }
  }

  var urls = Object.keys(urlMap);
  Logger.log('تعداد URL یکتا برای بررسی: ' + urls.length);

  var broken = [];
  for (var i = 0; i < urls.length; i++) {
    var url = urls[i];
    var result = checkUrl(url);
    if (CONFIG.OK_STATUS_CODES.indexOf(result.code) === -1) {
      broken.push({
        url: url,
        status: result.code,
        note: result.note,
        sources: Object.keys(urlMap[url].sources).slice(0, CONFIG.MAX_SOURCES_PER_URL)
      });
    }
  }

  Logger.log('تعداد لینک شکسته: ' + broken.length);

  if (broken.length > 0 || CONFIG.SEND_EMAIL_WHEN_NO_ERRORS) {
    sendEmailReport(broken, urls.length);
  }
}

/* ---------- جمع‌آوری URL ها ---------- */

function addUrl(urlMap, url, sourceLabel) {
  if (!url) return;
  if (!urlMap[url]) urlMap[url] = { sources: {} };
  urlMap[url].sources[sourceLabel] = true;
}

function collectAdUrls(urlMap) {
  var it = AdsApp.ads()
    .withCondition("Status = ENABLED")
    .withCondition("CampaignStatus = ENABLED")
    .withCondition("AdGroupStatus = ENABLED")
    .get();
  while (it.hasNext()) {
    var ad = it.next();
    var urls = ad.urls();
    var label = 'تبلیغ | ' + ad.getCampaign().getName() + ' › ' + ad.getAdGroup().getName();
    addUrl(urlMap, urls.getFinalUrl(), label);
    if (CONFIG.CHECK_MOBILE_URLS) addUrl(urlMap, urls.getMobileFinalUrl(), label + ' (موبایل)');
  }
}

function collectKeywordUrls(urlMap) {
  var it = AdsApp.keywords()
    .withCondition("Status = ENABLED")
    .withCondition("CampaignStatus = ENABLED")
    .withCondition("AdGroupStatus = ENABLED")
    .get();
  while (it.hasNext()) {
    var kw = it.next();
    var urls = kw.urls();
    var label = 'کلمه کلیدی | ' + kw.getText();
    addUrl(urlMap, urls.getFinalUrl(), label);
    if (CONFIG.CHECK_MOBILE_URLS) addUrl(urlMap, urls.getMobileFinalUrl(), label + ' (موبایل)');
  }
}

function collectSitelinkUrls(urlMap) {
  var it = AdsApp.extensions().sitelinks()
    .withCondition("Status = ENABLED")
    .get();
  while (it.hasNext()) {
    var sl = it.next();
    var urls = sl.urls();
    var label = 'سایت‌لینک | ' + sl.getLinkText();
    addUrl(urlMap, urls.getFinalUrl(), label);
    if (CONFIG.CHECK_MOBILE_URLS) addUrl(urlMap, urls.getMobileFinalUrl(), label + ' (موبایل)');
  }
}

/* ---------- بررسی وضعیت URL ---------- */

function checkUrl(url) {
  var testUrl = url.split('{{')[0];
  if (testUrl.indexOf('http') !== 0) {
    return { code: 'نامعتبر', note: 'URL فاقد دامنه معتبر' };
  }
  try {
    var response = UrlFetchApp.fetch(testUrl, {
      muteHttpExceptions: true,
      followRedirects: true,
      validateHttpsCertificates: false,
      headers: { 'User-Agent': CONFIG.USER_AGENT }
    });
    return { code: response.getResponseCode(), note: '' };
  } catch (e) {
    return { code: 'خطا', note: String(e.message || e) };
  }
}

/* ---------- ساخت و ارسال ایمیل ---------- */

function sendEmailReport(broken, totalChecked) {
  var accountName = AdsApp.currentAccount().getName();
  var today = Utilities.formatDate(new Date(), AdsApp.currentAccount().getTimeZone(), 'yyyy-MM-dd HH:mm');

  var rows = '';
  for (var i = 0; i < broken.length; i++) {
    var b = broken[i];
    var statusColor = (b.status === 404 || b.status === 'خطا' || b.status === 'نامعتبر') ? '#DB2D2E' : '#b8860b';
    rows +=
      '<tr style="border-bottom:1px solid #eee;">' +
        '<td style="padding:10px;text-align:center;color:#666;">' + (i + 1) + '</td>' +
        '<td style="padding:10px;text-align:center;font-weight:bold;color:' + statusColor + ';">' + b.status + '</td>' +
        '<td style="padding:10px;word-break:break-all;">' +
          '<a href="' + b.url + '" style="color:#1a73e8;text-decoration:none;">' + b.url + '</a>' +
          (b.note ? '<div style="color:#999;font-size:12px;margin-top:4px;">' + b.note + '</div>' : '') +
        '</td>' +
        '<td style="padding:10px;color:#444;font-size:13px;">' + b.sources.join('<br>') + '</td>' +
      '</tr>';
  }

  var body = broken.length
    ? '<table style="width:100%;border-collapse:collapse;background:#fff;border:1px solid #eee;border-radius:8px;overflow:hidden;">' +
        '<thead><tr style="background:#1f2937;color:#fff;">' +
          '<th style="padding:12px;">#</th>' +
          '<th style="padding:12px;">کد وضعیت</th>' +
          '<th style="padding:12px;">آدرس لینک</th>' +
          '<th style="padding:12px;">منبع</th>' +
        '</tr></thead><tbody>' + rows + '</tbody></table>'
    : '<p style="padding:20px;background:#e8f5e9;border-radius:8px;color:#2e7d32;">✅ هیچ لینک شکسته‌ای یافت نشد.</p>';

  var html =
  '<div dir="rtl" style="font-family:Estedad,Tahoma,Arial,sans-serif;background:#f5f5f5;padding:24px;color:#222;line-height:2;">' +
    '<div style="max-width:760px;margin:0 auto;">' +
      '<h2 style="margin:0 0 4px;">🔗 گزارش لینک‌های شکسته گوگل ادز</h2>' +
      '<p style="color:#666;margin:0 0 16px;">حساب: <b>' + accountName + '</b> — تاریخ: ' + today + '</p>' +
      '<div style="display:inline-block;background:#fff;border:1px solid #eee;border-radius:8px;padding:12px 18px;margin-bottom:18px;">' +
        'کل URL بررسی‌شده: <b>' + totalChecked + '</b> &nbsp;|&nbsp; ' +
        'لینک شکسته: <b style="color:#DB2D2E;">' + broken.length + '</b>' +
      '</div>' +
      body +
      '<p style="color:#999;font-size:12px;margin-top:20px;">تولید خودکار توسط Google Ads Script</p>' +
    '</div>' +
  '</div>';

  MailApp.sendEmail({
    to: CONFIG.RECIPIENT_EMAIL,
    subject: '🔗 لینک‌های شکسته گوگل ادز (' + broken.length + ' مورد) — ' + accountName,
    htmlBody: html
  });
}

۳. اسکریپت مدیریت کلمات کلیدی منفی (Negative Keywords Manager)

این اسکریپت سرچ ترم‌هایی (Search Terms) که کلیک بالا اما تبدیل صفر دارند را شناسایی و به لیست کلمات کلیدی منفی پیشنهاد می‌دهد. یکی از سریع‌ترین راه‌ها برای کاهش هزینه‌های بیهوده.

۳. اسکریپت مدیریت کلمات کلیدی منفی (Negative Keywords Manager)

این اسکریپت سرچ ترم‌هایی (Search Terms) که کلیک بالا اما تبدیل صفر دارند را شناسایی و به لیست کلمات کلیدی منفی پیشنهاد می‌دهد. یکی از سریع‌ترین راه‌ها برای کاهش هزینه‌های بیهوده.

function main() {
  // --- تنظیمات اسکریپت ---
  var CLICK_THRESHOLD = 10;          // حداقل تعداد کلیک برای بررسی یک سرچ ترم
  var NEGATIVE_LIST_NAME = "Automated_Negative_Keywords"; // نام لیست کلمات کلیدی منفی شما
  var TIME_DURATION = "LAST_7_DAYS"; // بازه زمانی بررسی (مثلاً LAST_14_DAYS یا LAST_30_DAYS)
  // ----------------------

  // ۱. پیدا کردن یا ساختن لیست کلمات کلیدی منفی
  var sharedNegativeKeywordList = getOrCreateNegativeList(NEGATIVE_LIST_NAME);
  
  // ۲. کوئری برای دریافت سرچ ترم‌های پرکلیک بدون تبدیل
  var report = AdsApp.report(
    "SELECT SearchTermView, CampaignName, Clicks, Conversions " +
    "FROM SEARCH_TERM_VIEW " +
    "WHERE Clicks >= " + CLICK_THRESHOLD + " AND Conversions = 0 " +
    "DURING " + TIME_DURATION
  );

  var rows = report.rows();
  var addedCount = 0;

  while (rows.hasNext()) {
    var row = rows.next();
    var searchTerm = row['SearchTermView'];
    
    // اضافه کردن سرچ ترم به لیست منفی به صورت Phrase Match (برای دقت بیشتر)
    sharedNegativeKeywordList.addNegativeKeyword("[" + searchTerm + "]");
    Logger.log("کلمه کلیدی منفی اضافه شد: " + searchTerm + " | تعداد کلیک: " + row['Clicks']);
    addedCount++;
  }

  Logger.log("اجرا به پایان رسید. تعداد " + addedCount + " کلمه کلیدی منفی جدید به لیست اضافه شد.");
}

// تابع کمکی برای مدیریت لیست کلمات منفی
function getOrCreateNegativeList(listName) {
  var listIterator = AdsApp.negativeKeywordLists()
    .withCondition("Name = '" + listName + "'")
    .get();
    
  if (listIterator.hasNext()) {
    return listIterator.next();
  } else {
    // اگر لیست وجود نداشت، یک لیست جدید می‌سازد
    var listBuilder = AdsApp.newNegativeKeywordListBuilder();
    var listOperation = listBuilder.withName(listName).build();
    return listOperation.getResult();
  }
}

نکات مهم برای شخصی‌سازی و اجرا:

• تنظیم حد آستانه (CLICK_THRESHOLD): عدد 10 یک استاندارد اولیه است. اگر بودجه شما محدود است یا نرخ تبدیل بالایی دارید، می‌توانید آن را روی ۵ یا ۷ بگذارید. اگر محصول گرانی می‌فروشید، شاید بهتر باشد روی ۱۵ یا ۲۰ تنظیم شود.
• نوع انطباق (Match Type): در کد بالا، کلمات به صورت Exact Match (با علامت [ ]) اضافه می‌شوند تا دقیقاً همان عبارت مسدود شود. اگر می‌خواهید کل عبارت و کلمات پیرامونش مسدود شوند، می‌توانید آن را به Phrase Match (با علامت " ") تغییر دهید.
• اتصال لیست به کمپین‌ها: این اسکریپت کلمات را به یک لیست اشتراکی (Shared List) به نام Automated_Negative_Keywords اضافه می‌کند. فراموش نکنید که پس از اولین اجرای اسکریپت، به بخش Tools > Negative keyword lists بروید و این لیست را به کمپین‌های مدنظرتان Apply کنید.
• زمان‌بندی (Schedule): پیشنهاد می‌کنم اجرای این اسکریپت را به صورت Weekly (هفتگی) تنظیم کنید تا ساختار دیتای شما در بازه ۷ روزه کاملاً منطقی بررسی شود.

نکات مهم برای شخصی‌سازی و اجرا:

• تنظیم حد آستانه (CLICK_THRESHOLD): عدد 10 یک استاندارد اولیه است. اگر بودجه شما محدود است یا نرخ تبدیل بالایی دارید، می‌توانید آن را روی ۵ یا ۷ بگذارید. اگر محصول گرانی می‌فروشید، شاید بهتر باشد روی ۱۵ یا ۲۰ تنظیم شود.

• نوع انطباق (Match Type): در کد بالا، کلمات به صورت Exact Match (با علامت [ ]) اضافه می‌شوند تا دقیقاً همان عبارت مسدود شود. اگر می‌خواهید کل عبارت و کلمات پیرامونش مسدود شوند، می‌توانید آن را به Phrase Match (با علامت " ") تغییر دهید.

• اتصال لیست به کمپین‌ها: این اسکریپت کلمات را به یک لیست اشتراکی (Shared List) به نام Automated_Negative_Keywords اضافه می‌کند. فراموش نکنید که پس از اولین اجرای اسکریپت، به بخش Tools > Negative keyword lists بروید و این لیست را به کمپین‌های مدنظرتان Apply کنید.

• زمان‌بندی (Schedule): پیشنهاد می‌کنم اجرای این اسکریپت را به صورت Weekly (هفتگی) تنظیم کنید تا ساختار دیتای شما در بازه ۷ روزه کاملاً منطقی بررسی شود.

۴. اسکریپت هشدار تغییرات ناگهانی (Anomaly Detection)

اگر ناگهان هزینه کمپین‌تان ۲ برابر شود یا کلیک‌ها به صفر برسد، این اسکریپت فوراً ایمیل هشدار می‌فرستد. مثل یک سیستم آلارم برای اکانت گوگل ادز شما.

function main() {{
  // --- تنظیمات اسکریپت ---
  var EMAIL_ADDRESS = "your-email@example.com"; // ایمیل خود را اینجا وارد کنید
  var COST_THRESHOLD_MULTIPLIER = 2.0;         // ضریب حساسیت هزینه (مثلاً ۲ برابر شدن)
  var IMPRESSION_DROP_THRESHOLD = 0.1;        // افت نمایش به کمتر از ۱۰ درصد میانگین
  // ----------------------

  var campaigns = AdsApp.campaigns().withCondition("Status = ENABLED").get();
  var anomaliesFound = [];

  while (campaigns.hasNext()) {{
    var campaign = campaigns.next();
    var campaignName = campaign.getName();
    
    // دریافت دیتای امروز تا این لحظه
    var statsToday = campaign.getStatsFor("TODAY");
    var costToday = statsToday.getCost();
    var impsToday = statsToday.getImpressions();
    
    // دریافت دیتای میانگین ۷ روز گذشته برای همین روز از هفته
    var statsPast = campaign.getStatsFor("LAST_7_DAYS");
    var avgCost7Days = statsPast.getCost() / 7;
    var avgImps7Days = statsPast.getImpressions() / 7;
    
    // ۱. بررسی جهش ناگهانی هزینه
    if (avgCost7Days > 0 && costToday > (avgCost7Days * COST_THRESHOLD_MULTIPLIER)) {{
      anomaliesFound.push("🔴 کمپین [" + campaignName + "]: هزینه امروز تا این لحظه (" + costToday + ") بیش از " + COST_THRESHOLD_MULTIPLIER + " برابر میانگین روزهای قبل (" + avgCost7Days.toFixed(2) + ") شده است!");
    }}
    
    // ۲. بررسی افت شدید یا صفر شدن نمایش (Impressions)
    if (avgImps7Days > 50 && impsToday < (avgImps7Days * IMPRESSION_DROP_THRESHOLD)) {{
      anomaliesFound.push("⚪ کمپین [" + campaignName + "]: تعداد نمایش امروز (" + impsToday + ") به شدت افت کرده یا به صفر نزدیک شده است! (میانگین روزانه: " + avgImps7Days.toFixed(0) + ")");
    }}
  }}

  // ارسال ایمیل در صورت وجود خطا یا آنومالی
  if (anomaliesFound.length > 0) {{
    var emailBody = "هشدار خودکار گوگل ادز:\\n\\nتغییرات ناگهانی و مشکوکی در اکانت شما شناسایی شده است:\\n\\n" + anomaliesFound.join("\\n\\n") + "\\n\\nلطفاً هرچه سریع‌تر اکانت خود را بررسی کنید.";
    MailApp.sendEmail(EMAIL_ADDRESS, "⚠️ هشدار فوری گوگل ادز: شناسایی آنومالی و تغییرات ناگهانی", emailBody);
    Logger.log("ایمیل هشدار ارسال شد.");
  }} else {{
    Logger.log("وضعیت اکانت کاملاً نرمال است.");
  }}
}}

۵. اسکریپت Quality Score Tracker

Quality Score (نمره کیفیت) تأثیر مستقیم روی هزینه هر کلیک دارد. این اسکریپت تغییرات نمره کیفیت کلمات کلیدی‌تان را ردیابی و گزارش می‌دهد تا بتوانید روند بهبود یا افت را زیر نظر بگیرید.

function main() {
  // --- تنظیمات اسکریپت ---
  var LOW_QS_THRESHOLD = 5; // کلمات کلیدی با نمره کیفیت کمتر از این عدد گزارش می‌شوند
  // ----------------------

  Logger.log("شروع بررسی نمره کیفیت کلمات کلیدی...");

  // دریافت کلمات کلیدی فعال در کمپین‌های فعال
  var keywords = AdsApp.keywords()
    .withCondition("Status = ENABLED")
    .withCondition("CampaignStatus = ENABLED")
    .withCondition("AdGroupStatus = ENABLED")
    .get();

  var lowQualityKeywordsCount = 0;

  while (keywords.hasNext()) {
    var keyword = keywords.next();
    var keywordText = keyword.getText();
    var qualityInfo = keyword.getQualityInfo();
    
    // اگر کلمه کلیدی دیتای کافی برای محاسبه نمره کیفیت داشته باشد
    if (qualityInfo !== null) {
      var qualityScore = qualityInfo.getQualityScore();
      var expectedCtr = qualityInfo.getSearchPredictedCtr();
      var adRelevance = qualityInfo.getCreativeQualityScore();
      var landingPageExp = qualityInfo.getPostClickQualityScore();

      // لاگ کردن وضعیت کلماتی که نمره کیفیت پایینی دارند برای بهینه‌سازی سریع
      if (qualityScore <= LOW_QS_THRESHOLD) { Logger.log("⚠️ کیفیت پایین | کلمه: " + keywordText + " | نمره: " + qualityScore + "/10"); Logger.log(" -> Expected CTR: " + expectedCtr);
        Logger.log("   -> Ad Relevance: " + adRelevance);
        Logger.log("   -> Landing Page Exp: " + landingPageExp);
        Logger.log("-----------------------------------------");
        lowQualityKeywordsCount++;
      }
    }
  }

  Logger.log("بررسی به پایان رسید. تعداد " + lowQualityKeywordsCount + " کلمه کلیدی با نمره کیفیت ضعیف (کمتر یا مساوی " + LOW_QS_THRESHOLD + ") پیدا شد.");
}

منظور از ادگروپ کاملاً اگزکت در اسکریپت گوگل ادز چیست؟

یکی از مفاهیمی که هنگام کار با اسکریپت‌های Google Ads با آن مواجه می‌شوید، مفهوم Ad Group (ادگروپ) و نوع تطبیق کلمات کلیدی است. وقتی صحبت از «ادگروپ کاملاً اگزکت» می‌شود، منظور این است:

• تمام کلمات کلیدی داخل آن ادگروپ از نوع Exact Match (تطبیق دقیق) هستند
• تبلیغ شما فقط زمانی نمایش داده می‌شود که کاربر دقیقاً همان عبارتی را سرچ کند که شما تعیین کرده‌اید
• این روش کنترل بیشتری روی بودجه و هدف‌گیری مخاطب می‌دهد

اسکریپت‌های گوگل ادز می‌توانند ادگروپ‌ها را بر اساس نوع تطبیق فیلتر کنند و فقط عملکرد ادگروپ‌های Exact Match را گزارش دهند. این به شما کمک می‌کند بفهمید آیا استراتژی Exact Match واقعاً بهتر از Broad Match عمل می‌کند یا نه.

نکات طلایی استفاده از اسکریپت‌های گوگل ادز

بر اساس تجربه ما در وبینیو و مدیریت ده‌ها کمپین تبلیغاتی، این نکات را حتماً رعایت کنید:

1. اول Preview، بعد Run: همیشه قبل از اجرای واقعی، اسکریپت را در حالت Preview تست کنید
2. با اسکریپت‌های گزارشی شروع کنید: قبل از استفاده از اسکریپت‌هایی که تغییرات خودکار اعمال می‌کنند، از اسکریپت‌های فقط‌گزارشی شروع کنید تا با ساز و کار آشنا شوید
3. ایمیل خود را حتماً تنظیم کنید: بیشتر اسکریپت‌ها قابلیت ارسال گزارش به ایمیل دارند. آدرس ایمیل‌تان را در تنظیمات اسکریپت وارد کنید
4. محدودیت زمانی اجرا: اسکریپت‌های Google Ads حداکثر ۳۰ دقیقه می‌توانند اجرا شوند. اگر اکانت خیلی بزرگ است، بازه زمانی تحلیل را محدودتر کنید
5. اسکریپت‌ها را به‌روز نگه دارید: گوگل گاهی API خود را تغییر می‌دهد. مطمئن شوید اسکریپت‌هایتان با آخرین نسخه سازگار هستند

چگونه اسکریپت‌های بیشتر برای گوگل ادز دریافت کنیم؟

خبر خوب این است که برای دسترسی به اسکریپت‌های Google Ads گزینه‌های متعددی دارید:

• هوش مصنوعی (AI): از ابزارهایی مثل ChatGPT یا Claude بخواهید اسکریپت سفارشی برای نیاز خاص شما بنویسند. کافی است توضیح دهید چه گزارشی یا چه تغییری می‌خواهید
• مستندات رسمی گوگل: صفحه رسمی Google Ads Scripts اسکریپت‌های نمونه و مستندات کامل API را ارائه می‌دهد
• جامعه توسعه‌دهندگان: سایت‌هایی مثل GitHub و انجمن‌های Google Ads اسکریپت‌های آماده فراوانی دارند
• آژانس تخصصی: اگر می‌خواهید اسکریپت دقیقاً مطابق نیاز کسب‌وکار شما باشد، به یک آژانس متخصص مثل وبینیو سفارش دهید

ما در وبینیو علاوه بر خدمات طراحی سایت در مشهد و خدمات سئو در مشهد، خدمات مدیریت و بهینه‌سازی کمپین‌های گوگل ادز را هم ارائه می‌دهیم و اسکریپت‌های سفارشی را بر اساس نیاز هر پروژه طراحی و پیاده‌سازی می‌کنیم.

اشتباهات رایج در استفاده از اسکریپت‌های گوگل ادز

بعد از کار با پروژه‌های متعدد، ما با اشتباهات تکراری زیادی مواجه شده‌ایم. بیایید مهم‌ترین‌ها را مرور کنیم تا شما تکرارشان نکنید:

• عدم تست قبل از اجرا: بسیاری از افراد اسکریپت را بدون Preview اجرا می‌کنند و بعد تعجب می‌کنند چرا کمپین‌شان به هم ریخته
• فراموش کردن Authorization: اگر مجوز دسترسی اسکریپت منقضی شود، اسکریپت بدون اطلاع شما متوقف می‌شود
• استفاده از اسکریپت‌های قدیمی: گوگل اخیراً از AdWords API قدیمی به Google Ads API جدید مهاجرت کرده. اسکریپت‌های قدیمی ممکن است کار نکنند
• تعیین بازه زمانی نامناسب: تحلیل فقط یک روز داده قابل اتکا نیست. حداقل ۱۴ تا ۳۰ روز داده جمع‌آوری کنید
• نادیده گرفتن خروجی اسکریپت: بعضی‌ها اسکریپت را نصب می‌کنند ولی هرگز گزارش‌ها را نمی‌خوانند!

سوالات متداول درباره اسکریپت گوگل ادز

جمع‌بندی: اسکریپت گوگل ادز، سلاح مخفی تبلیغات حرفه‌ای

اسکریپت گوگل ادز یکی از قدرتمندترین ابزارهایی است که بسیاری از تبلیغ‌دهندگان هنوز از آن استفاده نمی‌کنند. همان‌طور که دیدید، ما در آژانس وبینیو با یک اسکریپت ساده گزارش‌دهی توانستیم هزینه هر کلیک پروژه دامون کارز را از ۲۰ درهم به ۱۱ درهم کاهش دهیم. این یعنی ۴۵ درصد صرفه‌جویی در بودجه تبلیغاتی — بدون هیچ کاهشی در کیفیت لیدها.

مهم‌ترین نکاتی که از این مقاله باید به خاطر بسپارید:

• اسکریپت‌ها رایگان هستند و نیازی به دانش برنامه‌نویسی ندارند
• با اسکریپت‌های گزارشی شروع کنید تا گلوگاه‌های بودجه را شناسایی کنید
• همیشه اسکریپت را قبل از اجرای واقعی تست (Preview) کنید
• از هوش مصنوعی یا آژانس تخصصی برای ساخت اسکریپت‌های سفارشی کمک بگیرید
• اسکریپت‌ها جایگزین تخصص انسانی نیستند — ابزاری هستند که تخصص شما را تقویت می‌کنند