# Яндекс Директ

Контекстная реклама — кампании, объявления, ключевые слова, ставки и аналитика

## Сценарии

### Расход и конверсии по кампаниям
Агент соберёт отчёт по показам, кликам, CTR, расходу и конверсиям за период и покажет, какие кампании окупаются, а какие тратят бюджет впустую.

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

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

### Ежедневная сводка по расходу
Агент пришлёт в чат расход за вчера, сравнит с прошлой неделей и назовёт кампании, у которых просел CTR или выросла цена конверсии.

## Как подключить

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

### Убедитесь, что кампании лежат на этом же логине
Агент работает с кампаниями того логина, под которым подтверждён доступ. Кампании клиентов под агентским логином не подтянутся: для них Директ требует заголовок Client-Login с логином рекламодателя, а мы его не спрашиваем.

### Проверьте уровень прав, если кампании ведёт агентство
Права из веб-интерфейса переносятся в API один в один: при доступе «только на чтение» агент сможет лишь получать данные, а ставки и статусы менять не даст. Право на редактирование кампаний выдаёт агентство.

### Примите условия на странице «Настройки API»
Пользоваться API можно после принятия условий соглашения на странице «Настройки API». Там же на вкладке «Параметры» проверьте список разрешённых IP-адресов: если он заполнен, запросы с других адресов Директ отклонит.

## Частые вопросы

### Как подключить Яндекс Директ?
Входом в аккаунт Яндекса: вы подтверждаете код на странице Яндекса, копировать токены не нужно. Входите под тем логином, на котором лежат кампании: клиентские кампании под агентским логином не подтянутся. Условия соглашения принимаются на странице «Настройки API».

### Что агент видит в Директе?
Кампании, группы, объявления, ключевые фразы со ставками, минус-фразы, справочники регионов и отчёты API v5 — по тому рекламодателю, под логином которого подтверждён доступ.

### Может ли агент менять ставки и кампании?
Да, если у логина есть право на редактирование: агент останавливает и запускает кампании, выставляет ставки по фразам и корректировки. Права переносятся из веб-интерфейса один в один, и при доступе «только на чтение» остаётся аналитика.

### Что с лимитами API Директа?
Директ считает баллы (Units) и держит суточную квоту на рекламодателя, а параллельных запросов допускает не больше пяти. Агент дробит выборки постранично, а тяжёлые отчёты заказывает в офлайн-режиме и дожидается готовности.

[Открыть Яндекс Директ](https://direct.yandex.ru)