Ярлыки

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

В этом руководстве рассматриваются следующие темы:

  • Создание ярлыков.
  • Присвоение ярлыков кампаниям.
  • Получение и фильтрация результатов отчетов по ярлыкам с помощью методов get() и query() службы CampaignService.

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

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

Вот некоторые ситуации, когда вам могут понадобиться ярлыки:

  • У вас есть кампании, которые вы активируете только в определенное время года, и вы хотели бы иметь возможность с легкостью включать эти кампании в отчеты (или исключать их оттуда).
  • Вы добавили новый набор ключевых слов и хотите сравнить данные по их эффективности со статистикой по другим ключевым словам в этой группе объявлений.
  • Вам нужен простой способ определить набор кампаний, которым управляет каждый пользователь вашего аккаунта AdWords.
  • Вам нужно, чтобы приложение помечало статус определенных объектов: обработано, проверено, выделено и т. д.

Подробнее о том, как работают ярлыки в AdWords...

Создание ярлыков

Ярлыки создаются с помощью объекта TextLabel. Вот как настроить TextLabel:

  1. Создайте объект TextLabel.
  2. Присвойте ему название.
  3. Включите TextLabel в операцию LabelOperation и отправьте ее службе LabelService.mutate().

Для следующего шага вам понадобятся идентификаторы созданных ярлыков, поэтому не забудьте получить их из ответа на вызов mutate. Можно также использовать LabelService.get() или LabelService.query().

Присвоение ярлыков кампаниям, группам объявлений, критериям и объявлениям

Для присвоения ярлыков используйте операцию mutateLabels. Например, чтобы назначить ярлык кампании, используйте CampaignService.mutateLabels с одним или несколькими объектами CampaignLabel. Каждый такой объект состоит из следующих элементов:

  • labelId – The ID of a label
  • campaignId – идентификатор кампании.

Создайте объект CampaignLabel для каждой пары ярлык/кампания, включите его в операцию CampaignLabelOperation с оператором ADD и передайте службе CampaignService.mutateLabels.

Получение объектов с помощью ярлыков

Итак, вы присвоили кампаниям ярлыки. Теперь можно использовать поле Labels для извлечения объектов с определенным ярлыком или ярлыками. Вот пример запроса CampaignService.query на AWQL, в результате которого будут выбраны идентификатор, название и ярлыки каждой кампании, связанной с одним из трех идентификаторов ярлыков:

SELECT Id, Name, Labels
WHERE Labels CONTAINS_ANY [123456, 789012, 345678]

Несколько моментов, о которых следует помнить при настройке фильтров с ярлыками:

  1. Фильтрация должна выполняться по идентификатору, а не по названию ярлыка.
  2. Поддерживаются только следующие операторы: CONTAINS_ALL, CONTAINS_ANY и CONTAINS_NONE.

Использование полей ярлыков в отчетах

Во всех этих отчетах есть поля Labels и LabelIds:

Как и в случае с другими полями типа List, вы можете фильтровать результаты по LabelIds, используя операторы CONTAINS_ANY, CONTAINS_ALL и CONTAINS_NONE.

Служба отчетности возвращает в полях Labels и LabelIds список названий и идентификаторов ярлыков. В качестве разделителя используется точка с запятой. Пример:

CAMPAIGN_PERFORMANCE_REPORT (Jul 1, 2014-Jul 7, 2014)
Campaign ID,Labels,Label IDs
1999999,Label 1; Label 2,456; 678
2999999,Label 2;678
Total, --, --

Примеры кода

В папке Campaign Management (Управление кампаниями) своей клиентской библиотеки вы найдете примеры кода, показывающие, как добавлять ярлыки к кампаниям и получать кампании с помощью ярлыков.

Оставить отзыв о...

Текущей странице
Нужна помощь? Обратитесь в службу поддержки.