Этикетки

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

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

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

  • Обработать список учетных записей
    • Если вы представляете агентство, вы можете присвоить метку 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 Ads можно использовать имена ресурсов-меток для фильтрации сущностей. Имена ресурсов — это концепция из API Google Ads, и иногда они используются при создании отчетов с помощью 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 .