برچسب‌ها

برچسب‌ها به شما امکان می‌دهند عناصر حسابتان را در گروه‌های معنی‌دار سازمان‌دهی کنید تا بتوانید به‌سرعت داده‌هایی را که برایتان جالب‌تر است فیلتر و گزارش کنید. جاوااسکریپت Google Ads از برچسب‌ها در سطح حساب، کمپین، گروه آگهی، آگهی، و کلیدواژه پشتیبانی می‌کند.

موارد استفاده

در حساب‌های Google Ads، می‌توان از برچسب‌ها برای مرتبط کردن داده‌های دلخواه با نهادهای Google Ads استفاده کرد. در حساب‌های مدیر، می‌توان از برچسب‌ها برای گروه‌بندی حساب‌های فرعی مشابه استفاده کرد. برچسب‌ها به تعدادی از موارد استفاده کمک می‌کنند:

• پردازش فهرست حساب‌ها
  • اگر شما یک آژانس هستید، می‌توانید برچسب plumber_accounts را به همه حساب‌های لوله‌کش‌ها اعمال کنید، و سپس یک اسکریپت می‌تواند کلیدواژه‌های مرتبط با لوله‌کشی (برای مثال، «تعمیر اضطراری دوش») را به همه پویش‌های آن حساب‌ها ارسال کند.
• پردازش فهرست نهادها
  • اگر مجموعه‌ای از کلیدواژه‌ها دارید که می‌خواهید فقط درطول آخر هفته‌ها فعال باشند، می‌توانید برچسب weekend_keywords را برای آن‌ها اعمال کنید. سپس یک اسکریپت می‌تواند همه کلیدواژه‌ها را با weekend_keywords در عصر جمعه فعال کند و آن‌ها را در صبح دوشنبه موقتاً متوقف کند.
• پردازش نهادها در چندین اجرا
  • اگر تعداد زیادی نهاد دارید که نمی‌توانند در کمتر از ۳۰ دقیقه پردازش شوند، می‌توانید برچسب processed در دستوراتتان ایجاد کنید و آن را برای نهادهایی که قبلاً پردازش شده‌اند اعمال کنید. زمان‌بندی کنید که اسکریپت هر ساعت اجرا شود و سپس فقط نهادهایی را پردازش کنید که برچسب processed روی آن‌ها اعمال نشده است.
• تغییرات دومرحله‌ای
  • به‌جای اینکه اسکریپت تغییر قیمت پیشنهادی را در تعداد زیادی کلیدواژه اجرا کند، می‌توانید کلیدواژه‌ها را با increase_bid_by_10% برچسب‌گذاری کنید، به واسط کاربری Google Ads وارد شوید، کلیدواژه‌های منطبق با برچسب را فیلتر کنید، آن‌ها را مرور کنید، و اگر از نتیجه راضی بودید، قیمت‌های پیشنهادی آن‌ها را بااستفاده از ویرایش‌های انبوه تغییر دهید.
• پیشنهاد قیمت انعطاف‌پذیر
  • یک اسکریپت می‌تواند از برچسب‌ها برای حفظ سابقه تغییرات پیشنهاد قیمت استفاده کند. برای مثال، وقتی دستورگانی قیمت پیشنهادی کلیدواژه را ۲۰٪ افزایش می‌دهد، می‌تواند حساب را با برچسب increased_20% علامت‌گذاری کند. روز بعد وقتی دستورات به برچسب می‌رسد و متوجه می‌شود که قبلاً پیشنهاد قیمت را افزایش داده است، می‌تواند پیشنهاد قیمت را فقط ۱۰٪ افزایش دهد.
• ردیابی امتیاز کیفیت
  • یک اسکریپت می‌تواند کلیدواژه‌های مهم را با امتیاز کیفیت آن‌ها برچسب‌گذاری کند، سپس به‌طور دوره‌ای کلیدواژه‌هایی را که امتیاز کیفیت آن‌ها دیگر با برچسب مطابقت ندارد بررسی و گزارش کند.

برچسب‌ها در سطح حساب

جاوااسکریپت Google Ads به شما امکان می‌دهد برچسب‌هایی را در حساب‌های مدیر ایجاد کنید و همچنین برچسب‌ها را به حساب‌های Google Ads تحت آن حساب مدیر اعمال کنید:

const labelName = 'High spending accounts';
AdsManagerApp.createAccountLabel(labelName);

می‌توانید برچسب را بااستفاده از روش applyLabel به حساب‌های موردنظرتان اعمال کنید:

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.applyLabel(labelName);
}

به‌طور مشابه، می‌توانید بااستفاده از روش removeLabel برچسبی را از حساب بردارید:

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.removeLabel(labelName);
}

رایج‌ترین کاربرد برچسب‌های حساب، پردازش گروهی از حساب‌ها است که برچسب حساب یکسانی دارند:

const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts()
    .withCondition(`LabelNames CONTAINS "${labelName}"`)
    .get();

توجه: LabelNames روشی راحت است و برای جستجوی نام منبع برچسب، به فراخوانی API اضافی در پشت صحنه نیاز دارد. اگر ازقبل شیء برچسب دارید، باید به‌جای آن از فیلتر customer_client.applied_labels CONTAINS ALL (${label.getResourceName()}) استفاده کنید. برای جزئیات بیشتر درباره نام منابع، بخش گزارش‌دهی را ببینید.

برای کسب اطلاعات بیشتر درباره پردازش چند حساب در یک اجرای اسکریپت، به راهنمای اسکریپت‌های حساب مدیر مراجعه کنید.

برچسب‌ها در حساب

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

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.applyLabel('High performing campaign');

به‌طور مشابه، می‌توانید برچسبی را بااستفاده از روش removeLabel بردارید:

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.removeLabel('High performing campaign');

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

const label = AdsApp.labels()
    .withCondition('label.name = "Christmas promotions"')
    .get().next();
var campaignIterator = label.campaigns().get();
for (const campaign of campaignIterator) {
  campaign.pause();
}

گزارش

می‌توانید از نام‌های منبع برچسب برای فیلتر کردن نهادها هنگام اجرای گزارش‌های عملکرد برای حساب‌های Google Ads استفاده کنید. نام‌های منبع مفهومی از Google Ads API هستند و گاهی‌اوقات هنگام اجرای گزارش‌ها با GAQL استفاده می‌شوند. نام منبع برچسب همیشه در این قالب است:

    customers/[customer id]/labels/[label id]

می‌توانید نام منبع برچسب را بااستفاده از روش getResourceName آن واکشی کنید.

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

const label = AdsApp.labels()
    .withCondition("label.name = 'Christmas promotions'")
    .get().next();
const query = `SELECT campaign.name, metrics.clicks, metrics.impressions, metrics.cost ` +
    `FROM campaign WHERE campaign.labels CONTAINS ANY ` +
    `["${label.getResourceName()}"] AND segments.date DURING THIS_MONTH`;
const result = AdsApp.search(query);

به‌خاطر داشته باشید که برای فیلتر کردن براساس نام منابع برچسب فقط می‌توانید از عملگرهای CONTAINS_ALL، CONTAINS_ANY، و CONTAINS_NONE استفاده کنید.