--- metadata: - name: generator content: Diplodoc Platform v5.50.2 alternate: - https://yandex.com/dev/direct/doc/dg-v4/en/concepts/groups-howto.md - https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/groups-howto.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt # Создание и редактирование групп объявлений ## Обратная совместимость {#compatibility} Ранее созданные объявления автоматически преобразуются в группы: каждая такая группа содержит одно объявление. Статистика при этом сохраняется. Для групп, состоящих из одного объявления, все методы управления объявлениями продолжают работать без изменений. ## Создание группы {#create} Вызовите метод [CreateOrUpdateBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/CreateOrUpdateBanners.md) с параметрами `AdGroupID` равным 0 (или незаданным) и `BannerID` равным 0. Параметры `Geo` и `Phrases` при создании группы являются обязательными. В результате будет создана новая группа, содержащая одно объявление. Если параметр `AdGroupName` не был указан, группе автоматически присваивается название вида “AdGroup №”. Метод [CreateOrUpdateBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/CreateOrUpdateBanners.md) возвращает идентификатор созданного объявления. Получить идентификатор группы можно с помощью метода [GetBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBanners.md), подав на вход идентификатор объявления. При этом рекомендуется указать в параметре GetPhrases значение No для снижения нагрузки на API и увеличения быстродействия. ## Добавление объявления в группу {#add} Вызовите метод [CreateOrUpdateBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/CreateOrUpdateBanners.md), указав идентификатор группы в параметре `AdGroupID`. Параметры `AdGroupName`, `Geo`, `Phrases`, `MinusKeywords` передавать не требуется. ## Получение параметров группы {#get} Метод [GetBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBanners.md) возвращает как параметры объявления, так и параметры группы. Иными словами, ключевые фразы и другие параметры группы будут продублированы в каждом объявлении. {% note alert %} Если в группе несколько объявлений, метод [GetBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBanners.md) возвращает одинаковый набор фраз для каждого из объявлений группы. Если приложение проверяет уникальность `PhraseID`, при получении фраз может возникнуть ошибка. {% endnote %} Методы [GetBannerPhrases (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBannerPhrases.md) и [GetBannerPhrasesFilter (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBannerPhrasesFilter.md), получая на вход идентификатор объявления, возвращают фразы группы, к которой относится объявление. Аналогично, метод [GetBannersTags (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBannersTags.md), получая на вход идентификатор объявления, возвращает метки группы; операция Get метода [Retargeting (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/Retargeting.md) возвращает настройки ретаргетинга для группы. ## Редактирование параметров группы {#edit} Изменение параметров группы выполняется путем редактирования любого из объявлений, входящих в группу. Если требуется изменить параметры группы (`AdGroupName`, `Geo`, `Phrases`, `MinusKeywords`), вызовите метод [CreateOrUpdateBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/CreateOrUpdateBanners.md), подав на вход `BannerID`, все параметры объявления и все параметры группы. Новые значения параметров `AdGroupName`, `Geo`, `Phrases`, `MinusKeywords` будут применены ко всей группе. Если во входном массиве метода [CreateOrUpdateBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/CreateOrUpdateBanners.md) передается несколько объявлений одной группы, то рекомендуется указывать параметры `AdGroupName`, `Geo`, `Phrases`, `MinusKeywords`, `AutoMinusWords` только в одном из них. {% note alert %} Если при вызове метода [CreateOrUpdateBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/CreateOrUpdateBanners.md) передано одно объявление группы с одним набором фраз, а при следующем вызове — другое объявление этой же группы с другим набором фраз, то первый набор фраз будет заменен вторым. Если при вызове метода [CreateOrUpdateBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/CreateOrUpdateBanners.md) передано несколько объявлений, принадлежащих к одной группе, с разными наборами фраз, то будет сохранен только один из этих наборов (а не их объединение). {% endnote %} Если требуется изменить **ставки**, вызовите метод [SetAutoPrice (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/SetAutoPrice.md) или [UpdatePrices (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/UpdatePrices.md). Новые ставки будут действовать для всех объявлений группы. При вызове метода [SetAutoPrice (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/SetAutoPrice.md) не рекомендуется указывать во входном массиве BannеrIDS несколько объявлений одной группы. Если требуется изменить **метки**, вызовите метод [UpdateBannersTags (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/UpdateBannersTags.md), подав на вход параметр `BannerID` (любого из объявлений группы) и новый массив меток. Новые метки будут применены ко всем объявлениям группы. Если требуется добавить настройки **ретаргетинга**, вызовите метод [Retargeting (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/Retargeting.md) (операция Add) и укажите в параметре `AdID` идентификатор любого из объявлений группы. Настройки ретаргетинга будут действовать для всех объявлений группы. ## Удаление группы {#delete} Группа автоматически удаляется, когда из нее удалено последнее объявление. ## Операции с объявлениями {#banners} Метод [ModerateBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/ModerateBanners.md), вызванный для одного из объявлений группы, отправляет на модерацию все объявления этой группы, находящиеся в статусе “Черновик”. Следующие методы: - [ArchiveBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/ArchiveBanners.md) - [UnArchiveBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/UnArchiveBanners.md) - [StopBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/StopBanners.md) - [ResumeBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/ResumeBanners.md) - [DeleteBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/DeleteBanners.md) — выполняются для каждого объявления в отдельности. В частности, если остановить показ объявления с помощью метода [StopBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/StopBanners.md), то остальные объявления этой группы продолжат показываться. {% note alert %} Если требуется удалить из группы все объявления и добавить новые, необходимо вначале выполнить добавление новых объявлений. В противном случае при удалении всех объявлений группа будет удалена автоматически, и при попытке добавить в нее объявления возникнет ошибка. {% endnote %} ## Проверка наличия изменений {#changes} В случае изменения параметров группы (`AdGroupName`, `Geo`, `Phrases`, `MinusKeywords`, `AutoMinusWords`) метод [GetChanges](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetChanges.md) показывает наличие изменений для каждого из объявлений группы. ## Получение статистики {#stat} {% note alert %} Методы [GetBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBanners.md), [GetBannerPhrases (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBannerPhrases.md), [GetBannerPhrasesFilter (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBannerPhrasesFilter.md), получая на вход идентификатор объявления, возвращают для каждой фразы статистику показов и кликов, суммарную по всем объявлениям группы. {% endnote %} Метод [GetBannersStat (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBannersStat.md), а также отчет, формируемый с помощью метода [CreateNewReport (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/CreateNewReport.md), возвращают статистику показов, кликов и их стоимости для каждого объявления в отдельности. Получив идентификатор группы для каждого объявления с помощью метода [GetBanners (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBanners.md), вы можете сравнивать статистику по объявлениям одной группы, подсчитывать суммарную статистику по группе и т. п. ## Узнайте больше - [Группа объявлений (AdGroup)](https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/ad-group.md)