GetCampaignsList (Live)
Возвращает список кампаний с краткими сведениями о них.
Метод отключен. Используйте API версии 5.
Информацию о соответствии методов в версиях Live 4 и 5 см. в Руководстве по переходу.
Ограничения
Новое в версии Live 4
Добавлены результирующие параметры StrategyName и ContextStrategyName.
Добавлены результирующие параметры CampaignCurrency и SourceCampaignID (см. также раздел Реальные валюты вместо у. е.).
Добавлен результирующий параметр DayBudgetEnabled.
Добавлен результирующий параметр EnableRelatedKeywords.
Добавлен результирующий параметр ExtendedAdTitleEnabled.
Входные данные
Ниже показана структура входных данных в формате JSON.
{
"method": "GetCampaignsList",
"param": [
(string)
...
]
}
Параметр param используется только при выполнении запроса от лица рекламного агентства. В параметре задают массив логинов (не более 100), для которых требуется получить список кампаний. В остальных случаях param задавать не нужно, а метод возвращает список кампаний пользователя, от лица которого сделан запрос.
Результирующие данные
Ниже показана структура результирующих данных в формате JSON.
{
"data": [
{ /* ShortCampaignInfo */
"CampaignID": (int),
"Login": (string),
"Name": (string),
"StartDate": (date),
"StrategyName": (string),
"ContextStrategyName": (string),
"Sum": (float),
"Rest": (float),
"SumAvailableForTransfer": (float),
"Shows": (int),
"Clicks": (int),
"Status": (string),
"StatusShow": (string),
"StatusArchive": (string),
"StatusActivating": (string),
"StatusModerate": (string),
"IsActive": (string),
"ManagerName": (string),
"AgencyName": (string),
"CampaignCurrency": (string),
"SourceCampaignID": (int),
"DayBudgetEnabled": (string),
"EnableRelatedKeywords": (string),
"ExtendedAdTitleEnabled": (string)
}
...
]
}
Ниже приведено описание параметров.
Параметр | Описание |
Объект ShortCampaignInfo | |
---|---|
CampaignID | Идентификатор кампании. Для создания кампании задают 0, для изменения параметров существующей кампании указывают ее идентификатор. |
Login | Логин владельца кампании (логин пользователя Яндекса, в пользу которого ведется рекламная кампания). При создании кампании прямые рекламодатели указывают собственный логин в Яндексе, рекламные агентства — логин своего клиента. При получении параметров кампании возвращается логин главного представителя рекламодателя. |
Name | Название кампании. |
StrategyName | Стратегия на поиске. Ниже перечислены возможные значения.
Стратегии с ручным управлением ставками на поиске:
Автоматические стратегии на поиске:
|
ContextStrategyName | Стратегия в Рекламной сети Яндекса. Ниже перечислены возможные значения.
Стратегии с ручным управлением ставками в Рекламной сети Яндекса:
Автоматические стратегии в Рекламной сети Яндекса: Важно. Автоматические стратегии в Рекламной сети доступны, только если на поиске выключен показ объявлений (стратегия ShowsDisabled).
|
StartDate | Начало показа объявлений, Дата может находиться в будущем. В этом случае показ объявлений начинается при наступлении указанной даты, если модератор одобрил объявления и внесены средства на баланс кампании. |
Sum | Если у клиента подключен общий счет — сумма израсходованных средств за все время существования кампании. Если общий счет не подключен — сумма средств, зачисленных на баланс кампании за время ее существования. Значение выражено в у. е. Если кампания ведется в реальной валюте, возвращаемое значение конвертируется из валюты кампании в у. е. и округляется по математическим правилам с точностью до второго знака после запятой (см. раздел Реальные валюты вместо у. е.). |
Rest | Текущий баланс общего счета + сумма возврата на кампанию (если у рекламодателя подключен общий счет) или текущий баланс кампании (если общий счет не подключен). Примечание. Сумма возврата средств за клики, признанные системой недобросовестными или ошибочными, может быть израсходована только в рамках этой же кампании. Значение выражено в у. е. Если кампания ведется в реальной валюте, возвращаемое значение конвертируется из валюты кампании в у. е. и округляется по математическим правилам с точностью до второго знака после запятой (см. раздел Реальные валюты вместо у. е.). |
SumAvailableForTransfer | Сумма, доступная для перевода с помощью метода TransferMoney. Возвращается только в случае, если общий счет не подключен. Может быть меньше баланса кампании. Значение выражено в у. е. Если кампания ведется в реальной валюте, возвращаемое значение конвертируется из валюты кампании в у. е. и округляется по математическим правилам с точностью до второго знака после запятой (см. раздел Реальные валюты вместо у. е.). |
Shows | Количество показов за время существования кампании. |
Clicks | Количество кликов за время существования кампании. |
Status | Статус кампании, например: «Идут показы», «Ожидает оплаты», «На модерации», «Остановлена», «Идут показы. Идет активизация», «Кампания заархивирована» и другие. |
StatusShow | Показ объявлений кампании включен — Yes/No. Включение и выключение выполняется методами StopCampaign и ResumeCampaign. Разрешение показа на уровне кампании не означает, что объявления фактически показываются. Для этого необходимо выполнение и других условий: достаточный баланс средств, кампания и объявления проверены модератором, разрешен показ на уровне объявлений (метод ResumeBanners). Фактическому показу соответствует значение Yes в параметре IsActive. |
StatusArchive | Состояние архивации кампании:
Перенос в архив выполняют с помощью метода ArchiveCampaign. Для возврата из архива служит метод UnArchiveCampaign. |
StatusActivating | Состояние активизации кампании:
|
StatusModerate | Результат проверки модератором:
Для отправки на проверку служит метод ModerateBanners. |
IsActive | Кампания активна, объявления показываются — Yes/No. Под активностью понимается состояние кампании, при котором показ объявлений включается и выключается автоматически — в соответствии с настройками временного таргетинга или в зависимости от баланса кампании. Неактивность кампании означает, что показ объявлений заблокирован и не может быть включен автоматически. |
ManagerName | Имя персонального менеджера в Яндексе. Заполняется автоматически для кампаний, обслуживаемых персональным менеджером. |
AgencyName | Название рекламного агентства. Заполняется автоматически, если создателем кампании является агентство. |
CampaignCurrency | Валюта, в которой ведется кампания. Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Если параметр отсутствует или равен NULL, это означает, что кампания ведется в у. е. |
SourceCampaignID | Идентификатор исходной кампании в у. е., если текущая кампания была создана автоматически при переходе клиента на работу в валюту (см. раздел Процедура перехода). Отсутствует или равен NULL — в противном случае. |
DayBudgetEnabled | Доступно ли управление дневным бюджетом кампании — Yes/No. |
EnableRelatedKeywords | Авторасширение фраз включено — Yes/No. |
ExtendedAdTitleEnabled | Подстановка части текста объявления в заголовок включена — Yes/No. |
Параметр | Описание |
Объект ShortCampaignInfo | |
---|---|
CampaignID | Идентификатор кампании. Для создания кампании задают 0, для изменения параметров существующей кампании указывают ее идентификатор. |
Login | Логин владельца кампании (логин пользователя Яндекса, в пользу которого ведется рекламная кампания). При создании кампании прямые рекламодатели указывают собственный логин в Яндексе, рекламные агентства — логин своего клиента. При получении параметров кампании возвращается логин главного представителя рекламодателя. |
Name | Название кампании. |
StrategyName | Стратегия на поиске. Ниже перечислены возможные значения.
Стратегии с ручным управлением ставками на поиске:
Автоматические стратегии на поиске:
|
ContextStrategyName | Стратегия в Рекламной сети Яндекса. Ниже перечислены возможные значения.
Стратегии с ручным управлением ставками в Рекламной сети Яндекса:
Автоматические стратегии в Рекламной сети Яндекса: Важно. Автоматические стратегии в Рекламной сети доступны, только если на поиске выключен показ объявлений (стратегия ShowsDisabled).
|
StartDate | Начало показа объявлений, Дата может находиться в будущем. В этом случае показ объявлений начинается при наступлении указанной даты, если модератор одобрил объявления и внесены средства на баланс кампании. |
Sum | Если у клиента подключен общий счет — сумма израсходованных средств за все время существования кампании. Если общий счет не подключен — сумма средств, зачисленных на баланс кампании за время ее существования. Значение выражено в у. е. Если кампания ведется в реальной валюте, возвращаемое значение конвертируется из валюты кампании в у. е. и округляется по математическим правилам с точностью до второго знака после запятой (см. раздел Реальные валюты вместо у. е.). |
Rest | Текущий баланс общего счета + сумма возврата на кампанию (если у рекламодателя подключен общий счет) или текущий баланс кампании (если общий счет не подключен). Примечание. Сумма возврата средств за клики, признанные системой недобросовестными или ошибочными, может быть израсходована только в рамках этой же кампании. Значение выражено в у. е. Если кампания ведется в реальной валюте, возвращаемое значение конвертируется из валюты кампании в у. е. и округляется по математическим правилам с точностью до второго знака после запятой (см. раздел Реальные валюты вместо у. е.). |
SumAvailableForTransfer | Сумма, доступная для перевода с помощью метода TransferMoney. Возвращается только в случае, если общий счет не подключен. Может быть меньше баланса кампании. Значение выражено в у. е. Если кампания ведется в реальной валюте, возвращаемое значение конвертируется из валюты кампании в у. е. и округляется по математическим правилам с точностью до второго знака после запятой (см. раздел Реальные валюты вместо у. е.). |
Shows | Количество показов за время существования кампании. |
Clicks | Количество кликов за время существования кампании. |
Status | Статус кампании, например: «Идут показы», «Ожидает оплаты», «На модерации», «Остановлена», «Идут показы. Идет активизация», «Кампания заархивирована» и другие. |
StatusShow | Показ объявлений кампании включен — Yes/No. Включение и выключение выполняется методами StopCampaign и ResumeCampaign. Разрешение показа на уровне кампании не означает, что объявления фактически показываются. Для этого необходимо выполнение и других условий: достаточный баланс средств, кампания и объявления проверены модератором, разрешен показ на уровне объявлений (метод ResumeBanners). Фактическому показу соответствует значение Yes в параметре IsActive. |
StatusArchive | Состояние архивации кампании:
Перенос в архив выполняют с помощью метода ArchiveCampaign. Для возврата из архива служит метод UnArchiveCampaign. |
StatusActivating | Состояние активизации кампании:
|
StatusModerate | Результат проверки модератором:
Для отправки на проверку служит метод ModerateBanners. |
IsActive | Кампания активна, объявления показываются — Yes/No. Под активностью понимается состояние кампании, при котором показ объявлений включается и выключается автоматически — в соответствии с настройками временного таргетинга или в зависимости от баланса кампании. Неактивность кампании означает, что показ объявлений заблокирован и не может быть включен автоматически. |
ManagerName | Имя персонального менеджера в Яндексе. Заполняется автоматически для кампаний, обслуживаемых персональным менеджером. |
AgencyName | Название рекламного агентства. Заполняется автоматически, если создателем кампании является агентство. |
CampaignCurrency | Валюта, в которой ведется кампания. Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Если параметр отсутствует или равен NULL, это означает, что кампания ведется в у. е. |
SourceCampaignID | Идентификатор исходной кампании в у. е., если текущая кампания была создана автоматически при переходе клиента на работу в валюту (см. раздел Процедура перехода). Отсутствует или равен NULL — в противном случае. |
DayBudgetEnabled | Доступно ли управление дневным бюджетом кампании — Yes/No. |
EnableRelatedKeywords | Авторасширение фраз включено — Yes/No. |
ExtendedAdTitleEnabled | Подстановка части текста объявления в заголовок включена — Yes/No. |
Примеры входных данных
Python
['login1', 'login2']
PHP
array('login1', 'login2')
Perl
['login1', 'login2']