Ярлыки

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

Примеры использования

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

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

Ярлыки на уровне аккаунта

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

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 Рекламы. Названия ресурсов – это концепция 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.