Кампания (Campaign)

Объект Кампания (Campaign) содержит настройки кампании и суммарную статистику.

Сервис

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

Методы

add | update | delete | suspend | resume | archive | unarchive | get

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

Ограничения

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

Тип кампании

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

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

Часть параметров кампании являются общими для всех типов кампаний, а часть — зависящими от типа кампании. Параметры, зависящие от типа кампании, передаются в дочерней структуре с соответствующим именем.

Существуют следующие типы кампаний:

• UNIFIED_CAMPAIGN — единая перфоманс-кампания.

  Чтобы создать или отредактировать кампанию данного типа, необходимо передать параметры кампании в структуре UnifiedCampaign методов add, update. Описание параметров приведено в разделах add: параметры UnifiedCampaign, update: параметры UnifiedCampaign.

  При получении параметров кампании необходимо перечислить имена параметров, общих для всех типов кампаний, во входном параметре FieldNames, а имена параметров, специфичных для данного типа кампании, — во входном параметре UnifiedCampaignFieldNames метода get. Описание возвращаемых параметров для данного типа кампании приведено в разделе get: параметры UnifiedCampaign.

• TEXT_CAMPAIGN — кампания с типом «Текстово-графические объявления».

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

  Чтобы создать или отредактировать кампанию данного типа, необходимо передать параметры кампании в структуре TextCampaign методов add, update. Описание параметров приведено в разделах add: параметры TextCampaign, update: параметры TextCampaign.

  При получении параметров кампании необходимо перечислить имена параметров, общих для всех типов кампаний, во входном параметре FieldNames, а имена параметров, специфичных для данного типа кампании, — во входном параметре TextCampaignFieldNames метода get. Описание возвращаемых параметров для данного типа кампании приведено в разделе get: параметры TextCampaign.

• CPM_BANNER_CAMPAIGN — кампания с типом «Медийная кампания». Подробнее о медийных кампаниях см. в разделе Медийные баннеры Справки Директа.

  Чтобы создать или отредактировать кампанию данного типа, необходимо передать параметры кампании в структуре CpmBannerCampaign методов add, update. Описание параметров приведено в разделах add: параметры CpmBannerCampaign, update: параметры CpmBannerCampaign.

  При получении параметров кампании необходимо перечислить имена параметров, общих для всех типов кампаний, во входном параметре FieldNames, а имена параметров, специфичных для данного типа кампании, — во входном параметре CpmBannerCampaignFieldNames метода get. Описание возвращаемых параметров для данного типа кампании приведено в разделе get: параметры CpmBannerCampaign.

• MCBANNER_CAMPAIGN — кампания с типом «Баннер на поиске». Подробнее о баннере на поиске см. в разделе Баннер на поиске Справки Директа.

  В API Яндекс Директа для кампаний данного типа доступно только получение статистики.

• CPM_FRONTPAGE_CAMPAIGN — кампания с типом «Медийная кампания на Главной». Подробнее о данном типе кампаний см. в разделе Медийный баннер на Главной странице Яндекса Справки Директа.

  В API Яндекс Директа для кампаний данного типа доступно только получение статистики.

• CPM_PRICE — кампания с типом «Кампания с фиксированным СРМ». Подробнее о данном типе кампаний см. в разделе Кампании с фиксированным CPM Справки Директа.

  В API Яндекс Директа для кампаний данного типа доступно только получение статистики.

Устаревшие типы кампаний

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

• SMART_CAMPAIGN — кампания с типом «Смарт-баннеры».

• DYNAMIC_TEXT_CAMPAIGN — кампания с типом «Динамические объявления».

• MOBILE_APP_CAMPAIGN — кампания с типом «Реклама мобильных приложений».

• CPM_DEALS_CAMPAIGN — кампания с типом «Медийная кампания со сделками».

Стратегии показа

См. раздел Стратегии показа.

Денежные параметры

Ограничения на денежные параметры для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода Dictionaries.get.

Статус и состояние кампании

Параметр State отражает текущее состояние показов в кампании.

Состояние	Описание
CONVERTED	Кампания велась в у. е. до перехода пользователя на работу в реальной валюте, в настоящее время перемещена в специальный архив и доступна только для чтения. Примечание Метод get возвращает кампанию в состоянии CONVERTED, только если в параметре States указано значение CONVERTED или в параметре Ids указан идентификатор этой кампании. Если параметры Ids и States оба не заданы, метод не возвращает кампании в состоянии CONVERTED.
ARCHIVED	Кампания помещена в архив с помощью метода archive, пользователем в веб-интерфейсе или автоматически (если на счете нет средств и показов не было более 30 дней).
SUSPENDED	Кампания остановлена владельцем с помощью метода suspend или в веб-интерфейсе.
ENDED	Кампания закончилась (прошла дата окончания).
ON	Кампания активна, объявления могут быть показаны.
OFF	Кампания неактивна (черновик, ожидает модерации, отклонена, отсутствуют средства на кампании или на общем счете, нет активных объявлений).
UNKNOWN	Используется для обеспечения обратной совместимости и отображения состояний, не поддерживаемых в данной версии API.

Параметр Status отражает обобщенный результат модерации объектов кампании.

Статус	Описание
DRAFT	Кампания создана и еще не отправлена на модерацию.
MODERATION	Кампания находится на модерации.
ACCEPTED	Хотя бы одно объявление в кампании принято модерацией.
REJECTED	Все объявления в кампании отклонены модерацией.
UNKNOWN	Используется для обеспечения обратной совместимости и отображения статусов, не поддерживаемых в данной версии API.

Параметр StatusPayment отражает готовность кампании к оплате.

Статус оплаты	Описание
DISALLOWED	Оплата невозможна.
ALLOWED	Кампания принята модерацией или подключен общий счет.

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

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

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

—