---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/live/CreateNewForecast.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/live/CreateNewForecast.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# CreateNewForecast (Live)
Запускает на сервере формирование прогноза показов, кликов и затрат.
Метод возвращает идентификатор будущего отчета. По идентификатору можно узнать о готовности отчета (метод [GetForecastList](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetForecastList.md)) и скачать отчет (метод [GetForecast (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetForecast.md)). Среднее время формирования отчета — до одной минуты.

## Ограничения {#CreateNewForecat-restrictions}

Для одного пользователя на сервере хранится не более пяти отчетов. При попытке сформировать шестой отчет возвращается сообщение об ошибке с кодом [31](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/ErrorCodes.md#ErrorCode31). Отчеты хранятся в течение пяти часов, а затем автоматически удаляются. С помощью метода [DeleteForecastReport](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/DeleteForecastReport.md) можно удалить отчет вручную.

## Новое в версии Live 4

Входной параметр Currency стал обязательным.

Добавлен входной параметр Currency.

Добавлен входной параметр AuctionBids.


## Входные данные {#input}

Ниже показана структура входных данных в формате JSON.

```javascript
{
   "method": "CreateNewForecast",
   "param": {
      /* NewForecastInfo */
      "Phrases": [
         (string)
         ...
      ],
      "Categories": [
         (int)
         ...
      ],
      "GeoID": [
         (int)
         ...
      ],
      "Currency": (string),
      "AuctionBids": (string),
      "CommonMinusWords": [
         (string)
         ...
      ]
   }
}
```

Ниже приведено описание параметров.


#|
||
**Параметр**
|
**Описание**
|
**Требуется**
||

||
**Объект NewForecastInfo**
||
||
`Phrases`
|
Массив ключевых фраз, для которых требуется получить прогноз (не более 100 фраз в кодировке UTF-8).

Ключевые фразы могут содержать минус-фразы. Минус-фразу из нескольких слов следует заключить в скобки, например:

_холодильник -морозильник -(морозильная камера) -ремонт_.


{% note info %}

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

{% endnote %}
|
Да
||
||
`Categories`
|
Массив, содержащий идентификаторы рубрик Яндекс Каталога. Параметр не используется, переданное значение игнорируется.
|
Нет
||
||
`GeoID`
|
Массив, содержащий идентификаторы регионов для составления прогноза. Если не задан, прогноз составляется по всем регионам.

Список регионов получают с помощью метода [GetRegions (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetRegions.md).
|
Нет
||
||
`Currency`
|
Валюта, в которой должны быть выражены цены клика и суммарные затраты в отчете.

Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN.
|
Да
||
||
`AuctionBids`
|
Выводить ли в отчете результаты торгов (массив `AuctionBids`) — Yes/No. Если не задано, подразумевается No.
|
Нет
||
||
`CommonMinusWords`
|
Единый набор минус-фраз.
|
Нет
||
|#


## Результирующие данные {#output}

Метод возвращает идентификатор будущего отчета, как показано в следующем примере.

```javascript
{
   "data": 137456
}
```


## Примеры входных данных {#example}

## Python

```python
{
   'Phrases': [u'холодильник -камера', u'холодильная камера'],
   'GeoID': [213]
}
```

## PHP

```php
array(
   'Phrases' => array('nokia', 'phone', 'cars'),
   'GeoID' => array(213)
)
```

## Perl

```perl
{
   'Phrases' => ['nokia', 'phone', 'cars'],
   'GeoID' => [213]
}
```