8 (800) 500-31-90 Пн–пт с 10:00 до 19:00
О проекте Преимущества Видеотур Помощь Блог Для агентств и партнеров

Для чего нужны баллы API Яндекс.Директа и как они начисляются

Что такое баллы API Яндекс.Директа

Баллы API регулируют нагрузку на Яндекс.Директ. За каждый запрос к API с баланса рекламодателя списывается определенное количество баллов. Если баллы закончились, запрос выполнить нельзя.

С этими ограничениями сталкивается каждый пользователь Яндекс.Директа.

Как начисляются баллы

У каждого рекламодателя есть суточный лимит баллов, который рассчитывается индивидуально. Он разделен на 24 часовых интервала. В каждый из этих периодов вы можете использовать 1/24 своего суточного количества баллов. Баллы, начисленные и не потраченные за предыдущие 23 часа, добавляются к этой 1/24 части.

Время начала часового интервала может не совпадать с началом астрономического часа и отличаться у разных рекламодателей.

Можно ли получить больше баллов

Количество баллов зависит от того, насколько рационально вы используете ресурсы Яндекс.Директа. Если количество показов и кликов растет незначительно или на балансе кампаний заканчиваются средства, количество баллов будет уменьшено.

Чтобы получить больше баллов, нужно эффективнее использовать ресурсы системы, например:

  • увеличить рекламный бюджет;
  • увеличить CTR за счет более понятных текстов, подходящих ключевых и минус-слов;
  • соблюдать требования рекламной системы, чтобы объявления не отклонялись при модерации.

За что списываются баллы и в каком количестве 

При успешном выполнении операции баллы списываются за вызов метода и за каждый из вызванных объектов.

Операция Метод За вызов За объект

Добавить расширение

создать 5 1
удалить 10 1
получить расширения, отвечающие заданным критериям 5 1
Операции с группами объявлений создать 20 20
удалить 10 0
получить параметры групп, отвечающих заданным критериям 15 1
изменить параметры 20 20
Объявления создать 20 20
архивировать 15 0
удалить 10 0
получить параметры объявлений, отвечающих заданным критериям 15 1
отправить на модерацию 15 0
возобновить показы 15 0
остановить показы 15 0
извлечь из архива 40 0
зменить параметры объявлений 20 20
Ставки получить данные о ставках и приоритетах для ключевых фраз по заданным критериям, и данные, полезные при подборе ставок (данные аукциона по позициям показа на поиске и ставки для охвата различных долей аудитории в сетях) 15 1 балл за каждые 2000 фраз*
назначить фиксированные ставки и приоритеты для ключевых фраз 25 0
рассчитать ставки для фраз по заданному алгоритму (для стратегий с ручным управлением) 25 0
Корректировка ставок создать 15 1
удалить 15 0
получить параметры корректировок, отвечающих заданным критериям 1 0
Изменить коэффициент в корректировках ставок 2 0
вкл/выкл набор корректировок 15 0
Кампании создать 10 5
архивировать 10 5
удалить 10 2
получить параметры кампаний, отвечающих заданным критериям 1 1
возобновить показы в кампании 10 5
остановить кампанию 10 5
извлечь из архива 10 5
изменить параметры кампании 10 3
Изменения получить данные об изменениях в кампаниях, группах и объявлениях 1 0
получить данные об изменениях в кампании 1 0
получить данные об изменениях в справочниках часовых поясов и регионов 1 0
Справочная информация (регионы, часовые пояса, курсы валют и т. д.) получить данные об изменениях 1 0
Динамические объявления создать условия нацеливания, назначить ставки или приоритеты 20 5
удалить условия нацеливания 10 1
получить условия нацеливания 15 1
возобновить показы по установленным условиям нацеливания 10 1
назначить ставки и приоритеты для условий нацеливания 25 0
остановить показы по условиям нацеливания 10 1
Ключевые фразы создать 20 2
удалить 10 1
получить параметры ключевых фраз, отвечающих заданным критериям 15 1
возобновить показы 5 0
остановить показы 15 0
изменить параметры 20 2
Быстрые ссылки создать 20 20
удалить 10 0
получить набор быстрых ссылок, отвечающих заданным критериям. 15 1
Виртуальные визитки создать 20 20
удалить 10 0
получить виртуальные визитки, отвечающие заданным критериям. 15  

В 5 версии API Яндекс.Директа баллы списываются в том числе и за ошибки, а не только за успешные операции.

За ошибку вызова метода списывается 20 баллов.

Исключение — ошибки серверного типа (сервер недоступен).

За ошибку выполнения операции списывается больше баллов, чем при успешной.