Прогнозатор — это сервис оценки ёмкости доступной потенциальной аудитории. Он прогнозирует зависимость уникальных пользователей, которые будут доступны для показа объявления, от цены за клик или показ.
Запрос:
https://target.my.com/api/v2/projection.json{
"package": { "id": 83 }, "targetings": { "age": [19, 20, 21, 22, 23], "sex": ["male", "female"], "fulltime": { "flags": ["cross_timezone", "use_holidays_moving"], "wed": [20, 21], "sun": [], "thu": [20, 21], "tue": [], "mon": [], "fri": [20, 21], "sat": [] }, "remarketing": [], "pads": [5206] }, "campaign": { "id": 5650870 }, "step": 0.1, "share_limit": 75}В запросе обязательно должно присутствовать значение как минимум для одного из параметров campaign или package.
При указании кампании, прогноз будет строиться конкретно для данной кампании с учётом её истории. При указании только пакета будет строиться прогноз для новой кампании в этом пакете с учётом истории пользователя.
В блоке targetings необходимо передавать все необходимые таргетинги. Обязательным является только таргетинг pads, значения для которого необходимо брать из pad.values в package.options.
Прогнозатор будет учитывать только те таргетинги, которые разрешены настройками пакета. Если таргетинг не указан в запросе, он не будет учитываться при построении прогноза.
Список поддерживаемых прогнозатором таргетингов (неуказанные здесь не учитываются при построении прогноза):
- площадки (идентификаторы рекламных площадок);
- возраст
- пол (male — мужчины, female — женщины, unknown — неопределён);
- география — регионы и пользовательская география (города);
- дни и время показа;
- интересы (идентификаторы);
- время, проводимое за просмотром телевизора (смотрят много(htv)/средне(mtv)/мало(ltw));
- наличие высшего образования (education_yes/education_no);
- занятость(employment_yes/employment_no)
- семейный статус (married/unmarried);
- уровень доходов (ниже среднего, средний, выше среднего, высокий, премиум — income_1...income_5);
- типы мобильных устройств;
- мобильный канал доступа в интернет;
- мобильные операционные системы;
- производители мобильных устройств.
Дополнительные параметры, влияющие на конфигурацию ответа сервиса:
- step — шаг изменения цены показа в валюте пользователя (по умолчанию 0.05), влияет на количество точек в возвращаемой гистограмме;
- share_limit — предел доли аудитории (в процентах), ограничивающий количество точек гистограммы сверху (по умолчанию не установлен).
В отличии от прогнозатора v1, передача user_id больше не требуется.
Ответ:
{ "currency": "RUB", "days": 7, "approximate_cr": "0.01", "approximate_ctr": "0.00252386360695", "histogram": [ { "uniqs": 42262, "share": 46, "price": 2.28 }, ..., { "uniqs": 48683, "share": 53, "price": 2.98 }, { "uniqs": 56525, "share": 61, "price": 3.08 }, { "uniqs": 57525, "share": 62, "price": 3.18 }, ..., { "uniqs": 68630, "share": 75, "price": 7.98 } ]}- approximate_ctr — прогнозируемый CTR кампании;
- approximate_cr — прогнозируемый CR кампании;
- days — количество предыдущих дней, на основании данных за которые строится прогноз;
- currency — валюта пользователя в которой указываются цены в гистограмме;
- histogram — распределение прогнозируемой аудитории в зависимости от цены:
- uniqs — количество уникальных пользователей в аудитории, доступной при данной цене;
- share — доля (в процентах) аудитории при данной цене от максимально возможной аудитории;
- price — цена за показ для достижения прогнозируемой аудитории.
На основании полученных данных можно также рассчитать рекомендуемую стоимость за клик или установку:
price_per_click = price / (approximate_ctr * 1000)
price_per_install = price / (approximate_ctr * approximate_cr * 1000)
Более не возвращаются точки гистограммы с нулевой аудиторией или с аудиторией уже достигнутой при цене предыдущей точки. Все цены в ответе возвращаются в виде чисел с плавающей точкой (float).
Рекомендуемой эффективной ставкой считается та, которая охватывает 60 и более процентов аудитории.