Создание и редактирование групп объявлений

Обратная совместимость

Ранее созданные объявления автоматически преобразуются в группы: каждая такая группа содержит одно объявление. Статистика при этом сохраняется.

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

Создание группы

Вызовите метод CreateOrUpdateBanners (Live) с параметрами AdGroupID равным 0 (или незаданным) и BannerID равным 0. Параметры Geo и Phrases при создании группы являются обязательными.

В результате будет создана новая группа, содержащая одно объявление. Если параметр AdGroupName не был указан, группе автоматически присваивается название вида «AdGroup №<ID группы>».

Метод CreateOrUpdateBanners (Live) возвращает идентификатор созданного объявления. Получить идентификатор группы можно с помощью метода GetBanners (Live), подав на вход идентификатор объявления. При этом рекомендуется указать в параметре GetPhrases значение No для снижения нагрузки на API и увеличения быстродействия.

Добавление объявления в группу

Вызовите метод CreateOrUpdateBanners (Live), указав идентификатор группы в параметре AdGroupID. Параметры AdGroupName, Geo, Phrases, MinusKeywords передавать не требуется.

Получение параметров группы

Метод GetBanners (Live) возвращает как параметры объявления, так и параметры группы. Иными словами, ключевые фразы и другие параметры группы будут продублированы в каждом объявлении.

Внимание. Если в группе несколько объявлений, метод GetBanners (Live) возвращает одинаковый набор фраз для каждого из объявлений группы. Если приложение проверяет уникальность PhraseID, при получении фраз может возникнуть ошибка.

Методы GetBannerPhrases (Live) и GetBannerPhrasesFilter (Live), получая на вход идентификатор объявления, возвращают фразы группы, к которой относится объявление.

Аналогично, метод GetBannersTags (Live), получая на вход идентификатор объявления, возвращает метки группы; операция Get метода Retargeting (Live) возвращает настройки ретаргетинга для группы.

Редактирование параметров группы

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

Если требуется изменить параметры группы (AdGroupName, Geo, Phrases, MinusKeywords), вызовите метод CreateOrUpdateBanners (Live), подав на вход BannerID, все параметры объявления и все параметры группы. Новые значения параметров AdGroupName, Geo, Phrases, MinusKeywords будут применены ко всей группе.

Если во входном массиве метода CreateOrUpdateBanners (Live) передается несколько объявлений одной группы, то рекомендуется указывать параметры AdGroupName, Geo, Phrases, MinusKeywords, AutoMinusWords только в одном из них.

Внимание.

Если при вызове метода CreateOrUpdateBanners (Live) передано одно объявление группы с одним набором фраз, а при следующем вызове — другое объявление этой же группы с другим набором фраз, то первый набор фраз будет заменен вторым.

Если при вызове метода CreateOrUpdateBanners (Live) передано несколько объявлений, принадлежащих к одной группе, с разными наборами фраз, то будет сохранен только один из этих наборов (а не их объединение).

Если требуется изменить ставки, вызовите метод SetAutoPrice (Live) или UpdatePrices (Live). Новые ставки будут действовать для всех объявлений группы. При вызове метода SetAutoPrice (Live) не рекомендуется указывать во входном массиве BannеrIDS несколько объявлений одной группы.

Если требуется изменить метки, вызовите метод UpdateBannersTags (Live), подав на вход параметр BannerID (любого из объявлений группы) и новый массив меток. Новые метки будут применены ко всем объявлениям группы.

Если требуется добавить настройки ретаргетинга, вызовите метод Retargeting (Live) (операция Add) и укажите в параметре AdID идентификатор любого из объявлений группы. Настройки ретаргетинга будут действовать для всех объявлений группы.

Удаление группы

Группа автоматически удаляется, когда из нее удалено последнее объявление.

Операции с объявлениями

Метод ModerateBanners (Live), вызванный для одного из объявлений группы, отправляет на модерацию все объявления этой группы, находящиеся в статусе «Черновик».

Следующие методы:

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

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

Проверка наличия изменений

В случае изменения параметров группы (AdGroupName, Geo, Phrases, MinusKeywords, AutoMinusWords) метод GetChanges показывает наличие изменений для каждого из объявлений группы.

Получение статистики

Внимание. Методы GetBanners (Live), GetBannerPhrases (Live), GetBannerPhrasesFilter (Live), получая на вход идентификатор объявления, возвращают для каждой фразы статистику показов и кликов, суммарную по всем объявлениям группы.

Метод GetBannersStat (Live), а также отчет, формируемый с помощью метода CreateNewReport (Live), возвращают статистику показов, кликов и их стоимости для каждого объявления в отдельности. Получив идентификатор группы для каждого объявления с помощью метода GetBanners (Live), вы можете сравнивать статистику по объявлениям одной группы, подсчитывать суммарную статистику по группе и т. п.