Этикетки

Ярлыки позволяют вам организовывать элементы в вашей учетной записи в содержательные группы, чтобы вы могли быстро фильтровать и составлять отчеты по наиболее интересным для вас данным. Скрипты 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 .