Представлена новая версия API Яндекс.Директ


Оглавление (нажмите, чтобы открыть):

API Яндекс.Директа обновился до 5 версии

Команда Яндекс.Директа объявила о выпуске нового программного интерфейса – API 5. В нем появились отдельные веб-сервисы, предназначенные для операций с разными классами объектов. Это позволяет работать только с теми наборами данных, которые необходимы в данный момент, без выгрузки дополнительных параметров.

Среди других отличительных преимуществ API 5:

  • более подробная документация объектов и ошибок (с получением Id каждого объекта и отчета обо всех объектах внутри запроса);
  • отсутствие суточных ограничений на число запросов с одним и тем же методом (возможность самостоятельно решить, на какие операции потратить баллы);
  • равномерное начисление баллов (в течение дня);
  • просмотр потраченных за операцию баллов и оставшееся их количество;
  • переименованные методы для простоты ориентации в них (к примеру, Banner называется Ad, Phrase — Keyword).

На данный момент в обновленном интерфейсе можно:

  • управлять ставками и работать с рекламными материалами;
  • создавать группы и объявления;
  • добавлять ключевые слова, визитки и быстрые ссылки.

В течение текущего года новый API будет служить в качестве надстройки к API 4 live. Это позволит постепенно привыкнуть к новому интерфейсу. В 2020 году версии 4 и 4 live будут закрыты.

Команда Яндекс.Директа советует уже сейчас приступить к изучению новой версии интерфейса, так как поддержка всех свежих настроек и форматов будет осуществляться в API 5.

Выгрузка данных из API Яндекс Директ через Python

В статье расскажем как выгрузить данные из API Яндекс Директ в CSV-таблицу с помощью Python.

Материал довольно сложный, очень рекомендуем просмотреть видео, чтобы допустить меньше ошибок.

Была необходимость проанализировать большой объем данных. Столкнулись со следующими проблемами:

  • 30 млн. строк за год
  • Веб-интерфейс показывает только 100 тыс. строк
  • Не нашли подходящего коннектора для Power BI
  • Подключение Power BI к Big Query занимает больше времени

Предложенное решение не является единственным или оптимальным. Мы не разработчики, нам просто нужно было решить задачу быстро. Делимся способом с вами.

Подготовка

В данной статье мы не будем знакомить вас с синтаксисом и возможностями Python – это полноценный язык программирования, изучить основы которого можно по видеоурокам или на ресурсах типа CodeAcedemy.

Яндекс сам дает готовый пример кода, которым можно выгрузить отчет, остается указать некоторые параметры. Мы доработали скрипт таким образом, чтобы большой объем данных можно было выгрузить помесячно и склеить в один файл для дальнейшего анализа.

  • скачать PyCharm – среда разработки Python
  • зарегистрировать приложение для доступа к API (инструкция) – необязательный шаг
  • получить токен для доступа к API – выводится в браузере, после разрешения доступа к Директу по ссылке вида: «oauth.yandex.ru/authorize?response_type=code&client_ > Мы с вами построим обычный отчет, аналогичный «Мастеру отчетов» в интерфейсе Яндекс Директ, но с помощью кода и сторонней программы. Нужно определиться с полями и показателями, которые будем выгружать. Важно знать, что некоторые из полей несовместимы между собой, то есть в одном отчете их не выгрузить. Подробное описание всех полей и их совместимости находится в справке Яндекс. Там же находится информация о типах отчетов, которые можно выгрузить, рекомендуем ознакомиться.

В приложенном коде мы постарались сделать максимально широкий набор полей, подходящий для анализа почти любых срезов. Подробно описали поля в видео, тут затронем только самые важные. Открываем файл «loader.py» и приступаем к его настройке.

Выгрузка данных пошагово

Укажите путь к папке, в которой находится скачанный код, туда же загрузятся данные из API.

Замените авторизационный токен и логин для входа в Директ на ваши:

Укажите начальную дату выгрузки:

Далее вы увидите список полей отчета. В первой строке указан период, для которого данные будут суммироваться, в рамках данной задачи – это месяц. Большинство остальных полей понятны по названию, более подробно затрагиваем их в видео.

Пропишите идентификатор цели, без него данные могут не выгрузиться. Найти его можно в Яндекс Метрике:

Параметр «Limit» задает максимальное количество строк на странице. По умолчанию это значение равно 1млн. строк. Мы увеличили это значение, чтобы ускорить выгрузку. Объяснять как это работает тут не будем, чтобы не усложнять.

Тип отчета, в нашем случае CUSTOM_REPORT=Пользовательский отчет. Если вы меняли поля, возможно, вам нужен другой тип, подробнее смотрите в справке.

На этом настройка завершена, можно переходить к выгрузке. Для этого щелкните правой кнопкой мыши на файл «loader.py» и выберите команду «Run».

Обработка полученных данных

После окончания загрузки данных в левой панели навигации вы увидите несколько csv-таблиц, с датами в названии. Каждый файл содержит данные за месяц. Если есть файлы с выгрузкой за неполный месяц, удаляем их. В нашем примере останутся 2 файла:

Все таблицы мы будем «склеивать» в один документ, поэтому нужно их подготовить. Каждая из таблиц содержит названия отчета и заголовки столбцов вверху и итоговые значения внизу, это вызовет ошибку. Нужно оставить заголовки столбцов только в самой ранней таблице, а в остальных удалить. Итоговые значения и нужно удалить из всех таблиц. Скорее всего, Excel не потянет такой объем, поэтому быстрее будет открыть в текстовом редакторе, в нашем примере «Sublime Text».

Открываем за самый ранний период и удаляем первую строку с его названием:

Аналогично удаляем и последнюю строку документа с итоговым количеством строк:

В остальных файлах удаляем название отчета, заголовки столбцов и итоговую строку в конце:

Теперь осталось склеить файлы в один. Это делается через терминал. Команда для Windows и macOS будет отличаться. На Windows для каждого из файлов нужно выполнить команду:

На этом все, мы получили файл, который можно подключить к Power BI и визуализировать данные. Как это сделать расскажем в следующей статье.

Подпишитесь на Facebook или Телеграмм, чтобы не пропустить новые статьи

Разделяешь наш подход? Вступай в команду!

API Яндекс.Директ: руководство по применению

API Яндекс.Директа это интерфейс рекламной системы для программирования контекстной рекламы. С помощью данного сервиса можно довести работу с Яндекс.Директом до автоматизма, а также совершенно бесплатно воспользоваться всеми функциями этого сервиса – от создания рекламы с нуля до получения статистических данных. Теперь это возможно не только для профессионалов, но и для тех, кто владеет только базовыми знаниями Python и PHP.

Функции API Яндекс.Директ


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

Такой инструмент, как API позволит сгенерировать приложение для автоматического выполнения всех нужных вам рутинных операций. Также в нём будет возможность создавать удобные инструменты для рекламных кампаний. Автоматизировать получится почти всё, вплоть до обновления цены за один клик по выбранному вами алгоритму.

Созданные с помощью API Яндекс-сервиса программы рассчитаны на тех пользователей, у которых уже есть аккаунт в сервисе: рекламодателей, рекламные агентства и их клиентов, которым открыт только доступ для просмотра. Тем клиентам, которым открыт доступ к редактированию материала, в API доступны такие же функции, как и в интерфейсе.

Структура API

Фактически, API Яндекс.Директа является набором сервисов. Каждый из них имеет свой URL и привязан к определённому классу объектов. API-объекты связаны между собой таким образом:

К верхнему уровню относятся сервисы AdGroup и Campaign. AdGroup необходим для работы с группами объявлений, а в сервисе Campaign содержатся настройки для рекламных кампаний.

Сервисы следующего уровня помогут работать с элементами рекламных объявлений.

Также имеется специальный сервис для подбора рекламной аудитории – RetargetingList.
Для начала работы с контекстной рекламой в Яндекс.Директе необходим доступ к API. Рассмотрим алгоритм его получения.

Шаг 1. Создание и регистрация приложения на Яндекс.OAuth

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

Пройдя по ссылке oauth.yandex.ru, кликните «Зарегистрировать новое приложение».

Вы попадаете в раздел «Создание приложения». В предложенной форме укажите необходимые вам параметры.

Обязательные для заполнения поля помечены звёздочкой. Однако максимальный объём информации о приложении сделает его более прозрачным для будущих клиентов.

В блоке «Платформы» необходимо выбрать графу «Веб-сервисы».

Введите в появившееся поле адрес, по которому будет направлен пользователь в случае, если он принял приложение или отказал ему в доступе. Вы можете указать несколько адресов.

При создании приложения нажмите «Подставить URL для разработки».

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

В блоке «Доступы» вам нужно выбрать «Яндекс.Директ» и отметить «Использование API Яндекс.Директа».

Завершается создание программы кликом на соответствующую кнопку:

Регистрация окончена. Сервер Яндекса тут же сгенерирует и покажет ID приложения и пароль для входа в него.

Шаг 2. Создание заявки для доступа

В нижнем меню аккаунта сервиса перейдите по ссылке «API».

Затем необходимо нажать «Получить доступ к API».

Потребуется принять пользовательское соглашение.

На странице «Настройки API» для того, чтобы создать и отправить заявку на доступ в API нужно будет перейти в раздел «Мои заявки», затем нажать «Новая заявка» и выбрать её тип.

Так как ваше приложение ещё разработано, нужно создать заявку на тестовый доступ. Вы получите возможность сымитировать работу настоящей рекламной кампании, чтобы опробовать и наладить приложение. Для этого нужно сделать следующее:

1. из предоставленного списка выбрать полученный вами при регистрации приложения идентификатор;

2. указать адрес электронной почты для связи со техподдержкой;
3. заполнить дополнительные данные о программе с указанием его предназначения, основных функций и возможностей;

4. подтвердить вашу заявку Пользовательским соглашением и отправить её.

Требуется дождаться одобрения заявки, что может занять до 7 дней. В случае отказа нужно узнать её причины и исправить недостатки. Отслеживать статус заявки можно в разделе «Мои заявки».

Во вкладке «Мои приложения» вы увидите, какие программы уже имеют доступ к аккаунту через API.

Шаг 3. Создание тестового пользователя и данных для него

1. Регистрируете тестовый аккаунт в Яндекс.Директе
2. Создаёте тестовую рекламную кампанию – достаточно всего одного объявления с одним ключевиком.
3. В Директе, в разделе API нажимаете «Получить доступ к API».
4. Включаете так называемую песочницу – среду для наладки программы, в которой вы можете управлять тестовой кампанией.

5. В качестве тестового пользователя получаете токен для отладки.

В полной версии API Яндекс.Директа начал работу API KeywordBids

Новости Яндекса: запущена открытая бета-версия KeywordBids в полной версии API Директа.

Яндекс активно меняет механизм торгов и назначения ставок в сервисе Директ.

В рамках весенней революции обновления Яндекса сервис Директ стремительно меняется, наращивая свой функционал. В компании Яндекс сообщили в пресс-релизе о начале работы открытой бета-версии API KeywordBids. Сообщается о том, что для разработчиков открыт доступ для предварительного тестирования своих приложений.

Сервис KeywordBids разработан командой Яндекса специально для работы в API Директа по новым правилам ведения торгов. В начале 2020 года Яндекс начал проводить масштабные работы по оптимизации своих рекламных сервисов. В Яндекс.Директ запланированы кардинальные перемены в механизме торгов. Соответственно, изменится и интерфейс назначения ставок. Сообщается, что эти изменения вступят в силу уже в двадцатых числах апреля. Поэтому в Яндекс решили заранее запустить бета-версию сервиса API KeywordBids для полной версии API Я.Директ, чтобы разработчики смогли заранее подготовиться к работе с новым интерфейсом назначения ставок.

Мы уже сообщали, что в начале апреля Яндекс отключил функцию «Показывать на поиске только под результатами» в рамках оптимизации работы сервиса контекстной рекламы Яндекс.Директ.

Постепенно Яндекс избавляется от устаревающих и уже неактуальных методов расчета цен за рекламные позиции. Каким станет новый Директ? Следите за нашими новостями.

Яндекс представил новый API Директа

Компания Яндекс объявила о запуске новой версии программного интерфейса (API) Директа. Архитектура API 5 позволит поддерживать любые форматы и настройки, которые будут появляться в Директе, заявляют в компании.


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

«Все свежие настройки и форматы Директа будут поддерживаться именно в пятой версии — ее архитектура позволяет легко добавлять практически любую функциональность с поддержкой обратной совместимости», — отмечается в блоге рекламных технологий Яндекса.

Главные отличия нового API:

Архитектура: для операций с каждым классом объектов используется отдельный веб-сервис со своим набором методов. Таким образом, API 5 позволяет работать только с теми данными, которые необходимы для конкретной операции. А подключение новых функций Директа не сможет нарушить работу уже существующих приложений, поскольку в API просто будут появляться дополнительные веб-сервисы.

Подробные отчеты об ошибках. Каждому элементу кампании присваивается уникальный ID, а по каждой операции создается подробный отчет. В отчете содержатся данные обо всех объектах внутри запроса, в том числе об отклоненных по причине той или иной ошибки.

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

Унифицированные названия методов. Чтобы упростить работу специалистов, создающих приложения, названия методов «максимально приближены» к терминам, использующимся в других сервисах контекстной рекламы.

Как сообщают представители Яндекса, поддержка предыдущих версий API Директа (4 и 4 live) будет прекращена в 2020 году.

Новые сервисы пятой версии API Яндекс.Директа

Пятая версия API Яндекс.Директа пополнилась новыми сервисами: управление условиями подбора аудитории будет выполнять сервис RetargetingLists, управлять условиями нацеливания на аудиторию — сервис AudienceTargets. Подробное описание новинок приведено в документации.

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

Условие подбора аудитории — это критерии отбора пользователей, применяемые как при формировании условий нацеливания на аудиторию, так и при выполнении корректировки ставок. Для настройки этого условия задействуются цели и сегменты Яндекс.Метрики и сегменты из Яндекс.Аудиторий.

Новинку следует рассматривать в связке с такими нововведениями последнего времени, как:

· сервис Яндекс.Аудитории, запущено в июне текущего года, предназначен для связи офлайновых онлайновых данных;

· новые сегменты для таргетинга рекламных сообщений в Яндекс.Метрике, появились в сентябре, настраиваются при помощи Яндекс.Аудиторий и выполняют функцию нацеливания рекламы на посетителей сайта и пользователей приложения (помимо клиентов, взаимодействовавших с рекламодателей в офлайне).

Оптимизатор ставок K50 и API Яндекс.Директ с примерами

Здравствуйте, уважаемые читатели сайта Uspei.com. С помощью методов API Яндекс.Директа внешние приложения могут вносить изменения в рекламные кампании — например, автоматизировать рутинные и массовые операции,управлять большими аккаунтами и кампаниями со сложной структурой.

При этом пользователь не передаёт системе автоматизации логин и пароль к аккаунту, а значит, может прекратить её работу в любой момент.

Платформа К50 работает с API Директа и даёт возможность автоматизировать практически все этапы работы с контекстной рекламой от генерации рекламных кампаний до анализа статистики.

Агентствам К50 помогает выполнить KPI клиента и сократить трудозатраты на ведение кампаний, клиентам — наращивать прибыль, достигать нужных показателей и формировать отчётность.

В этом материале К50 делится несколькими примерами решения разных задач с помощью API Директа:

  1. Создание рекламных кампаний и их обновление.
  2. Выгрузка данных для анализа.
  3. Управление ставками и другими рекламными материалами.

К оглавлению ↑

Создание рекламных кампаний и обновление через API для Торгового дома «Нептун»

Для дистрибьютора крупных брендов сантехники Торговый дом «Нептун» и рекламного агентства MediaGuru платформа К50 решала две задачи:

  • Генерация рекламных кампаний на несколько регионов.
  • Регулярное обновление кампаний и поддержание актуальности объявлений.

В кейсе рассматривается один из монобрендовых магазинов дистрибьютора — https://grohe.msk.ru/. Для создания кампаний используется фид, который содержит всю информацию о товарах сайта — ссылку на товар, цену, категорию, бренд, модель и другие.

В тематике «Сантехника» хорошие результаты показывают товарные объявления с низкочастотной семантикой, состоящей из запросов с артикулами. Ассортимент магазина включает несколько тысяч позиций, поэтому создание объявлений вручную для каждого товара — задача трудозатратная, а поддержание актуальности наличия — без автоматизации задача практически невозможная.

Для решения был выбран сервис «К50:Генератор». Сервисы генерации умеют создавать сразу много кампаний, объявлений или ключей по шаблонам, а через API отправлять их на изменение.

API Директа открывает множество возможностей для автоматической генерации и обновления кампаний. Для управления кампаниями используется сервис Campaigns. Создание кампаний происходит через метод add.

С помощью метода add отправляем параметры новой кампании: названия, настройки, бюджеты и другие. После того как мы собрали запрос, например, в формате json:

…отправляем запрос и получаем ответ вида:

AddResults — это массив с результатами по каждой кампании, которую мы хотели создать. В этом массиве есть ID созданной кампании и предупреждения с ошибками, если такие были.

Также, как методом add, пользуемся методами update, suspend, delete, getи прочими. К каждому методу есть обязательные и дополнительные параметры, ограничения и ответ с результатами. Подробности по каждому методу можно найти в документации APIДиректа.

Вот пример автоматически сгенерированных объявлений в нашем кейсе:

Доля рекламных расходов (ДРР) по кампаниям, созданным через «К50:Генератор» — 14% (без учёта оборота со звонков).

Busfor.ru: скачивание и сопоставление данных для анализа

Тематика рекламодателя Busfor.ru — междугородние автобусные перевозки, а это огромное количество ключевых слов и объявлений, которые часто меняются. Аккаунт в Директе у Busfor.ru состоит более чем из 100 000 активных фраз, по которым были показы за 30 дней, и более 200 рекламных кампаний.

С помощью системы статистики К50 можно получать готовые отчёты об эффективности без ручной работы. Достаточно один раз подключить необходимые системы в веб-интерфейсе, и далее статистика за необходимый период будет доступна для анализа в любой момент.

Внешняя статистика для анализа рекламных кампаний — это:

    1. Сопоставлениев одном окне данных из нескольких источников — Директа, системы аналитики, отслеживания звонков и CRM.
    2. Возможность гибкой фильтрации всех измерений и метрик.
    3. Удобное сравнение периодов:
    4. Возможность выгрузки готовых сводных отчётовв CSV.

Как скачать статистику в К50:

  1. Синхронизируем списки кампаний. По каждой кампании сохраняем TIMESTAMP с датой его последнего обновления, чтобы в дальнейшем использовать API-метод changes.
  2. Скачиваем списки групп объявлений, объявлений, ключевых слов. При большом объёме данных приходится разбивать их на порции даже при скачивании из одной кампании. После этого в системе есть актуальная копия рекламных кампаний, но нет статистики.
  3. Скачиваем статистику. Указываем период, за который клиенту нужны данные. По каждой кампании проверяем их наличие, и, если что-то не скачалось, ставим задачу в очередь на выполнение. Для оптимизации выгрузка разбивается на последовательные интервалы длиной не более двух недель.
  4. Обновляем историческую статистику. Статистика в Директе за прошлые периоды может меняться — это связано с работой внутренних систем антискликивания. Спомощью методов changes делаем запрос на изменения и повторно выкачиваем статистику по тем кампаниям/датам, где они были.

К оглавлению ↑

Управление ставками: два кейса К50 для клиентов агентства Mello

Управление ставками — задача, с которой клиенты приходят в системы автоматизации чаще всего. Тут есть три категории запроса:

  1. Управление ставками по заданной клиентом логике. Мы в К50 называем такой метод управления «по правилам». Клиент задаёт, при каких условиях увеличивать или уменьшать ставки, на сколько и как часто. Автоматические правила решают множество рутинных задач: управление ставками, остановка/запуск рекламных материалов, формирование автоматических отчётов и так далее. Кроме того, в настройке правил можно использовать сразу несколько источников данных, например, Директ и Метрику.
  2. Оптимизация по стратегиям. Клиент устанавливает KPI, а стратегия пытается достичь данного показателя, управляя ставками.
  3. Биддинг по доле охвата — когда клиент хочет получать определённую долю трафика по данному ключевому слову и занимать определённое место в рекламной выдаче. В большинстве случаев такой подход неэффективен, поскольку не учитывает реальную эффективность фраз. Этот метод целесообразно использовать для брендовых запросов и для запросов, имеющих высокий приоритет для клиента, например, по конкурентам или топовым товарам.
Кейс 1

Клиент партнёрского агентства Mello — сеть квестов в реальности iLocked. Агентству нужно было снизить цену за заявку в Директе для отделения в Ростове-на-Дону.

Для этого были созданы правила, которые управляют ставками в зависимости от накопленной статистики, разные для кампаний на поиске и в сетях.

К50 позволяет задать любой интервал применения правил от раза в час до раза в год. В нашем кейсе правила применялись один раз в день. Ставки назначались с учётом данных из Директа и системы аналитики за 90 дней, без учёта текущего дня.

Условие правила — минимум 300 кликов на разных уровнях (объявления, кампании, аккаунт) за последние 90 дней.

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

В разделе «Настраиваемые метрики» создали целевые метрики для оценки эффективности:

CRв Яндекс.Директе = (Достижение Цели-1 + Достижение Цели-2) / Клики в Яндекс.Директ

CPLв Яндекс.Директе = Расходы в Яндекс.Директ / (Достижение Цели-1 + Достижение Цели-2)

Формула для расчёта ставки учитывает CPL (стоимость лида), количество лидов, кликов и CR за 90 дней. Таким образом, можно выставить эффективную ставку для каждого ключа в зависимости от его показателя СPL.

Если же конверсии за 90 дней отсутствуют, то на ключи, где было мало кликов, ставка будет выставлена выше, чем у ключей, где статистики накоплено больше.

За период с 11.05.2020 по 03.07.2020 для Директа стоимость конверсии снизилась почти на 40%, расходы — почти на 56%. Хотя заказы также сократились (на 27%), учитывая выраженную сезонность бизнеса (в летние месяцы количество заявок резко снижается), результат оптимизации можно считать успешным.

Кейс 2

Другой клиент Mello Кабель.рф — компания, которая занимается продажей кабеля. В качестве KPI выбрали цену заявки и рост их числа.

Здесь нужно было выстроить управление, учитывая качество оставленной заявки. Оно оценивалось на стороне клиента и в зависимости от ценности заявки отправлялось из CRM клиента в отдельную цель системы аналитики.

Заявки были разделены на 5 категорий:

Для удобства управления все заявки, кроме Spam, превратили в одну настраиваемую метрику, названную «Leads размеченные». Посколькуне все заявки для нас одинаково полезны, то с помощью коэффициентов мы уравнялицели между собой.

Leads размеченные = 0,3*Достижения цели «LEADS: poor» + 0.7*Достижения цели «LEADS: fair» + Достижения цели «LEADS: good» + 1,5*Достижения цели «LEADS: excellent»

CPL= Расходы/ Leads размеченные

Допустим, наша целевая стоимость заявки = 1000. Но за низкокачественную заявку мы хотим платить меньше. В формуле метрики учтён вес каждой цели. Цель «Leads: poor» имеет наименьший приоритет, поэтому за неё мы готовы заплатить максимум 300 рублей. Это отражено в нашей формуле в качестве коэффициента 0,3.

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

Хотя для пользователя разные сценарии управления ставками выглядят по-разному, по API они все используют один и тот же сервис — Bids.

Нюансы работы с API

Главное ограничение — баллы API, за количеством которых нужно следить. На аккаунт даётся определённое количество баллов в сутки, в зависимостиот активности рекламных кампаний. Каждый запрос тратит некоторое количество баллов.

Разрабатывая логику запросов, стоит учесть несколько моментов:

  1. Не допускать ошибок в запросах, проверять все параметры перед отправкой.
  2. Не делать слишком много запросов. Например, получение 10 кампаний через 10 отдельных запросов.
  3. В то же время не делать слишком больших запросов. Это существенно сократит время выполнения и обработки запросов.
  4. В пятой версии API списываются дополнительные баллы за превышение числа параллельных запросов. То есть нельзя одновременно выполнять более 5 запросов к API. Это следует учитывать при организации параллельного скачивания данных.

К оглавлению ↑

Нетривиальные задачи: роботы + человек

Базовый функционал К50 подходит клиентам, которые работают с несколькими рекламными системами и одной системой аналитики. Для менее типичных задач уже нужны кастомные разработки.

Допустим, у клиента три разных CRM-системы: заявки в одной, заказы в другой, а ID для связывания этих данных — в третьей. Делать поддержки этих систем и таких кейсов в основном коде слишком накладно и рискованно.

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

Павел Мрыкин, РА MediaGuru: «Возможность свести данные из рекламных площадок, систем аналитики, коллтрекинга и CRM экономит много времени и при ежедневном мониторинге, и при всестороннем анализе рекламных кампаний.

На основании этих данных мы настраиваем правила и стратегии, которые помогают решать разные задачи наших клиентов от назначения ставок до массового изменения текстов объявлений».

Системы автоматизации помогают не только грамотно распределить бюджеты клиентов, но и экономить время на рутинных операциях по управлению рекламными кампаниями.


Илья Кузьмин (iProspect): «Как правило, при подключении системы автоматизации практически сразу можно наблюдать снижение CPO при сохранении количества транзакций».

Иван Барченков (РА МедиаНация): «Использование автоматизации освобождает нас от рутинных задач: генерации объявлений, управления ставками, проверки страниц на наличие ошибок, анализа данных, сопоставления данных между системами аналитики и Яндекс.Директом».

Но несмотря на доказанную эффективность и полезность, система автоматизации не станет полной альтернативой специалисту по контекстной рекламе, это лишь один из инструментов в его работе.

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

До встречи! Успевайте всё и всегда на страницах блога Uspei.com

Помоги проекту — подпишись на наш Яндекс.Дзен канал!

Обзор обновлённого интерфейса Яндекс.Директ

Как «Google», так и, в свою очередь, «Яндекс» прекрасно понимают, чтобы «завоевать» интернет-пользователя, недостаточно быть только знаменитым и предлагать массу разнообразных сервисов для упрощения рутинных задач («Навигатор», «Карты», «Аудитории» и т. д.), решений размещения рекламы и других целей. Надо выше предоставленные сервисы постоянно модернизировать и производить улучшения с целью более высокой эффективности и отдачи от них. Как это можно сделать? Улучшение быстродействия и логики машинных алгоритмов обучения, процедуры регистрации, обновления интерфейса, улучшения юзабилити и других параметров.

Если мировая система поиска «Google» решила пойти на крайние, но оправданные меры (свести подавляющее большинство сервисов к практически единому интерфейсу (очень практично, так как их достаточно много)), то «Yandex» предпочел производить доработку своего инструментария постепенно, внедряя удобные «фишки» и улучшая понимание интернет-пользователя коммуникационных связей с минимальным количеством шагов и оптимальным отображением только тех элементов, которые всегда необходимы.

Не «уберегся» от нововведений и «Яндекс Директ» — площадка для осуществления возможности в поисковой системе размещения контекстной рекламы, как на поиске, так и на веб-сайтах партнеров IT-гиганта.

Рассмотрим введенные изменения более детально.

Что нового появилось в «Яндекс Директе»

Инновации касаются следующих изменений отображения отслеживания и управления:

обновленный первый экран раздела «Мои кампании», который выглядит следующим образом:

Для многих интерфейс может показаться изначально непривычным. Со временем можно ощутить все преимущества нововведения, так как появился возможность фильтрации кампаний по различным параметрам – конверсия, количество израсходованных средств, тип кампании, наличие счетчика «Метрики», а также статус

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

новая навигация в Директе. Здесь тоже произошли довольно существенные обновления, которые можно увидеть на нижеследующем скриншоте.

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

Более проработанная структура, позволяющая только наглядно наблюдать за кампанией, но и оперативно производить изменения, как групп и объявлений, так и самим кампаниям непосредственно. Очень удобно интерфейс выглядит при редактировании креативов.

Новое отображение, вернее появление нового инструмента под названием «Подбор фраз». Переработанная структура отображения, наглядно представленная ниже, гораздо удобнее по сравнению с прошлым вариантом.

Что еще нового появилось в «Яндекс Директе» и когда обновления выйдут в свет

Отметим, что кроме полной переработки некоторых «перемудренных» элементов и страниц личного кабинета, разработчики постарались (и у них это получилось) поработать над скоростью прогрузки веб-страниц и загрузки данных, что в особенности положительно скажется на тех аккаунтах, которые содержат много кампаний и групп объявлений.

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

Веб-разработчики настоятельно рекомендуют присоединяться к тесту, так как им важно знать мнение пользователей. Также это выгодно для всех. Владельцы кабинетов ощутят все удобства проработанного юзабилити, разработчики – проделают максимальную оптимизацию, способную снизить нагрузку на систему в целом.

Чтобы написать о своих пожеланиях, или каких-либо обнаруженных ошибках в новом интерфейсе, следует нажать на специальную кнопку в виде иконки с многоточием, находящуюся в правом верхнем углу рядом с уведомлениями («колокольчиком»)

Заключение

Из всего вышесказанного следует очевидный вывод – после запуска многообразных приложений, выполняющих различные функции («Аудитории», «Директ», «Радио», «Почта», «Карты», «Справочник» и т. д.), «Яндекс» стал заниматься их проработкой, как по скорости взаимодействия с пользователями, так и со стороны юзабилити. Безусловно, шаг естественный, вполне разумный и правильный.

О том, как поменяется удобство использования личного кабинета «Яндекс Директа» (в лучшую или худшую сторону), можно будет сказать только после окончательного выхода доработки продукта в глобальную сеть. На данный момент, интернет-пользователи, проходящие стадию бета-теста «Yandex Direct» отмечают положительный потенциал и реальное изменение удобства использования инструмента в лучшую сторону.

В полной версии API Яндекс.Директа начал работу API KeywordBids

Новости Яндекса: запущена открытая бета-версия KeywordBids в полной версии API Директа.

Яндекс активно меняет механизм торгов и назначения ставок в сервисе Директ.

В рамках весенней революции обновления Яндекса сервис Директ стремительно меняется, наращивая свой функционал. В компании Яндекс сообщили в пресс-релизе о начале работы открытой бета-версии API KeywordBids. Сообщается о том, что для разработчиков открыт доступ для предварительного тестирования своих приложений.

Сервис KeywordBids разработан командой Яндекса специально для работы в API Директа по новым правилам ведения торгов. В начале 2020 года Яндекс начал проводить масштабные работы по оптимизации своих рекламных сервисов. В Яндекс.Директ запланированы кардинальные перемены в механизме торгов. Соответственно, изменится и интерфейс назначения ставок. Сообщается, что эти изменения вступят в силу уже в двадцатых числах апреля. Поэтому в Яндекс решили заранее запустить бета-версию сервиса API KeywordBids для полной версии API Я.Директ, чтобы разработчики смогли заранее подготовиться к работе с новым интерфейсом назначения ставок.

Мы уже сообщали, что в начале апреля Яндекс отключил функцию «Показывать на поиске только под результатами» в рамках оптимизации работы сервиса контекстной рекламы Яндекс.Директ.

Постепенно Яндекс избавляется от устаревающих и уже неактуальных методов расчета цен за рекламные позиции. Каким станет новый Директ? Следите за нашими новостями.

Яндекс.Директ запустил новую версию API

Команда API Яндекс.Директа сообщила о появлении в открытом доступе первых методов API 5 — нового программного интерфейса Директа с полностью перестроенной архитектурой.

Среди ключевых особенностей API 5, можно назвать наличие отдельных веб-сервисов для операций с разными классами объектов, у каждого из которых есть свой унифицированный набор методов. Такая архитектура позволяет работать только с нужными наборами данных, не выгружая все связанные с ними дополнительные параметры, и легко встраивать новые функции с поддержкой обратной совместимости.

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

В API 5 меньше ограничений и более гибкая система баллов. Были упразднены почти все суточные ограничения на количество запросов с одним и тем же методом, так что теперь только каждый сам может решить, на какие операции важнее потратить баллы. Сами баллы списываются за каждую операцию и рассчитываются точнее, поскольку для незначительных правок больше не приходится выгружать и загружать обратно всю кампанию. Они начисляются не раз в сутки, а равномерно в течение дня. Посмотреть, сколько баллов потрачено за операцию и сколько их еще осталось на сегодня, можно в ответе сервера.

Названия методов теперь максимально приближены к международному обиходу, чтобы в них было проще сориентироваться. Banner превратился в Ad, Phrase — в Keyword и так далее.

По мнению разработчиков, API 5 в разы удобнее и быстрее предыдущих версий. В течение года он будет работать надстройкой к уже привычному API 4 live, что позволяет параллельно использовать новые и старые методы, понемногу переключаясь на работу с пятой версией и оптимизируя рутинные операции.

Версии 4 и 4 live будут закрыты только в 2020 году, о чем будет сообщено дополнительно. Лучше не откладывать изучение новой версии на потом, поскольку все свежие настройки и форматы в Директе будут поддерживаться именно в API 5. Уже сейчас в нем можно управлять ставками и работать с рекламными материалами: создавать группы и объявления, добавлять ключевые слова, визитки, быстрые ссылки.

Изучить API 5 можно в документации, там же содержится и руководство по переходу на новую версию.

Мастер Йода рекомендует:  Шаблон проектирования MVC и PHP
Добавить комментарий