Группа объявлений (AdGroup)

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

Сервис

Для управления группами предназначен сервис AdGroups.

Методы

add | update | delete | get

Для работы с группой в Единой перфоманс-кампании используется адрес https://api.direct.yandex.com/v501/.

Ограничения

Тип группы должен соответствовать типу кампании.

Никакие операции с группами в архивной кампании невозможны.

Ограничение на количество групп объявлений в кампании можно получить с помощью метода Clients.get или AgencyClients.get (элемент ADGROUPS_TOTAL_PER_CAMPAIGN массива Restrictions).

Тип группы

Тип группы задается при создании и недоступен для изменения.

Набор параметров группы зависит от ее типа.

Общими параметрами для всех типов групп являются название, регионы показа и единые минус-фразы на группу, а также метки. При создании или редактировании группы эти параметры необходимо передать в структуре AdGroups методов add, update. Чтобы получить эти параметры, необходимо перечислить имена параметров во входном параметре FieldNames метода get.

Параметры, зависящие от типа группы, передаются в дочерней структуре с соответствующим именем.

API Директа поддерживает следующие типы групп:

• UNIFIED_AD_GROUP — единая перфоманс-группа.

  В группу можно добавлять объявления с типом TextAd, TextImageAd, TextAdBuilderAd, ShoppingAd, ResponsiveAd. При этом для TextAd в единой перфоманс-группе нельзя указать следующие поля:

  • TurboPageId;
  • VCardId;
  • Mobile="YES";
  • PreferVCardOverBusiness="YES".

  Для TextImageAd и TextAdBuilderAd в единой перфоманс-группе нельзя указать поле TurboPageId.

  Группа создается с отключенным в РСЯ автотаргетингом.

• CPM_BANNER_AD_GROUP — группа медийных баннеров.

  Группа имеет только параметры, общие для всех типов групп.

  Существуют два подтипа групп медийных баннеров:

  • KEYWORDS — группа может содержать дочерние объекты: объявления и ключевые фразы. Для группы можно задать корректировки ставок.
    Чтобы создать такую группу, необходимо передать в методе add пустую структуру CpmBannerKeywordsAdGroup.

  • USER_PROFILE — группа может содержать дочерние объекты: объявления и условие нацеливания на аудиторию по профилю пользователей. В такой группе не допускаются минус-фразы.
    Чтобы создать группу, необходимо передать в методе add пустую структуру CpmBannerUserProfileAdGroup.

• CPM_VIDEO_AD_GROUP — группа медийных видеообъявлений (в кампании с типом «Медийная кампания»).

  Группа имеет только параметры, общие для всех типов групп. В группе не допускаются минус-фразы.

  Внимание

  Настройка Сбор аудитории видео в настоящее время не поддерживается в API.

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

• TEXT_AD_GROUP — группа текстово-графических объявлений.

  Тип группы устарел и поддерживается только для обратной совместимости.

  Для группы этого типа дополнительно можно указать идентификатор фида и идентификаторы категорий товаров, на основе которых требуется сгенерировать текстово-графические объявления.

  Группа может иметь дочерние объекты — объявления, ключевые фразы, автотаргетинги, условия нацеливания на аудиторию. Для группы можно задать корректировки ставок.

Устаревшие типы групп

Типы групп устарели и больше не поддерживаются.

• SMART_AD_GROUP — группа смарт-баннеров.

• MOBILE_APP_AD_GROUP — группа для продвижения мобильных приложений.

• DYNAMIC_TEXT_AD_GROUP — группа динамических объявлений.

Статус группы

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

Статус	Описание
DRAFT	Группа создана и еще не отправлена на модерацию.
MODERATION	Группа находится на модерации.
PREACCEPTED	Группа допущена к показам автоматически, но будет дополнительно проверена модератором.
ACCEPTED	Хотя бы одна фраза группы принята модерацией (некоторые могли быть отклонены).
REJECTED	Все фразы отклонены.

Статус возможности показов группы

Параметр ServingStatus отражает возможность показов по содержащимся в группе условиям показа.

Для пользователя

Количественные ограничения на объекты пользователя.

Для агентства

—