Баллы api директ что это
Баллы Яндекс.Директ: что это такое и как их использовать
Когда вы загружаете в Директ масштабные кампании, то можете столкнуться с нехваткой так называемых баллов. Кроме того, за любое изменение в РК, будь то добавление расширений, корректировка ставок, остановка / возобновление показов и т.д. с вашего баланса списывается определенное количество баллов.
В этой статье мы разбираем, для чего это нужно, в каких конкретно случаях и сколько уходит баллов + что делать, если они закончились.
Что такое баллы Яндекс.Директ
Баллы – условная единица, которая по словам разработчиков Яндекса используется для регулирования нагрузки на сервер API. Фактически – за любую операцию, связанную с созданием и изменением рекламной кампании + за синхронизацию со сторонними сервисами. В том числе, с YAGLA.
Обратите внимание: описанные правила и ограничения относятся только к операциям, связанным с API Яндекс.Директ.
Если баллов не хватает, и превышен суточный лимит, вы не сможете выполнить требуемое действие. Что делать – мы разбираем ниже, а пока о методике их начисления.
Как начисляются баллы
Баллы начисляются рекламодателям и агентствам. Если вы работаете от агентства, то можете расходовать их либо со своего счета, либо со счета клиента. Списание от имени агентства зависит от наличия HTTP-заголовка Use-Operator-Units: true. Когда заголовок указан, баллы списываются с агентства, в противном случае — с рекламодателя (клиента агентства).
В ответ на запрос к API Директа в HTTP-заголовке Units указывается:
Пополнение баланса – ежедневное. Суточный лимит у каждого индивидуальный и зависит от активности — количества показов и кликов.
Суточный лимит, в свою очередь, делится на часовые интервалы. В начале каждого интервала у вас 1/24 суточного лимита и вы можете потратить это количество + баллы, неизрасходованные за предыдущие часы.
Чтобы увеличить суточный лимит баллов, нужно увеличить бюджет / поднять ставки. Также Яндекс поощряет за рост CTR + качество кампаний, когда вы регулярно без замечаний проходите модерацию объявлений.
И наоборот суточный лимит может быть снижен за постоянные «косяки» с модерацией и добавление ключевиков с низким CTR.
За что списываются баллы
В этой таблице – базовый список, за что и сколько баллов Яндекс списывает с вашего баланса:
За ошибку вызова метода списывается 20 баллов.
Что делать, если не хватает баллов
Как посмотреть остаток баллов в Директ Коммандере:
1) Загружайте кампании по одной, чтобы снизить нагрузку;
2) Временно отключите автоматическое управление ставками и загрузку данных о расходах, так как для них тоже нужны баллы.
Баллы
Что такое баллы
Директ Коммандер использует программный интерфейс (API) Яндекс.Директа для обмена данными с сервером.
Для регулирования нагрузки на сервер используются баллы. Нехватка баллов не позволяет выполнять запросы к API, то есть получать данные с сервера и отправлять данные на сервер.
Как узнать, сколько осталось баллов
Доступный остаток можно узнать в интерфейсе:
Баллы отображаются в правом верхнем углу окна, рядом с логином.
Баллы агентства отображаются в правом верхнем углу экрана, рядом с логином.
Как начисляются баллы
Суточный лимит баллов для рекламодателя зависит от активности его рекламных кампаний — количества показов и кликов и, соответственно, расходования средств.
Суточный лимит разделен на 24 часовых интервала и предоставляется по принципу скользящего окна. Один раз в час доступный остаток баллов пополняется на 1/24 суточного лимита. В текущем интервале можно потратить 1/24 суточного лимита плюс баллы, начисленные и не израсходованные за предыдущие 23 часа.
Как расходуются баллы
Баллы расходуются при взаимодействии с сервером — получении и отправке данных. Для каждого объекта (кампании, группы, объявления, фразы) и каждой операции (добавление, изменение, удаление, получение) установлена «стоимость» в баллах. Если баллы заканчиваются, доступ к получению и отправке данных приостанавливается.
Для агентств предусмотрено три схемы расходования баллов:
Баллы
Что такое баллы
Директ Коммандер использует программный интерфейс (API) Яндекс.Директа для обмена данными с сервером.
Для регулирования нагрузки на сервер используются баллы. Нехватка баллов не позволяет выполнять запросы к API, то есть получать данные с сервера и отправлять данные на сервер.
Как узнать, сколько осталось баллов
Доступный остаток можно узнать в интерфейсе:
Баллы отображаются в правом верхнем углу окна, рядом с логином.
Баллы агентства отображаются в правом верхнем углу экрана, рядом с логином.
Как начисляются баллы
Суточный лимит баллов для рекламодателя зависит от активности его рекламных кампаний — количества показов и кликов и, соответственно, расходования средств.
Суточный лимит разделен на 24 часовых интервала и предоставляется по принципу скользящего окна. Один раз в час доступный остаток баллов пополняется на 1/24 суточного лимита. В текущем интервале можно потратить 1/24 суточного лимита плюс баллы, начисленные и не израсходованные за предыдущие 23 часа.
Как расходуются баллы
Баллы расходуются при взаимодействии с сервером — получении и отправке данных. Для каждого объекта (кампании, группы, объявления, фразы) и каждой операции (добавление, изменение, удаление, получение) установлена «стоимость» в баллах. Если баллы заканчиваются, доступ к получению и отправке данных приостанавливается.
Для агентств предусмотрено три схемы расходования баллов:
Баллы
Что такое баллы
Директ Коммандер использует программный интерфейс (API) Яндекс.Директа для обмена данными с сервером.
Для регулирования нагрузки на сервер используются баллы. Нехватка баллов не позволяет выполнять запросы к API, то есть получать данные с сервера и отправлять данные на сервер.
Как узнать, сколько осталось баллов
Доступный остаток можно узнать в интерфейсе:
Баллы отображаются в правом верхнем углу окна, рядом с логином.
Баллы агентства отображаются в правом верхнем углу экрана, рядом с логином.
Как начисляются баллы
Суточный лимит баллов для рекламодателя зависит от активности его рекламных кампаний — количества показов и кликов и, соответственно, расходования средств.
Суточный лимит разделен на 24 часовых интервала и предоставляется по принципу скользящего окна. Один раз в час доступный остаток баллов пополняется на 1/24 суточного лимита. В текущем интервале можно потратить 1/24 суточного лимита плюс баллы, начисленные и не израсходованные за предыдущие 23 часа.
Как расходуются баллы
Баллы расходуются при взаимодействии с сервером — получении и отправке данных. Для каждого объекта (кампании, группы, объявления, фразы) и каждой операции (добавление, изменение, удаление, получение) установлена «стоимость» в баллах. Если баллы заканчиваются, доступ к получению и отправке данных приостанавливается.
Для агентств предусмотрено три схемы расходования баллов:
Баллы
Что такое баллы
Директ Коммандер использует программный интерфейс (API) Яндекс.Директа для обмена данными с сервером.
Для регулирования нагрузки на сервер используются баллы. Нехватка баллов не позволяет выполнять запросы к API, то есть получать данные с сервера и отправлять данные на сервер.
Как узнать, сколько осталось баллов
Доступный остаток можно узнать в интерфейсе:
Баллы отображаются в правом верхнем углу окна, рядом с логином.
Баллы агентства отображаются в правом верхнем углу экрана, рядом с логином.
Как начисляются баллы
Суточный лимит баллов для рекламодателя зависит от активности его рекламных кампаний — количества показов и кликов и, соответственно, расходования средств.
Суточный лимит разделен на 24 часовых интервала и предоставляется по принципу скользящего окна. Один раз в час доступный остаток баллов пополняется на 1/24 суточного лимита. В текущем интервале можно потратить 1/24 суточного лимита плюс баллы, начисленные и не израсходованные за предыдущие 23 часа.
Как расходуются баллы
Баллы расходуются при взаимодействии с сервером — получении и отправке данных. Для каждого объекта (кампании, группы, объявления, фразы) и каждой операции (добавление, изменение, удаление, получение) установлена «стоимость» в баллах. Если баллы заканчиваются, доступ к получению и отправке данных приостанавливается.
Для агентств предусмотрено три схемы расходования баллов:
Баллы
Что такое баллы
Директ Коммандер использует программный интерфейс (API) Яндекс.Директа для обмена данными с сервером.
Для регулирования нагрузки на сервер используются баллы. Нехватка баллов не позволяет выполнять запросы к API, то есть получать данные с сервера и отправлять данные на сервер.
Как узнать, сколько осталось баллов
Доступный остаток можно узнать в интерфейсе:
Баллы отображаются в правом верхнем углу окна, рядом с логином.
Баллы агентства отображаются в правом верхнем углу экрана, рядом с логином.
Как начисляются баллы
Суточный лимит баллов для рекламодателя зависит от активности его рекламных кампаний — количества показов и кликов и, соответственно, расходования средств.
Суточный лимит разделен на 24 часовых интервала и предоставляется по принципу скользящего окна. Один раз в час доступный остаток баллов пополняется на 1/24 суточного лимита. В текущем интервале можно потратить 1/24 суточного лимита плюс баллы, начисленные и не израсходованные за предыдущие 23 часа.
Как расходуются баллы
Баллы расходуются при взаимодействии с сервером — получении и отправке данных. Для каждого объекта (кампании, группы, объявления, фразы) и каждой операции (добавление, изменение, удаление, получение) установлена «стоимость» в баллах. Если баллы заканчиваются, доступ к получению и отправке данных приостанавливается.
Для агентств предусмотрено три схемы расходования баллов:
Баллы
Что такое баллы
Директ Коммандер использует программный интерфейс (API) Яндекс.Директа для обмена данными с сервером.
Для регулирования нагрузки на сервер используются баллы. Нехватка баллов не позволяет выполнять запросы к API, то есть получать данные с сервера и отправлять данные на сервер.
Как узнать, сколько осталось баллов
Доступный остаток можно узнать в интерфейсе:
Баллы отображаются в правом верхнем углу окна, рядом с логином.
Баллы агентства отображаются в правом верхнем углу экрана, рядом с логином.
Как начисляются баллы
Суточный лимит баллов для рекламодателя зависит от активности его рекламных кампаний — количества показов и кликов и, соответственно, расходования средств.
Суточный лимит разделен на 24 часовых интервала и предоставляется по принципу скользящего окна. Один раз в час доступный остаток баллов пополняется на 1/24 суточного лимита. В текущем интервале можно потратить 1/24 суточного лимита плюс баллы, начисленные и не израсходованные за предыдущие 23 часа.
Как расходуются баллы
Баллы расходуются при взаимодействии с сервером — получении и отправке данных. Для каждого объекта (кампании, группы, объявления, фразы) и каждой операции (добавление, изменение, удаление, получение) установлена «стоимость» в баллах. Если баллы заканчиваются, доступ к получению и отправке данных приостанавливается.
Для агентств предусмотрено три схемы расходования баллов:
Автоматизация Яндекс.Директ. Часть 1
Совместно с коллегами из ADF Media — Артемом Дурневым и Султаном Назаралиевым, мы решили выпустить цикл из 6 статей, посвященных автоматизации процессов в Яндекс Директе. Сегодня вас ждет вступительная часть, в которой мы поговорим про API, токены Директа и Песочницу.
Чтобы автоматизировать работу Я.Директа, мы должны понимать, что такое API.
API — это составляющая часть сервиса, которая позволяет отправлять запросы и получать ответы.
Единого сценария работы с API нет. У каждого сервиса — сценарий свой. Единственное общее — это токены. Не важно с какой рекламной площадкой вы работаете, в любом случае вам нужно будет получать токен.
Токен — это «ключ» к сервису. Где-то токены нужно получать каждый час, а где-то вы должны владеть двумя «токенами» и передавать их на сервер, чтобы получать «истинный» токен в зашифрованном виде. А где-то вы просто получаете от системы один токен и пользуетесь им продолжительное время.
Так как мы говорим про Яндекс, то в нем получение токена организовано по принципу OAuth. Срок действия токена — один год.
OAuth — это протокол авторизации. Например, получив токен, вы можете передать его любому человеку для авторизации в сервисе, которым пользуетесь. Ему не нужно будет знать ваш логин и пароль, если у него есть токен.
Та же история с Я.Директом. Если вы передадите токен, человек сможет управлять рекламными кампаниями и скачивать данные из статистики за вас.
Токен Яндекс.Директа выглядит следующим образом:
Казалось бы, что это просто набор цифр и букв, но на самом деле каждый такой токен содержит следующую информацию:
Таким образом, токен показывает, что может делать данное приложение от имени определенного аккаунта.
Есть два варианта получения токена. Простой и сложный. Сложный заключается в том, что нам необходимо стать разработчиком и зарегистрировать приложение. Делается это следующим образом:
Указываем название приложения. В описании можно указать для чего создается приложение.
В графе «платформы” указываем веб-сервисы и нажимаем “Подставить URL для разработки».
Далее необходимо указать какие доступы мы можем запрашивать токеном.
После пройденных шагов, вы получите ID и пароль приложения.
После регистрации OAuth приложения нужно подать заявку на доступ к API Яндекс.Директ. Для этого заходим в Яндекс.Директ и переходим во вкладку API, как показано ниже.
Далее открываем «Мои заявки»
Смело нажимаем на «Полный доступ» и заполняем поля. Вот как заполнили мы:
В демо-доступе указали ссылку на Google Таблицу.
Срок рассмотрения заявки до 7 дней, но, как правило, рассмотрение занимает один-два дня. После этого заявка будет одобрена или отклонена. Как только приложение будет одобрено, вы сможете «вытаскивать» токены.
Переходим по ссылке вида:
(Не забудьте, поменять хвостик, заменив его на свой ID, который получили выше)
И в ответ на наш запрос — получаем токен.
Простой способ получения токена — Переходим на сайт ADF-media и авторизовываемся. В ответ на авторизацию, сайт покажет вам ваш токен.
Давайте сделаем первую часть цикла статей максимально полезной и поговорим еще и про Песочницу. Пока поверхностно, чтобы иметь о ней минимально представление.
Песочница — это среда для отладки приложений, взаимодействующих с API Директа.
Песочница имитирует API Директа, но полностью изолирована от настоящих данных. Это «игровая площадка», на которой можно вызывать методы API, получать ответы, наблюдать изменение тестовых кампаний и объявлений. Действия, которые доступны в API только при положительном балансе, в Песочнице доступны без фактического внесения средств.
Запросы к Песочнице не изменяют данные в Директе. Созданные объявления нигде не показываются, а списываемые и зачисляемые средства не влияют на настоящие кампании. Однако для кампаний имитируется полный набор состояний — от модерации до остановки показов при исчерпании средств. Статистические отчеты хотя и содержат условные данные, но по структуре совпадают с настоящими отчетами. Это делает Песочницу полнофункциональной средой для отладки приложений.
Песочница не имеет веб-интерфейса, и посмотреть тестовые кампании в интерфейсе невозможно. Работать с Песочницей можно только через вызовы методов API.
Но нужно помнить, что:
Мы знаем, что такое API, как зарегистрировать приложение и зачем это нужно, а также понимаем, что такое Песочница.
в следующей статье, мы воспользуемся полученными знаниями для передачи первых данных из Яндекс.Директа в Google Таблицы (без знания программирования).