Этикетки

Метки позволяют организовать элементы в вашем аккаунте в осмысленные группы, чтобы вы могли быстро фильтровать и создавать отчёты по наиболее интересным для вас данным. Скрипты Google Рекламы поддерживают метки на уровне аккаунта , кампании , группы объявлений , объявления и ключевых слов .

Варианты использования

В аккаунтах Google Рекламы метки можно использовать для связывания произвольных данных с сущностями Google Рекламы. В управляющих аккаунтах метки можно использовать для группировки схожих дочерних аккаунтов. Метки полезны в ряде случаев:

• Обработать список счетов
  • Если вы представляете агентство, вы можете применить метку plumber_accounts ко всем аккаунтам сантехников, а затем скрипт может добавить ключевые слова, связанные с сантехниками (например, «аварийный ремонт душа»), во все кампании в этих аккаунтах.
• Обработать список сущностей
  • Если у вас есть набор ключевых слов, которые вы хотите включить только в выходные дни, вы можете добавить к ним метку weekend_keywords . Скрипт может включить все ключевые слова с weekend_keywords вечером в пятницу и приостановить их в понедельник утром.
• Процесс обработки объектов в нескольких запусках
  • Если у вас много сущностей, которые невозможно обработать менее чем за 30 минут, вы можете создать в скрипте метку processed и применить её к уже обработанным сущностям. Запланируйте запуск скрипта каждый час, а затем обрабатывайте только те сущности, к которым не применена метка processed .
• Двухэтапные изменения
  • Вместо того, чтобы скрипт выполнял изменение ставок по большому количеству ключевых слов, вы можете пометить ключевые слова как increase_bid_by_10% , войти в пользовательский интерфейс Google Ads, отфильтровать ключевые слова, соответствующие метке, просмотреть их и, если результат вас устраивает, изменить их ставки с помощью массового редактирования .
• Гибкие торги
  • Скрипт может использовать метки для ведения истории изменений ставок. Например, когда скрипт увеличивает ставку по ключевому слову на 20%, он может пометить аккаунт меткой increased_20% . На следующий день, когда скрипт столкнётся с меткой и обнаружит, что он уже увеличил ставку ранее, он может увеличить её всего на 10%.
• Отслеживание показателя качества
  • Скрипт может маркировать важные ключевые слова с помощью их показателей качества, а затем периодически проверять и сообщать о ключевых словах, показатель качества которых больше не соответствует метке.

Метки на уровне аккаунта

Скрипты 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();

Дополнительную информацию об обработке нескольких учетных записей за одно выполнение скрипта см. в нашем руководстве по скриптам менеджерских счетов.

Метки внутри аккаунта

Вы можете создавать и применять ярлыки к кампаниям , группам объявлений , объявлениям и ключевым словам аккаунта. Вот как применить ярлык к кампании:

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 Рекламы. Названия ресурсов — это концепция API Google Рекламы, которая иногда используется при создании отчётов с помощью 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 .