برچسب‌ها

برچسب‌ها به شما امکان می‌دهند عناصر را در حسابتان در گروه‌های معنی‌دار سازمان‌دهی کنید تا بتوانید به‌سرعت داده‌هایی را که برایتان جالب‌تر است فیلتر و گزارش کنید. جاوااسکریپت‌های 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 استفاده کنید.