--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.ru/dev/direct/doc/en/intro.md - https://yandex.ru/dev/direct/doc/ru/intro.md - href: ru/intro.md type: text/markdown title: Markdown version - href: llms.txt type: text/markdown title: llms.txt sourcePath: ru/start/intro.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt # Урок 1. Что такое API Директа В этом уроке мы расскажем, зачем Директу API, и познакомим вас с основными принципами работы. _Яндекс Директ_ — это единая платформа для размещения контекстных и медийных объявлений. Директ покажет объявления целевой аудитории вашего бизнеса, заинтересованной в ваших товарах или услугах. ![](_assets/intro_start.png) Чтобы работать с Директом, достаточно открыть веб-интерфейс, создать аккаунт и разместить объявления. В дальнейшем управлять продвижением в Директе можно не только в веб-интерфейсе, но и через API. {% note tip %} Если вы еще не работали с Директом, рекомендуем предварительно пройти обучающий курс [Как разместить рекламу в Директе](https://yandex.ru/adv/edu/direct-start) и ознакомиться с [Помощью](https://yandex.ru/support/direct/). Это позволит вам понять общие принципы создания и ведения кампаний и лучше освоить наш курс по API. {% endnote %} ## Что такое API {#intro_whats_api} _API_ (англ. Application Programming Interface) — это интерфейс программирования приложений. API сервиса предоставляет набор готовых процедур, функций и структур, с помощью которых разработчики могут создавать свои программы, приложения, скрипты (далее — приложения) для работы с сервисом. Другими словами, API — это конструктор, в котором есть набор деталей (функций, методов) и правил их использования. Из этих деталей вы можете построить собственное приложение. ![](_assets/intro_lego_scheme.png) При работе через API приложение отправляет запрос к сервису и получает ответ, содержащий запрошенные данные. API предоставляет возможность автоматизировать процессы, аналогичные вашей работе в веб-интерфейсе. ## Для чего нужен API Директа {#intro_forwhat_api} Используя API Директа, вы можете управлять теми же рекламно-информационными материалами, что и в веб-интерфейсе. API позволяет автоматизировать рутинные операции, ускорить их выполнение и тем самым повысить эффективность управления аккаунтом. API полезен для тех, кто работает с большими объемами данных, не хочет зависеть от интерфейса в браузере и предпочитает тонкую настройку продвижения. ![](_assets/intro_for_what.png) Вы можете создать приложение для решения своих задач — как независимый разработчик, рекламодатель или рекламное агентство. Например, вы можете написать скрипт, который будет через API автоматически обновлять ставки по вашему собственному алгоритму. Вы можете интегрировать с Директом информационную систему вашей компании — загрузить в Директ большое количество объявлений из вашей базы данных, автоматически обновлять тексты объявлений при изменении цены товара, останавливать и возобновлять показы в зависимости от наличия товара на складе. Вы можете выгружать ежедневную статистику по кампаниям в аналитическую систему или систему финансового учета. Подключение к API Директа и его использование является бесплатным. ## С чего начать {#intro_begining} Для прохождения курса вам потребуется аккаунт в Директе. Создайте, если у вас его еще нет: 1. Войдите на Яндекс под своим логином, который будете использовать как разработчик приложений. Если у вас нет логина на Яндексе — зарегистрируйтесь. 1. В веб-интерфейсе Директа ([https://direct.yandex.ru](https://direct.yandex.ru/)) нажмите кнопку **Запустить рекламу**. 1. Укажите актуальный адрес электронной почты, выберите страну и валюту. Нажмите кнопку **Начать пользоваться сервисом**. 1. Создайте первую кампанию — рекомендуем выбрать тип кампании «Текстово-графические объявления». Укажите параметры кампании и создайте первое объявление. На этом этапе вам достаточно создать одно объявление-черновик с одной ключевой фразой. Отправлять объявления на модерацию и зачислять денежные средства на кампанию не требуется. {% note info %} Более подробную информацию о создании аккаунта в Директе вы можете найти в [Помощи](https://yandex.ru/support/direct/quick-start/create-campaign.html). Советуем также пройти соответствующий [урок](https://yandex.ru/adv/edu/direct/direct-start/kak-zavesti-akkaunt-v-direkte) курса по Директу. {% endnote %} Теперь у вас есть аккаунт в Директе. Давайте посмотрим, как выглядят ваши рекламно-информационные материалы в веб-интерфейсе и в API. ## Объекты в веб-интерфейсе и в API {#intro_objects} Кампания по продвижению в Директе состоит из групп объявлений, каждая из которых содержит объявления и ключевые фразы. Объявления могут включать в себя дополнительные элементы: изображения, быстрые ссылки и другие. ![](_assets/intro_adv_screenshot.png) Взаимосвязь объектов в API представлена на схеме: ![](_assets/intro_objects_scheme.png) - `Campaign` — кампания по продвижению, `AdGroup` — группа объявлений, `Ad` — объявление. - Дополнения к объявлению: `AdImage` — изображение, `VCard` — визитка, `SitelinksSet` — набор быстрых ссылок, `AdExtension` — уточнение. - Условия показа объявлений группы: `Keyword` — ключевая фраза и другие, в зависимости от типа кампании. Для условия показа можно установить ставку — `KeywordBid`. ![](_assets/intro_objects_screenshot.png) ## Задание {#task} Изучите настройки своей кампании в Директе. Создайте новые объявления с разными параметрами. Если вы не хотите запускать реальную кампанию — не отправляйте группы объявлений на модерацию, тогда объявления останутся в статусе «Черновик». [Выполнить задание](https://direct.yandex.ru/) ## Как выглядит запрос к API {#intro_request} Рекламно-информационные материалы, которые вы видите в веб-интерфейсе, можно получить с помощью запросов к API. Внести изменения тоже можно с помощью запросов к API — и сразу увидеть результат в веб-интерфейсе. API работает с каждым объектом в отдельности: различные методы API позволяют создать объявление, обновить визитку, получить статистику и многое другое. Вот как выглядит запрос к API, который позволяет получить список кампаний пользователя. Запрос отправляется по сетевому протоколу HTTPS методом POST. ![](_assets/intro_request.png) В следующих уроках мы проведем вас по всем начальным этапам работы с API: - Расскажем, как получить доступ к API — зарегистрировать приложение на сервисе Яндекс OAuth, подать заявку на доступ, получить OAuth-токен. - Научим формировать запросы к API: покажем, какие сервисы и методы предоставляет API, подробно рассмотрим структуру запроса. - В завершение дадим несколько советов, как работать с реальными рекламно-информационными материалами пользователей. Настоятельно рекомендуем проходить уроки последовательно. В каждом уроке вам потребуются сведения, изложенные в предыдущих уроках, а также результаты действий, выполненных в предыдущих уроках. Желаем успеха! ## Полезные ссылки {#intro_usfull_links} - [Яндекс про Директ: основы](https://yandex.ru/adv/edu/direct-start) - [Справка Яндекс Директа](https://yandex.ru/support/direct/)