Что такое баллы Яндекс.Директ и как их использовать
Когда вы загружаете в Директ масштабные кампании, то можете столкнуться с нехваткой так называемых баллов. Кроме того, за любое изменение в РК, будь то добавление расширений, корректировка ставок, остановка / возобновление показов и т.д. с вашего баланса списывается определенное количество баллов.
В этой статье мы разбираем, для чего это нужно, в каких конкретно случаях и сколько уходит баллов + что делать, если они закончились.
Что такое баллы Яндекс.Директ
Баллы – условная единица, которая по словам разработчиков Яндекса используется для регулирования нагрузки на сервер API. Фактически – за любую операцию, связанную с созданием и изменением рекламной кампании + за синхронизацию со сторонними сервисами. В том числе, с YAGLA.
Обратите внимание: описанные правила и ограничения относятся только к операциям, связанным с API Яндекс.Директ.
Если баллов не хватает, и превышен суточный лимит, вы не сможете выполнить требуемое действие. Что делать – мы разбираем ниже, а пока о методике их начисления.
Как начисляются баллы
Баллы начисляются рекламодателям и агентствам. Если вы работаете от агентства, то можете расходовать их либо со своего счета, либо со счета клиента. Списание от имени агентства зависит от наличия HTTP-заголовка Use-Operator-Units: true. Когда заголовок указан, баллы списываются с агентства, в противном случае — с рекламодателя (клиента агентства).
В ответ на запрос к API Директа в HTTP-заголовке Units указывается:
- Сколько израсходовано;
- Сколько осталось;
- Суточный лимит.
Пополнение баланса – ежедневное. Суточный лимит у каждого индивидуальный и зависит от активности — количества показов и кликов.
Суточный лимит, в свою очередь, делится на часовые интервалы. В начале каждого интервала у вас 1/24 суточного лимита и вы можете потратить это количество + баллы, неизрасходованные за предыдущие часы.
Чтобы увеличить суточный лимит баллов, нужно увеличить бюджет / поднять ставки. Также Яндекс поощряет за рост CTR + качество кампаний, когда вы регулярно без замечаний проходите модерацию объявлений.
И наоборот суточный лимит может быть снижен за постоянные «косяки» с модерацией и добавление ключевиков с низким CTR.
За что списываются баллы
В этой таблице – базовый список, за что и сколько баллов Яндекс списывает с вашего баланса:
За ошибку вызова метода списывается 20 баллов.
Что делать, если не хватает баллов
Как посмотреть остаток баллов в Директ Коммандере:
Пара хитростей:
1) Загружайте кампании по одной, чтобы снизить нагрузку;
2) Временно отключите автоматическое управление ставками и загрузку данных о расходах, так как для них тоже нужны баллы.
Высоких вам конверсий!
yagla.ru
Баллы яндекс директ. Инструкция по применению.
Эта статья расскажет о системе баллов Яндекс Директ, для чего они, почему и как, а также рекомендации и советы. Актуально для тех кто работает с большим количеством объявлений.
Размещая сразу много рекламных объявлений, пользователи директа часто сталкиваются с недостатком баллов. Это вызывает серьезное ограничение для рекламодателей в том случае если необходимо загрузить сразу большое количество объявлений. Как правило эта проблема наиболее актуальна на начальном этапе использования аккаунта, когда он только прошел регистрацию и является еще достаточно молодым и не успел накопить достаточное количество баллов.
Содержание:
- Что такое баллы Я. Директ
- Как начисляются и списываются баллы
- Как оптимально расходовать баллы
- Полезные ссылки
Что такое баллы Яндекс Директ
Баллы это система ограничений для пользователей, чтобы снизить нагрузку на сервер API Яндекса.
Из-за этого возникают затруднения в публикации объявлений, из-за чего их, в ряде случаев, приходится размещать поэтапно. Однако, если знать некоторые нюансы, то можно избежать этих неудобств.
Как только рекламодатель зарегистрировался в сервисе Яндекс Директ, то он, в большинстве случаев, получает приблизительно 3200 баллов. Они выступают в роли своеобразной регулировки нагрузки API на сервера. Если же баллов недостаточно, то запросы к API не производятся. Зачастую их количества, особенно на начальном этапе, хватает с лихвой. Вот только пользователи, которым нужно разместить за раз сотню и более объявлений сталкиваются с проблемой.
Яндекс конечно не бедная организация и они могли бы отказаться от бальной системы, что бы не осложнять жизнь рекламодателям, но не хотят они раскошеливаться чтобы нарастить мощность серверов. Ибо если балльные ограничения снять, то скорей всего их API сервер просто рухнет. А так они создают головную боль для некоторых рекламодателей, но экономят на сервере, как говорят копейка рубль бережёт.
Если работать только с веб интерфейсом и загружать рекламные компании например через XLS, то можно сразу столкнуться с нехваткой баллов, особенно на новом аккаунте. При работе с XLS/XLSX съедается большое количество баллов.
Может быть например вот так:
Бальные ограничения присутствуют также и в директ коммандере.
При работе с коммандером нам доступны расширенные возможности для работы с рекламными компаниями. Баллы в коммандере можно посмотреть в левом верхнем углу.
На моем новом аккаунте доступно 32000 и 99998 баллов, лимиты здесь больше. На рисунке вы видите, две строчки, это баллы в двух версиях API Яндекса, обращения к серверу применяются методы обеих версий, в более новой версии доступно большее количество баллов. Но недостаток баллов в одной из версий все равно приведет к ограничениям.
Как начисляются и списываются баллы Яндекс Директ
Как баллы начисляются.
Каждому рекламодателю доступен определенный суточный лимит, он рассчитывается индивидуально, так как напрямую зависит от количества кликов по объявлению. Если кликов много, то соответственно много расходуется средств с баланса рекламодателя, тогда и лимит больше, потому что Яндекс больше зарабатывает. Это считается рациональным использованием директа.
В противном случае если запущена рекламная компания, но активности мало, то есть показы идут, но мало кликов, то соответственно мало расходуется средств. И такое использование директа рекламодателем считается не рациональным и лимиты начисления балов уменьшаются.
Во всем присутствует простая финансовая логика. Поощряется баллами тот кто приносит больше прибыли Яндексу.
Лимит этот разделен на 24 интервала, то есть начисляется каждый час. На рисунке показан крайний час, соответственно в этот час нам будет доступно 1/24 лимита и все неизрасходованные баллы.
Поэтому в некоторых случаях к вечеру будет выгодней загружать рекламные компании, чем в начале суток, лимит будет больше.
Как баллы яндекс директ списываются.
Принцип системы состоит в следующем:
За определенные действия с рекламодателя изымается фиксированное количество баллов, например:
Публикация объявления требует 12 баллов, тогда как изменение его – 4
Использование ключевого слова – 2 балла
Внесение изменений в ключевую фразу – 1 балл
Использование изображения – 2 балла.
По окончанию баллов на аккаунте, для пользователя эти операции станут недоступны. Как уже говорилось выше это снижает загруженность сервера и также в некоторых случаев позволяет отсеять тех пользователей, которые неэффективно используют ресурсы директа (приносят Яндексу мало денег).
Баллы на личном счету не накапливаются, по окончанию суток накопленные за сутки и не расходованные баллы обнуляются. Со временем количество баллов, которые можно потратить и которые будут накоплены снова, увеличится. Это обусловлено особым алгоритмом, который напрямую зависит от действий пользователя.
Лимит может снизиться по ряду причин:
Из-за большого количество объявлений, которые не прошли модерацию.
Добавление ключевых слов, имеющих низкий показатель CTR и т.д.
Вот, что по этому поводу говорится в справке Яндекса:
Как оптимально расходовать баллы Яндекс директ
Чтобы баллы восстанавливались гарантированно, следует уделять большое значение качеству рекламных объявлений и самой рекламной стратегии. Они начисляются активнее при условии:
Крупный бюджет и высокие ставки.
Наличие объявлений с высоким показателем качества, которые будут иметь больший CTR.
То есть вы будете делать то, что может принести Яндексу больше прибыли.
При необходимости иметь большое количество баллов, рекламодатель может схитрить.
В самом начале, после регистрации аккаунта, можно опубликовать одно объявление высокого качества, используя при этом ключевую фразу с низкой частотой запросов. За нее гарантировано будет начислено большое количество баллов, которые можно будет использовать для начала основной компании.
Более лучший вариант это Директ Коммандер, где лимиты значительно выше, нежели в веб интерфейсе Директа.
Также если у вас много рекламных компаний, то разнесите их по разным аккаунтам, так у вас суммарно будет больше доступных баллов.
Когда у вас более или менее качественная рекламная компания, то у вас будет много баллов Яндекс директ.
Прочитал статью сделай репост, напиши комментарий, скажи автору спасибо.
А чтобы ваши компании были более качественными прочтите статьи:
Секреты Яндекс директ.
Директ без НДС
dramtezi.ru
Баллы Яндекс Директ | Autodirect5
- Главная
- Блог
- Баллы Яндекс Директ
Баллы используются в тех случаях, когда нужно загрузить большое количество объявлений в кампанию. Существует ограничение Яндекс Директа по одновременной загрузке этих объявлений в рекламную кампанию. Чаще всего оно бывает, когда кампания относительно новая и попросту еще не накопились эти самые баллы. Рассмотрим в данной статье в чем заключается сама суть этих баллов, как они рассчитываются и как все это работает.
Что такое баллы в Яндекс Директе
Баллы — это условный набор привилегий, для обхода ограничения при загрузке большого количества информации, чтобы не перегружать работу сервера Яндекса.
Изначально, до добавления такой функции, сервер Яндекса сильно перегружался и нужно было загружать изменения поэтапно, то есть каждое объявление поочередно. Но после добавления системы баллов, такая перегрузка пропала, так как появилось ограничение. И благодаря этому можно в пределах этих баллов вносить большое количество изменений.
Существует ряд нюансов, которые следует знать каждому рекламодателю по поводу работы данной системы.
При регистрации на сервисе Яндекс Директа, вам автоматически будут зачислены 3200 баллов. Это что-то вроде приветственных баллов, которые будут регулировать нагрузку API на сервер на начальном этапе. Их достаточно чтобы загрузить примерно до 100 объявлений одновременно. Но если кампания у вас большая и рекламных объявлений будет больше, то придется столкнуться с ограничением.
Конечно же, если бы Яндекс просто увеличил мощность серверов, то было бы намного комфортнее работать всем. Однако, и здесь есть свои недостатки. Вероятнее всего API сервер попросту рухнет, как только ограничения будут сняты. А ведя такую систему с баллами и ограничением, они создают для рекламодателей более дискомфортные условия, но при этом предоставляют стабильную работу сервиса.
Практически все баллы списываются при работе с загрузкой файлов XLS/XLSX. Чаще всего с проблемами ограничения сталкиваются те, у кого новые аккаунты.
Как функционирует система ограничения Яндекс Директа
Рассмотрим подробнее как и за что начисляются баллы, а так же за что они списываются.
Начисление. Начисления баллов происходят посуточно и рассчитываются для каждого рекламодателя индивидуально. Оно зависит непосредственно от количества кликов. Если их много, то пропорционально и лимит баллов будет увеличиваться. Таким образом и происходит система накопления, которая после позволяет работать с еще большими количествами объявлений. Такой способ работы выгоден для самого Яндекса, впрочем, и рекламодателю. Ведь чем выше показатели рекламной кампании, тем больше возможностей открывает сервис.
В обратном случае, если показатели низкие, то и начисление баллов значительно ниже, что по определению больше ограничивает в редактировании объявлений.
То есть логика проста:
Баллы — это система поощрения Яндексом, которая начисляется тем, кто приносит больше прибыли непосредственно самому сервису Яндекс.
Суточные баллы начисляются не единовременно, а каждый час. То есть общее число суточного лимита, к примеру 3200, будет поделено на 24 часовых отрезков времени. Таким образом, каждый час будет начисляться примерно 133,33 балла.
Если у вас большой объем работы с объявлениями, то лучше ее совершать непосредственно вечером, так как в это время баллов будет начислено больше, по сравнению с утренним временем.
Списывание. Принцип списывания достаточно прост, если понять за что и сколько баллов будет списано. Вот основные:
- размещение объявления — 12 баллов;
- изменение объявления — 4 балла;
- применение ключевых фразы — 2 балла;
- редактирование ключ. фраз — 1 балл;
- добавление изображения — 2 балла;
По завершению баллов на аккаунте, все эти возможности будут ограничены и пока не зачислятся новые, вы ничего не сможете сделать. Таким образом система Яндекс Директа устраняет не приносящих доход пользователей, так как расценивает как нецелесообразное использование своих ресурсов.
Хотим обратить ваше внимание на то, что начисленные баллы не накапливаются. Неиспользованные баллы будут обнулены по завершению суточного дня, и с начала новых суток начнут зачисляться по новому. И опять же, увеличение лимита будет полностью зависеть от действий пользователя.
Основными причинами понижения ограничения являются: огромное количество объявлений не прошедших модерацию и добавление низкочастотных ключевых фраз, которые имеют очень маленькие показатели CTR.
Как правильно рассчитывать расход баллов на API Дирета
Для точного восстановления лимита баллов, нужно уделять особое внимание таким деталям как: качество объявлений и стратегии рекламной кампании. При должных настройках лимит будет вырастать.
Что нужно сделать, чтобы быстрее повысить лимит баллов:
1. Увеличить бюджет, и повысить ставки.
2. Повышать CTR объявлений с отличным качеством.
Таким образом, выгода будет приноситься как сервису Яндекс, так и самому рекламодателю.
Существует несколько хитростей, которыми можно воспользоваться, имея небольшое количество баллов.
- Сразу после создания аккаунта, создать рекламную кампанию только с 1 объявлением, которое имеет низкочастотный запрос. За него будет в обязательном порядке начислено много баллов, которые позже можно будет эксплуатировать для ведения основной рекламной кампании.
- Посредством Директ.Коммандером. В нем начисляется больше баллов, чем в интернет интерфейсе Директа.
- Имея большое количество рекламных кампаний на разных аккаунтах, суммарное число баллов с этих аккаунтов будет выше, чем держа все на 1 аккаунте.
Основной критерием начисления баллов API остается качественная реклама с высокими показателями эффективности, благодаря чему ограничений возможностей будет соответственно меньше.
kupiyandex.ru
Для чего нужны баллы в Яндекс.Директе
Контекстная рекламаУ некоторых рекламодателей иногда может возникнуть проблема, когда невозможно загрузить очередную рекламную кампанию, или исправить существующую. Причина в том, что у них не хватает баллов Директа — и из-за этого появляются нежелательные ограничения. Проблема эта не такая частая, однако все равно встречается, как правило, в молодых аккаунтах, а также в случае, если нужно делать очень большую загрузку. Разберемся чуть подробнее, почему это возникает.
Что такое баллы Яндекс.Директ
Яндекс ввел балльную систему для того, чтобы регулировать нагрузку на свой сервер API. Возможно, проблема бы решалась более мощным сервером, однако неизвестно, сколько бы он смог прожить, если бы все рекламодатели решили загрузить новые кампании.
Когда пользователь в Директе только регистрируется, то ему начисляется около 3200 баллов, чего вполне достаточно на начальном этапе, да и не только на начальном, но если аккаунт очень большой, и необходимо заливать десятки кампаний, то тут эти ограничения уже становятся заметными.
Если вы управляете Директом через Excel, то с проблемой нехватки баллов столкнетесь с большей вероятностью — у веб-интерфейса аппетиты гораздо выше, чем у Директ.Коммандера, поэтому при возможности стоит пользоваться вторым вариантом.
Количество доступных баллов в Директ.Коммандере можно посмотреть в левом верхнем углу:
Как начисляются и списываются баллы Яндекс.Директ
Баллы вам начисляются каждый сутки, как и всем остальным рекламодателям, однако у каждого своя норма, и она зависит от того, как работает реклама. Если ваша реклама собирает много кликов и, следовательно много приносит денег Яндексу, то баллов он вам отжалеет побольше.
Если же Директ работает неэффективно — показы есть, а кликов мало, то лимит, соответственно, будет снижен. Кроме этого, лимит может снижаться по следующим причинам:
- у ваших объявлений низкий CTR
- много объявлений не прошли модерацию
Как списываются баллы Яндекс.Директ
У всех действий, которые вы предпринимаете в Директе, есть своя цена:
- Публикация объявления – 12 баллов
- Корректировка объявления – 4 балла
- Использование ключевого слова – 2 балла
- Внесение изменений в ключевую фразу – 1 балл
- Использование изображения – 2 балла
Как оптимально расходовать баллы Яндекс.Директ
Из всего написанного выше следует, что баллов вам будет больше начисляться в случае, если вы не скупитесь на бюджет и ставки ваших объявлений высоки, а также объявления имеют высокие показатели качества и кликабельности. Иными словами, если благодаря вам Яндекс больше зарабатывает, вы получаете больше баллов — все просто.
Чтобы на начальном этапе получить больше баллов, можно разместить объявление с высоким показателем качества, но при этом чтобы у ключа была не высокая частотность. В этом случае количество выделенных вам баллов должно подрасти. Если же у вас много кампаний, то есть вариант разместить их в разных аккаунтах, и в сумме баллов у вас будет больше.
Но лучший вариант – это Директ.Коммандер, где лимиты значительно выше, нежели в веб-интерфейсе Директа.
medoed1.ru
Урок 2. Доступ к API: как зарегистрировать приложение на Яндекс.OAuth
В этом уроке вы узнаете:
- Что такое OAuth-авторизация и OAuth-токен
- Как зарегистрировать приложение на Яндекс.OAuth
- Что дальше
- Полезные ссылки
- Вопросы
В этом уроке мы расскажем о первом шаге получения доступа к API Директа для приложения — о регистрации приложения на Яндекс.OAuth. О втором шаге — подаче заявки на доступ — вы узнаете в следующем уроке.
В предыдущем уроке вы создали аккаунт в Директе, который будете использовать как разработчик приложений. Теперь необходимо зарегистрировать приложение на Яндекс.OAuth — вы можете сделать это, даже если само приложение еще не создано.
OAuth-авторизация — это механизм, который позволяет приложению работать с данными пользователя от его имени без необходимости использовать пароль от аккаунта.
В процессе авторизации используются OAuth-токены, которые представляют собой строку с зашифрованными данными:
идентификатор пользователя;
идентификатор приложения, которому разрешен доступ к данным пользователя на сервисе;
набор прав — действий, доступных приложению.
Ваше приложение для работы с API Директа должно быть зарегистрировано на сервисе Яндекс.OAuth. Тогда пользователь сможет разрешить приложению доступ к своим рекламным материалам, а приложение — получить OAuth-токен. Токен необходимо указывать в каждом запросе к API — так Директ узнает, с каким аккаунтом сейчас будет работать приложение, и проверит наличие прав на выполняемые действия.
Внимание.
Каждый токен уникален, поскольку выдается для связки «приложение + пользователь». Невозможно получить два одинаковых токена или получить более одного токена для одной и той же связки.
Если приложение не передало токен в запросе к API, то сервер не позволит получить или изменить какие-либо данные.
Войдите на Яндекс под своим логином разработчика. На сервисе Яндекс.OAuth откройте страницу Создание приложения и заполните основные поля. Все поля в дальнейшем будут доступны для редак
yandex.ru
Новости рекламных технологий Яндекса в Беларуси — API Яндекс.Директа: встречайте пятую версию
API Яндекс.Директа: встречайте пятую версию
Нашему программному интерфейсу пять лет. За это время он несколько раз сильно менялся, пока не дорос до «живой» версии 4 live в 2012 году. Наконец пришло время для запуска API 5 — новой версии с полностью перестроенной архитектурой, которая готова к появлению любых (даже самых неожиданных) настроек и форматов в Директе.
Первые методы API 5 появились в открытом доступе. Новая версия в разы удобнее и быстрее предыдущих. В течение года она будет работать в паре с привычным API 4 live — так что вы можете ускорять и оптимизировать рутинные операции, понемногу переключаясь на работу с API 5.
Сейчас в новом API можно управлять ставками и работать с рекламными материалами: создавать группы и объявления, добавлять ключевые слова, визитки, быстрые ссылки. По мере добавления методов мы поделимся с вами новостями.
Все свежие настройки и форматы Директа будут поддерживаться именно в пятой версии — её архитектура позволяет легко добавлять практически любую функциональность с поддержкой обратной совместимости.
О ключевых изменениях в API:
1. Отдельные веб-сервисы для операций с разными классами объектов. И у каждого — свой унифицированный набор методов. Такая архитектура позволяет работать только с нужными вам наборами данных, не выгружая все связанные с ними дополнительные параметры (к примеру, чтобы изменить регион показа для всех групп в кампании или добавить в список ключевых слов новую фразу не придется «возить» туда-обратно все данные кампании).
Большинство объектов — группу, визитку, быстрые ссылки и так далее — можно создать один раз и дальше использовать для всех объявлений, где они нужны.
Поддержка новых функций реализована без риска повредить уже отлаженной работе приложений: в API просто будут добавляться дополнительные веб-сервисы и наборы методов, которые вы сможете использовать, когда будете готовы.
2. Все объекты и ошибки подробно задокументированы. Чтобы элементы кампании было удобнее редактировать по отдельности, каждому из них теперь сразу присваивается свой Id.
По каждой операции вы получаете подробный отчет обо всех объектах внутри запроса, так что если один из них выдаст ошибку, вы точно будете знать, какой именно и что произошло. Остальные объекты внутри запроса не будут отклонены за ту же ошибку — вы получите отчет о том, что они успешно созданы или отредактированы.
Если в процессе работы с API что-то пойдет не так, сотрудникам службы поддержки будет достаточно идентификатора requestID, который вы получаете в ответе от сервера — в нём есть вся нужная информация.
3. Более прозрачная и гибкая система баллов. В API 5 баллы начисляются не раз в сутки, а равномерно в течение дня.
Баллы списываются за каждую операцию и в ответе от сервера к вам возвращается количество списанных и оставшихся баллов. Они рассчитываются и списываются точнее, поскольку для незначительных правок больше не приходится выгружать и загружать всю кампанию.
Мы упразднили почти все ограничения на количество запросов с одним и тем же методом, так что вы сами решаете, на какие операции вам важнее потратить баллы.
4. Универсальный язык методов. Принявшись за такие глобальные изменения в API, мы заодно поменяли названия методов, максимально приблизив их к международному обиходу. Так что специалистам, которые пишут приложения для разных рекламных систем, не придется держать в голове дополнительные термины. Banner превратился в Ad, Price — в Bid, Phrase — в Keyword и так далее.
У методов схожие названия, в которых легко разобраться. Например, VCards.add и Sitelinks.add для добавления элементов, а VCards.get и Sitelinks.get — для выгрузки данных о них.
5. И много других нововведений с учетом обратной связи от пользователей. Например, постраничная выборка данных и другие функции, о которых просили разработчики.
Более подробную информацию можно найти на странице API Директа. Изучайте API 5 в документации и на практике и делитесь с нами обратной связью. Мы будем благодарны вам за отзывы и предложения.
Версии 4 и 4 live будут закрыты в 2016 году. Мы предупредим вас об этом заранее. Но изучение новой версии лучше не откладывать на потом, поскольку интерфейс Директа стремительно пополняется новыми настройками, которые будут поддерживаться в API 5.
yandex.by
Руководство по API Яндекс.Директ | Блог YAGLA
API Яндекс.Директа – это интерфейс рекламной системы для разработчиков программ. Он позволяет автоматизировать работу с Яндекс.Директ и использовать все его функции – от получения статистики до создания рекламных кампаний с нуля. И всё абсолютно бесплатно.
Результат работы с API – ваше приложение по управлению контекстной рекламой в Яндекс.Директ с собственными настройками и алгоритмами. Кстати, для этого совсем не обязательно быть профи в программировании – достаточно базовых знаний PHP или Python.
Как всё это применять и что нужно, чтобы начать работу – смотрите в этой статье.
Для чего нужен API Яндекс.Директ
API Директа дает возможность разрабатывать и внедрять алгоритмы для управления рекламными кампаниями под ваши нужды. Это пригодится как агентствам, так и крупным рекламодателям, которые запускают и ведут масштабные кампании. Их деятельность предполагает множество рутинных действий, например:
- Массовое создание и редактирование кампаний, объявлений и ключевых фраз;
- Управление ставками;
- Получение статистики по показам и кликам;
- Прогноз бюджета.
Инструмент API позволяет создать приложение, в котором все нужные вам однотипные операции выполняются автоматически и в котором можно создавать удобные инструменты для просмотра и редактирования кампаний. Автоматизировать можно практически всё, даже обновление цены за клик по заданному вами алгоритму.
Вы разрабатываете что-то наподобие Директ Коммандера. Эта программа – готовое решение Яндекса на основе API Яндекс.Директа. Как её применять, смотрите руководство по старой и новой версиям.
Приложения, созданные по API Яндекс.Директа, рассчитаны на пользователей, у которых есть аккаунт в Директе. Это прямые рекламодатели, агентства и их клиенты с доступом только на чтение (могут только получать и просматривать данные) или на редактирование (они получают в API все те же самые функции, что в интерфейсе).
Структура API
По сути API Директа – это набор сервисов, каждый из которых привязан к конкретному классу объектов и имеет отдельный URL. Объекты API взаимосвязаны между собой, как показано на скриншоте:
Изображение из руководства Яндекса для разработчиков
Сервисы верхнего уровня – Campaign и AdGroup. Первый содержит настройки рекламной кампании, второй нужен для работы с группами объявлений.
На следующем уровне – сервисы Ad (параметры объявления), Keyword (ключевые фразы), Audience Target (условия нацеливания на аудиторию) и DynamicTextAdTarget (условия нацеливания для динамических объявлений).
Далее идут сервисы для работы с элементами объявления: AdImage (изображениями), VCard (виртуальной визиткой), SitelinksSet (блоком быстрых ссылок), AdExtension (расширением к объявлению).
Для управления условиями ретаргетинга и подбора аудитории есть специальный сервис – RetargetingList.
У каждого сервиса свой набор методов для выполнения операций с его объектами. Основные методы, которые доступны для всех объектов – это добавление (add), изменение параметров (update), удаление (delete) и получение параметров (get).
Есть также специфические методы, которые поддерживают определенные объекты. Например, отправление объявлений на модерацию (moderate) – метод для сервиса Ads. Весь список доступных методов по областям применения смотрите в документации API.
Итак, с чего начать, чтобы разработать собственное приложение для работы с контекстной рекламой в Яндекс.Директе? Во-первых, нужен доступ к API. Далее рассмотрим пошагово, как его получить.
Шаг 1: создание и регистрация приложения на Яндекс.OAuth
Авторизуйтесь в Яндекс.Директе. Используйте для этого аккаунт разработчика – именно от этого имени ваше приложение будет выполнять запросы и управлять данными.
Перейдите по ссылке oauth.yandex.ru. Нажмите кнопку «Зарегистрировать новое приложение»:
В правой части страницы – ссылки на справочные материалы для разработчиков.
Далее вы попадаете на форму «Создание приложения», где нужно указать все его необходимые параметры:
Обязательные опции помечены звездочкой, это «Название» и «Доступы». Но чем больше информации о приложении вы укажете, тем более прозрачно оно будет для пользователей. Они будут знать, какой именно программе разрешают доступ к своему аккаунту.
В блоке «Платформы» отметьте галочкой «Веб-сервисы»:
Появится поле адреса. В нем вы указываете, куда направлять пользователя после того, как он разрешил или отказал приложению в доступе. Адресов Callback URI может быть несколько, например, для тестового и боевого режима.
На этапе создания приложения нажмите ссылку «Подставить URL для разработки».
В поле появится тестовый адрес, который позволит получать отладочные токены вручную. Они нужны для проверки работы приложения, подробнее об этом далее в статье.
В блоке «Доступы» выберите «Яндекс.Директ» и отметьте «Использование API Яндекс.Директа»:
Завершите создание приложения:
На этом регистрация закончена. При этом OAuth-сервер Яндекса сразу же генерирует и показывает на странице идентификатор и пароль приложения.
Они понадобятся вам далее.
Шаг 2: создание заявки на доступ
В аккаунте Яндекс.Директа долистайте до нижнего меню и перейдите по ссылке «API»:
Далее нажмите «Получить доступ к API»:
Вы попадете на страницу настроек API. Чтобы она была доступна, нужно выполнить формальное требование: в интерфейсе Яндекс.Директа должна быть минимум одна рекламная кампания с одним объявлением и одной ключевой фразой.
При первом входе нужно принять пользовательское соглашение:
На странице «Настройки API» перейдите на вкладку «Мои заявки», чтобы создать и отправить заявку на доступ к API. Нажмите кнопку «Новая заявка» и выберите её тип.
Тестовый доступ – это ограниченный доступ к API, то есть только к Песочнице – тестовой среде для отладки приложений. Она имитирует работающие рекламные кампании, их достаточно для того, чтобы протестировать и отладить приложение. Полный доступ (боевой) дает возможность управлять реальными рекламными кампаниями клиентов.
Так как приложение еще не разработано, создайте заявку на тестовый доступ. Для этого:
1) Из выпадающего списка выберите идентификатор, который получили после регистрации приложения на OAuth-сервере:
2) Укажите email для связи со службой поддержки;
3) Заполните остальные данные о приложении по максимуму – укажите, для чего оно предназначено, его основные функции и возможности и т.д.:
4) Подтвердите согласие с пользовательским соглашением и отправьте заявку.
Статус заявки отслеживайте здесь же – на вкладке «Мои заявки» в настройках. Дождитесь её одобрения – это может занять до 7 дней. Только после этого можно начинать разрабатывать приложение. В случае отклонения – узнайте причины и исправьте ошибки.
На стадии рассмотрения можно преобразовывать заявку на ограниченный доступ в заявку на полный доступ. После внесения любых изменений она автоматически отправляется на повторное рассмотрение.
На вкладке «Мои приложения» можно увидеть, какие приложения уже имеют доступ к аккаунту Яндекс.Директ через API. В том числе, если вы использовали Директ.Коммандер, он появится в этом списке:
Шаг 3: создание тестового пользователя и тестовых данных для него
1) Зарегистрируйте аккаунт тестового пользователя в Яндекс.Директе;
2) Создайте от его имени рекламную кампанию в интерфейсе Яндекс.Директа – достаточно одного объявления с одним ключевиком, чтобы получить доступ к API;
3) В разделе API интерфейса Директа нажмите ссылку «Получить доступ к API» и примите пользовательское соглашение;
4) Включите песочницу – среду для отладки приложения, где можно управлять тестовыми кампаниями без реальных показов и внесения средств.
Для этого откройте вкладку «Песочница» на странице настроек API и начните ею пользоваться:
В следующем окне задайте параметры песочницы:
Поставьте галочку «Создать тестовые кампании». Если вы выбрали роль «Клиент» создаются три кампании. Для роли «Агентство» – 3 клиента с 3 кампаниями, их логины формируются автоматически. На одну кампанию каждого клиента зачисляется некоторая сумма.
Включение флажка «Общий счет» создает клиента с подключенным общим счетом. Для агентства опция недоступна.
Нажмите «Продолжить», чтобы начать управлять песочницей.
Внимание! Если сменить параметры, все данные удаляются. Нужно создавать песочницу заново.
5) От имени тестового пользователя получите отладочный токен. С помощью него можно проверять работу приложений.
Когда пользователь авторизуется в Яндекс.Директе и нажимает кнопку «Подтвердить», то есть дает доступ к своим данным приложения, сервер Яндекса генерирует токен и передает его приложению.
Как всё происходит:
- Приложение направляет пользователя на страницу Яндекс.OAuth;
- На этой странице пользователь разрешает доступ к своим данным приложению;
- Яндекс.OAuth перенаправляет пользователя на адрес, указанный в поле Callback URL. Код подтверждения или описание ошибки передается в параметре URL перенаправления;
- Приложение получает адрес перенаправления и извлекает код подтверждения;
- Приложение отправляет POST-запрос с этим кодом;
- Яндекс.OAuth возвращает токен в теле ответа.
Если объяснять с технической стороны, запрос к API выполняется по протоколу HTTPS методом POST (отправление данных). В этом запросе содержится HTTP-заголовок с токеном пользователя, от имени которого осуществляется запрос. Ответ содержит заголовок RequestId – это уникальный идентификатор запроса.
Некоторые приложения (например, консольные или установленные на телевизорах Smart TV) не могут получить код подтверждения из URL. В этом случае пользователь самостоятельно его получает от Яндекс.OAuth и вводит в приложении или на странице авторизации.
Полученный токен используется для запросов к API до истечения времени его жизни. Он должен быть доступен только вашему приложению, поэтому лучше не сохранять его в куках браузера.
Далее вы выполняйте запросы к песочнице. Вот пример запроса:
Практика использования API Яндекс.Директ
В инструменте API множество методов для разных объектов, многие из них дорабатываются и улучшаются со временем. Рассмотрим подробно, как их применять на практике.
Для примера возьмем создание отчета по поисковым запросам, прогноз бюджета и ретаргетинг. Этому действию соответствует метод CreateNewWordstatReport. Он запускает на сервере формирование отчета о статистике поисковых запросов. Это занимает не больше минуты.
Отчет содержит ту же статистику, которая доступна в сервисе Яндекс Wordstat за прошедший месяц.
Ограничения:
- За сутки можно получить статистику для тысячи фраз;
- На сервере хранится максимум 5 отчетов по всем кампаниям;
- Отчеты хранятся на сервере в течение 5 часов, а затем автоматически удаляются.
Так выглядит структура входных данных в формате JSON:
{
«method»: «CreateNewWordstatReport»,
«param»: {
/* NewWordstatReportInfo */
«Phrases«: [
(string)
…
],
«GeoID«: [
(int)
…
]
}
}
Phrases – это массив ключевых фраз, по которым нужно получить статистику поисковых запросов (добавить можно не более 10). минус-фразы из нескольких слов пишите в скобках, например: холодильник -морозильник -(морозильная камера) -ремонт.
GeoID – идентификаторы регионов, по которым нужно получить статистику поисковых запросов. Можно исключить регион, поставив минус. Если вы не указали этот параметр, либо указали только минус-регионы, либо минус-регионы совпадают c плюс-регионами, статистика выдается по всем регионам.
Вообще в API Яндекс.Директа можно решать самые разнообразные задачи, например:
— Интегрировать функции Яндекс.Директ и данные из собственной базы.
Примеры применения: автоматическое добавление в ключевые фразы названий брендов или моделей товаров, остановка / возобновление показов объявлений в зависимости от наличия товаров на складе, обновление текстов объявлений при изменении прайс-листа. И многое другое, в зависимости от данных, которые у вас есть;
— A/B-тестирование объявлений.
Принцип тот же, что в интерфейсе: в самом начале все варианты из группы объявлений показываются равномерно. По мере накопления статистики система выбирает объявление с самым высоким CTR (самое привлекательное по мнению целевой аудитории) и показывает его чаще;
— Мониторинг и анализ эффективности рекламных кампаний.
Можно настроить автоматическое получение сводной и детальной статистики по показам, кликам, конверсиям и другим показателям и выгрузку её в сторонние программы (системы поддержки принятия решений, системы финансового учета и т.д.)
Все примеры использования API смотрите в меню «Практика использования» по ссылке.
Важное преимущество программы на основе API – при просмотре и редактировании кампаний, рекламных групп, объявлений и ключевых фраз не нужно ждать загрузки страниц, как в интерфейсе Яндекс.Директа. И конечно, это экономит время специалистов по настройке контекстной рекламы.
yagla.ru