--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://yandex.ru/dev/direct/doc/ru/troubleshooting/faq.md sourcePath: ru/support/troubleshooting/faq.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt # О чем вы хотите спросить у службы поддержки? Варианты использования и возможности API Директа подробно описаны в документации. Если вы не нашли ответ на свой вопрос, обратитесь к нашим специалистам — мы обязательно вас проконсультируем. Пожалуйста, выберите из списка ниже или слева интересующий вас вопрос. Выбирая подходящие темы, вы увидите либо ответ на свой вопрос, либо форму для обращения. - [При вызове метода API Яндекс Директа возникает ошибка](https://yandex.ru/dev/direct/doc/ru/troubleshooting/issue.md) - [Заявка на доступ](https://yandex.ru/dev/direct/doc/ru/troubleshooting/register.md) - [Ограничения при работе с API Яндекс Директа](https://yandex.ru/dev/direct/doc/ru/troubleshooting/limits.md) - [Доступ к регистрации новых клиентов агентства через API](https://yandex.ru/dev/direct/doc/ru/troubleshooting/add-client.md) - [Внести предложение или оставить отзыв](https://yandex.ru/dev/direct/doc/ru/troubleshooting/proposal.md) - [Другие вопросы по API Яндекс Директа](https://yandex.ru/dev/direct/doc/ru/troubleshooting/other.md) ## Частые вопросы по работе с API Директа ## Что такое API Яндекс Директа и в каких целях его можно использовать? {#beginning} API сервиса Яндекс Директ предоставляет программный доступ к данным и позволяет создавать приложения для управления кампаниями. Через API внешние приложения добавляют и редактируют кампании, объявления, фразы, задают ставки. API Директа предназначен в первую очередь для рекламных агентств и прямых рекламодателей — торговых компаний, предприятий сферы услуг и других. Разработка собственных приложений позволяет им в полной мере реализовать собственные подходы к ведению кампаний. Варианты использования и возможности программного интерфейса подробно описаны в документации. ## Есть ли разница в управлении кампанией через API и через веб-интерфейс? {#difference} Все изменения, сделанные через API, отражаются в ваших кампаниях. ## Есть ли готовые программы, использующие API Директа? {#programs} Поскольку разные компании подходят к управлению продвижением по-разному, на рынке появилось множество решений для управления продвижением на основе API Яндекс Директа. Многие рекламные агентства предлагают своим клиентам инструменты для автоматического управления продвижением в Директе, а также оптимизируют с их помощью собственные рабочие процессы. Все эти инструменты построены на методах API Директа. У Яндекса также есть готовые решения на основе API Яндекс Директа: - Программа [Директ Коммандер](https://direct.yandex.ru/commander/) — предназначена для управления масштабными кампаниями в удобном интерфейсе. - Мобильный Директ для [iPhone](https://mobile.yandex.ru/apps/iphone/direct#main) и [Android](https://mobile.yandex.ru/apps/android/direct#main) — предоставляет рекламодателям возможность управлять своими кампаниями максимально оперативно. ## Какие технологии поддерживаются в API? {#technologies} Запросы к API Директа выполняются по протоколу HTTPS методом POST. Входные и выходные структуры данных передаются в теле запроса и ответа. API Директа поддерживает два формата взаимодействия: [JSON](https://yandex.ru/dev/direct/doc/dg/concepts/JSON.html) и [SOAP](https://yandex.ru/dev/direct/doc/dg/concepts/SOAP.html). Для авторизации используется протокол OAuth 2.0: в запросах необходимо указывать [авторизационный токен](https://yandex.ru/dev/direct/doc/dg/concepts/auth-token.html). ## Сколько стоит использование API? {#cost} Подключение к API Директа и его использование является бесплатным. ## Почему токен стал недействительным? {#token-invalid} Токен может стать недействительным, например, если пользователь сменил пароль на Яндексе. Полный список причин приведен в разделе [Отзыв токенов](https://tech.yandex.ru/oauth/doc/dg/reference/token-invalidate-docpage/) документации Яндекс.OAuth. В этом случае требуется получить новый токен. ## Как я могу увеличить количество доступных мне баллов? {#increase-points} Суточный лимит баллов зависит от активности кампаний — количества показов и кликов и, соответственно, расходования средств. Суточный лимит пересчитывается раз в сутки. ## Как можно вывести XML-код запроса и ответа сервера? {#view-code} В целях обнаружения ошибок и отладки иногда требуется вывести SOAP-запрос клиента и SOAP-ответ сервера. Для Perl: ```perl translate=no my $client = SOAP::Lite->service($client->on_debug(sub {print @_})); ``` ## Как определить, идут ли показы по ключевой фразе? {#keyword-running} Проверьте выполнение следующих условий: - Убедитесь, что ключевая фраза активна (значение ON параметра `State`), с помощью метода [Keywords](https://yandex.ru/dev/direct/doc/ref-v5/keywords/keywords.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/keywords/get.html). - Убедитесь, что в группе есть хотя бы одно активное объявление (значение ON параметра `State`), с помощью метода [Ads](https://yandex.ru/dev/direct/doc/ref-v5/ads/ads.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html). Объявления можно отбирать одновременно по идентификатору группы (входной параметр `AdGroupIds`) и состоянию (входной параметр `States`). - Убедитесь, что кампания активна (значение ON параметра `State`), с помощью метода [Campaigns](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/campaigns.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/campaigns/get.html). Если все условия выполнены, показы объявлений по фразе возможны. Однако выполнение показов непосредственно в текущий момент не гарантируется. Наиболее частые причины отсутствия показов: - кампания находится в процессе активизации; - показы автоматически приостановлены в соответствии с настройками недельного бюджета или автоматической стратегии; - показы автоматически приостановлены в соответствии с настройками временного таргетинга. Более подробная информация приведена в разделе [Проблемы с показами](https://yandex.ru/support/direct/troubleshooting/shows.html) Справки Директа. ## Как узнавать об изменениях в API Директа? {#news} Список изменений по версиям API представлен в следующих разделах: - Для API версии 5 — в разделе [История изменений](https://yandex.ru/dev/direct/doc/changelog/index.html). ## Где найти документацию версии 4 и Live 4? {#v5} Документация версии 4 и Live 4 находится по адресу [https://tech.yandex.ru/direct/doc/dg-v4/](https://tech.yandex.ru/direct/doc/dg-v4/). ## Чем отличается версия 5 от версий 4 и Live 4? {#migration} Полную информацию об изменениях в версии 5 по сравнению с предыдущими версиями, а также о соответствии методов и их параметров вы найдете в [Руководстве по переходу](https://yandex.ru/dev/direct/doc/ru/concepts/compare).