---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.ru/dev/direct/doc/en/objects/adgroup.md
  - https://yandex.ru/dev/direct/doc/ru/objects/adgroup.md
sourcePath: ru/dg/objects/adgroup.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt

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

Группа объявлений представляет собой набор объявлений и единые для этих объявлений условия показа. С помощью групп можно протестировать различные варианты объявления и автоматически определить, какой из них окажется наиболее привлекательным для аудитории. Подробнее в разделе [Эксперименты с объявлениями](https://yandex.ru/support/direct/efficiency/ad-groups.html) Справки Директа.


## Сервис {#service}

Для управления группами предназначен сервис [AdGroups](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/adgroups.html).


### Методы {#methods}

[add](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/add.html) | [update](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/update.html) | [delete](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/delete.html) | [get](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/get.html) 

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


## Ограничения {#restrictions}

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

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

Ограничение на количество групп объявлений в кампании можно получить с помощью метода [Clients](https://yandex.ru/dev/direct/doc/ref-v5/clients/clients.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/clients/get.html) или [AgencyClients](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/agencyclients.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/get.html) (элемент ADGROUPS_TOTAL_PER_CAMPAIGN массива [Restrictions](*Restrictions)).


## Тип группы {#types}

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

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

Общими параметрами для всех типов групп являются название, регионы показа и единые минус-фразы на группу, а также метки. При создании или редактировании группы эти параметры необходимо передать в структуре `AdGroups` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/update.html). Чтобы получить эти параметры, необходимо перечислить имена параметров во входном параметре `FieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

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

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

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

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

    Группа может иметь дочерние объекты — [объявления](https://yandex.ru/dev/direct/doc/ru/objects/ad.md), [ключевые фразы](https://yandex.ru/dev/direct/doc/ru/objects/keyword.md), [автотаргетинги](https://yandex.ru/dev/direct/doc/ru/best-practice/auto-targeting.md), [условия нацеливания на аудиторию](https://yandex.ru/dev/direct/doc/ru/objects/audience-target.md). Для группы можно задать [корректировки ставок](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.md).

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

    Для группы этого типа необходимо указать идентификатор фида, на основе которого требуется сгенерировать смарт-баннеры. Опционально можно указать названия элементов фида, из которых нужно брать заголовок и текст объявления. Подробнее о смарт-баннерах см. в разделе [Смарт-баннеры](https://yandex.ru/support/direct/smart-banners/about.html) Справки Директа.

    Чтобы создать или отредактировать группу, специфичные параметры для данного типа группы необходимо передать в структуре `SmartAdGroup` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/update.html).

    При получении параметров группы необходимо перечислить имена параметров, общих для всех типов групп, во входном параметре `FieldNames`, а имена специфичных параметров — во входном параметре `SmartAdGroupFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/get.html).

    Группа может иметь дочерние объекты — [объявления](https://yandex.ru/dev/direct/doc/ru/objects/ad.md). Для группы можно задать [корректировки ставок](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.md).

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

    Для группы этого типа необходимо дополнительно указать ссылку на приложение в магазине приложений AppStore или Google Play, а также типы устройств, типы подключения к интернету и минимальную версию операционной системы, на которых может быть показано объявление. Подробнее о продвижении мобильных приложений см. в разделе [Продвижение приложений](https://yandex.ru/support/direct/ru/products-mobile-apps-ads/about) Справки Директа.

    {% note alert %}

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

    {% endnote %}

    Чтобы создать или отредактировать группу, специфичные параметры для данного типа группы необходимо передать в структуре `MobileAppAdGroup` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/update.html).

    При получении параметров группы необходимо перечислить имена параметров, общих для всех типов групп, во входном параметре `FieldNames`, а имена специфичных параметров — во входном параметре `MobileAppAdGroupFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/get.html).

    Группа может иметь дочерние объекты — [объявления](https://yandex.ru/dev/direct/doc/ru/objects/ad.md), [ключевые фразы](https://yandex.ru/dev/direct/doc/ru/objects/keyword.md), [автотаргетинги](https://yandex.ru/dev/direct/doc/ru/best-practice/auto-targeting.md), [условия нацеливания на аудиторию](https://yandex.ru/dev/direct/doc/ru/objects/audience-target.md). Для группы можно задать [корректировки ставок](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.md).

- DYNAMIC_TEXT_AD_GROUP — группа динамических объявлений. Подробнее о динамических объявлениях см. в разделе [Динамические объявления](https://yandex.ru/support/direct/dynamic-text-ads/about-da.html) Справки Директа.

    Существуют два подтипа групп динамических объявлений:

    - WEBPAGE — источником данных для генерации объявлений являются страницы сайта.

      Для группы этого подтипа необходимо дополнительно указать продвигаемый домен.

      Чтобы создать или отредактировать группу, специфичные параметры для данного типа группы необходимо передать в структуре `DynamicTextAdGroup` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/update.html).

      При получении параметров группы необходимо перечислить имена параметров, общих для всех типов групп, во входном параметре `FieldNames`, а имена специфичных параметров — во входном параметре `DynamicTextAdGroupFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/get.html).

      Группа может иметь дочерние объекты — [объявления](https://yandex.ru/dev/direct/doc/ru/objects/ad.md). Для группы можно задать [корректировки ставок](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.md).

    - FEED — источником данных для генерации объявлений является фид — файл с товарными предложениями.

      При получении параметров группы необходимо перечислить имена параметров, общих для всех типов групп, во входном параметре `FieldNames`, а имена специфичных параметров — во входном параметре `DynamicTextFeedAdGroupFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/get.html).

      Группа может иметь дочерние объекты — [объявления](https://yandex.ru/dev/direct/doc/ru/objects/ad.md) и фильтры для отбора товарных предложений из фида. Управление фильтрами доступно только в веб-интерфейсе. Для группы можно задать [корректировки ставок](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.md).

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

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

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

    - KEYWORDS — группа может содержать дочерние объекты: [объявления](https://yandex.ru/dev/direct/doc/ru/objects/ad.md) и [ключевые фразы](https://yandex.ru/dev/direct/doc/ru/objects/keyword.md). Для группы можно задать [корректировки ставок](https://yandex.ru/dev/direct/doc/ru/objects/bidmodifier.md).
      Чтобы создать такую группу, необходимо передать в методе [add](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/add.html) пустую структуру `CpmBannerKeywordsAdGroup`.

    - USER_PROFILE — группа может содержать дочерние объекты: [объявления](https://yandex.ru/dev/direct/doc/ru/objects/ad.md) и [условие нацеливания на аудиторию](https://yandex.ru/dev/direct/doc/ru/objects/audience-target.md) по профилю пользователей. В такой группе не допускаются минус-фразы.
      Чтобы создать группу, необходимо передать в методе [add](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/add.html) пустую структуру `CpmBannerUserProfileAdGroup`.

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

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

    {% note alert %}

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

    {% endnote %}

    Группа может содержать дочерние объекты: [объявления](https://yandex.ru/dev/direct/doc/ru/objects/ad.md) и [условие нацеливания на аудиторию](https://yandex.ru/dev/direct/doc/ru/objects/audience-target.md) по профилю пользователей.

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

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

    - `TurboPageId`;
    - `VCardId`;
    - `Mobile="YES"`;
    - `PreferVCardOverBusiness="YES"`.

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

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


## Статус группы {#status}

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

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


## Статус возможности показов группы {#serving-status}

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


#|
|| **Статус показов** | **Описание** ||
|| ELIGIBLE | Показы возможны. ||
|| RARELY_SERVED | «Мало показов» — при текущих настройках показы происходят крайне редко. Например, ключевые фразы не встречаются в поисковых запросах пользователей.  ||
|#

[*Restrictions]: **Для пользователя**

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

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

—