--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/direct/doc/en/objects/campaign.md - https://yandex.com/dev/direct/doc/ru/objects/campaign.md - href: ru/objects/campaign.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt sourcePath: ru/dg/objects/campaign.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt # Кампания (Campaign) Объект Кампания (Campaign) содержит настройки кампании и суммарную статистику. ## Сервис {#service} Для управления кампаниями предназначен сервис [Campaigns](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/campaigns.html). ### Методы {#methods} [add](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add.html) | [update](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update.html) | [delete](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/delete.html) | [suspend](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/suspend.html) | [resume](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/resume.html) | [archive](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/archive.html) | [unarchive](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/unarchive.html) | [get](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/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) (элементы CAMPAIGNS_TOTAL_PER_CLIENT и CAMPAIGNS_UNARCHIVED_PER_CLIENT массива [Restrictions](*Restrictions)). ## Тип кампании {#type} Тип кампании задается при создании кампании и недоступен для изменения. Тип кампании определяет тип дочерних [групп объявлений](https://yandex.com/dev/direct/doc/ru/objects/adgroup.md): в кампанию можно добавить только группы соответствующего типа. Часть параметров кампании являются общими для всех типов кампаний, а часть — зависящими от типа кампании. Параметры, зависящие от типа кампании, передаются в дочерней структуре с соответствующим именем. В настоящее время существуют следующие типы кампаний: - TEXT_CAMPAIGN — кампания с типом «Текстово-графические объявления». Чтобы создать или отредактировать кампанию данного типа, необходимо передать параметры кампании в структуре `TextCampaign` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update.html). Описание параметров приведено в разделах [add: параметры TextCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add-text-campaign.html), [update: параметры TextCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update-text-campaign.html). При получении параметров кампании необходимо перечислить имена параметров, общих для всех типов кампаний, во входном параметре `FieldNames`, а имена параметров, специфичных для данного типа кампании, — во входном параметре `TextCampaignFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get.html). Описание возвращаемых параметров для данного типа кампании приведено в разделе [get: параметры TextCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get-text-campaign.html). - UNIFIED_CAMPAIGN — единая перфоманс кампания. Чтобы создать или отредактировать кампанию данного типа, необходимо передать параметры кампании в структуре `UnifiedCampaign` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update.html). Описание параметров приведено в разделах [add: параметры UnifiedCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add-unified-campaign.html), [update: параметры UnifiedCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update-unified-campaign.html). При получении параметров кампании необходимо перечислить имена параметров, общих для всех типов кампаний, во входном параметре `FieldNames`, а имена параметров, специфичных для данного типа кампании, — во входном параметре `UnifiedCampaignFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get.html). Описание возвращаемых параметров для данного типа кампании приведено в разделе [get: параметры UnifiedCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get-unified-campaign.html). - SMART_CAMPAIGN — кампания с типом «Смарт-баннеры». Подробнее о смарт-баннерах см. в разделе [Смарт-баннеры](https://yandex.ru/support/direct/smart-banners/about.html) Справки Директа. Чтобы создать или отредактировать кампанию данного типа, необходимо передать параметры кампании в структуре `SmartCampaign` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update.html). Описание параметров приведено в разделах [add: параметры SmartCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add-smart-campaign.html), [update: параметры SmartCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update-smart-campaign.html). При получении параметров кампании необходимо перечислить имена параметров, общих для всех типов кампаний, во входном параметре `FieldNames`, а имена параметров, специфичных для данного типа кампании, — во входном параметре `SmartCampaignFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get.html). Описание возвращаемых параметров для данного типа кампании приведено в разделе [get: параметры SmartCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get-smart-campaign.html). - DYNAMIC_TEXT_CAMPAIGN — кампания с типом «Динамические объявления». Подробнее о динамических объявлениях см. в разделе [Динамические объявления](https://yandex.ru/support/direct/dynamic-text-ads/about-da.html) Справки Директа. Чтобы создать или отредактировать кампанию данного типа, необходимо передать параметры кампании в структуре `DynamicTextCampaign` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update.html). Описание параметров приведено в разделах [add: параметры DynamicTextCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add-dynamic-text-campaign.html), [update: параметры DynamicTextCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update-dynamic-text-campaign.html). При получении параметров кампании необходимо перечислить имена параметров, общих для всех типов кампаний, во входном параметре `FieldNames`, а имена параметров, специфичных для данного типа кампании, — во входном параметре `DynamicTextCampaignFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get.html). Описание возвращаемых параметров для данного типа кампании приведено в разделе [get: параметры DynamicTextCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get-dynamic-text-campaign.html). - MOBILE_APP_CAMPAIGN — кампания с типом «Реклама мобильных приложений». Подробнее о продвижении мобильных приложений см. в разделе [Продвижение приложений](https://yandex.ru/support/direct/ru/products-mobile-apps-ads/about) Справки Директа. Чтобы создать или отредактировать кампанию данного типа, необходимо передать параметры кампании в структуре `MobileAppCampaign` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update.html). Описание параметров приведено в разделах [add: параметры MobileAppCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add-mobile-app-campaign.html), [update: параметры MobileAppCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update-mobile-app-campaign.html). При получении параметров кампании необходимо перечислить имена параметров, общих для всех типов кампаний, во входном параметре `FieldNames`, а имена параметров, специфичных для данного типа кампании, — во входном параметре `MobileAppCampaignFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get.html). Описание возвращаемых параметров для данного типа кампании приведено в разделе [get: параметры MobileAppCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get-mobile-app-campaign.html). - MCBANNER_CAMPAIGN — кампания с типом «Баннер на поиске». Подробнее о баннере на поиске см. в разделе [Баннер на поиске](https://yandex.ru/support/direct/products-media-context-banner/about.html) Справки Директа. В API Яндекс Директа для кампаний данного типа доступно только получение статистики. - CPM_BANNER_CAMPAIGN — кампания с типом «Медийная кампания». Подробнее о медийных кампаниях см. в разделе [Медийные баннеры](https://yandex.ru/support/direct/products-cpm-campaign/about.html) Справки Директа. Чтобы создать или отредактировать кампанию данного типа, необходимо передать параметры кампании в структуре `CpmBannerCampaign` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update.html). Описание параметров приведено в разделах [add: параметры CpmBannerCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/add-cpm-banner-campaign.html), [update: параметры CpmBannerCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/update-cpm-banner-campaign.html). При получении параметров кампании необходимо перечислить имена параметров, общих для всех типов кампаний, во входном параметре `FieldNames`, а имена параметров, специфичных для данного типа кампании, — во входном параметре `CpmBannerCampaignFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get.html). Описание возвращаемых параметров для данного типа кампании приведено в разделе [get: параметры CpmBannerCampaign](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get-cpm-banner-campaign.html). - CPM_DEALS_CAMPAIGN — кампания с типом «Медийная кампания со сделками». Подробнее о сделках см. в разделе [Сделки](https://yandex.ru/support/direct/products-cpm-campaign/deals.html) Справки Директа. В API Яндекс Директа для кампаний данного типа доступно только получение статистики. - CPM_FRONTPAGE_CAMPAIGN — кампания с типом «Медийная кампания на Главной». Подробнее о данном типе кампаний см. в разделе [Медийный баннер на Главной странице Яндекса](https://yandex.ru/support/direct/products-cpm-campaign-frontpage/about.html) Справки Директа. В API Яндекс Директа для кампаний данного типа доступно только получение статистики. - CPM_PRICE — кампания с типом «Кампания с фиксированным СРМ». Подробнее о данном типе кампаний см. в разделе [Кампании с фиксированным CPM](https://yandex.ru/support/direct/fixed-cpm-campaigns/products-fixed-cpm.html) Справки Директа. В API Яндекс Директа для кампаний данного типа доступно только получение статистики. ## Стратегии показа {#strategy} См. раздел [Стратегии показа](https://yandex.com/dev/direct/doc/ru/objects/campaign-strategies.md). ## Денежные параметры {#currency-limits} {% note alert %} Все денежные параметры кампаний (недельный бюджет, средняя цена для автоматических стратегий) передаются через API Директа в виде целых чисел. Передаваемое значение представляет собой денежное значение в валюте пользователя, умноженное на 1 000 000. {% endnote %} Ограничения на денежные параметры для каждой валюты представлены в справочнике валют. Справочник валют можно получить с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ref-v5/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/dictionaries/get.html). ## Статус и состояние кампании {#status} Параметр `State` отражает текущее состояние показов в кампании. #| || **Состояние** | **Описание** || || CONVERTED | Кампания велась в у. е. до перехода пользователя на работу в реальной валюте, в настоящее время перемещена в специальный архив и доступна только для чтения. {% note info %} Метод [get](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get.html) возвращает кампанию в состоянии CONVERTED, только если в параметре `States` указано значение CONVERTED или в параметре `Ids` указан идентификатор этой кампании. Если параметры `Ids` и `States` оба не заданы, метод не возвращает кампании в состоянии CONVERTED. {% endnote %} || || ARCHIVED | Кампания помещена в архив с помощью метода [archive](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/archive.html), пользователем в веб-интерфейсе или автоматически (если на счете нет средств и показов не было более 30 дней). || || SUSPENDED | Кампания остановлена владельцем с помощью метода [suspend](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/suspend.html) или в веб-интерфейсе. || || ENDED | Кампания закончилась (прошла дата окончания). || || ON | Кампания активна, объявления могут быть показаны. || || OFF | Кампания неактивна (черновик, ожидает модерации, отклонена, отсутствуют средства на кампании или на общем счете, нет активных объявлений). || || UNKNOWN | Используется для обеспечения обратной совместимости и отображения состояний, не поддерживаемых в данной версии API. || |# Параметр `Status` отражает обобщенный результат модерации объектов кампании. #| || **Статус** | **Описание** || || DRAFT | Кампания создана и еще не отправлена на модерацию. || || MODERATION | Кампания находится на модерации. || || ACCEPTED | Хотя бы одно объявление в кампании принято модерацией. || || REJECTED | Все объявления в кампании отклонены модерацией. || || UNKNOWN | Используется для обеспечения обратной совместимости и отображения статусов, не поддерживаемых в данной версии API. || |# Параметр `StatusPayment` отражает готовность кампании к оплате. #| || **Статус оплаты** | **Описание** || || DISALLOWED | Оплата невозможна (либо доступна только [оплата до прохождения модерации](https://yandex.ru/support/direct-tooltips/pay-before-moderated.html)). || || ALLOWED | Кампания принята модерацией или подключен общий счет. || |# [*Restrictions]: **Для пользователя** Количественные ограничения на объекты пользователя. **Для агентства** —