Как подключить GPT к кабинету Яндекс.Директ

Скопировать таблицу из кабинета в чат — не работает: в буфер влезает одна вкладка, а нужен весь аккаунт. Ниже — как дать модели прямой доступ к цифрам.

Шаг 1. Заявка на доступ к API

• Создайте хотя бы одну кампанию — без неё раздела настроек API в кабинете нет
• Откройте настройки API в кабинете Директа
• Нажмите «Получить доступ к API»
• Перейдите на вкладку «Мои заявки» и создайте новую
• Выберите тип доступа: полный, а не тестовый

Что важно знать:

• Тестовый доступ открывает только песочницу — учебную среду без реальных данных
• Заявку подают от имени того, кто будет пользоваться доступом. Для агентства — логин основного представителя
• Рассматривают в рабочие дни: обычно 1–3 дня, в загруженные периоды до 7
• Одна заявка на одно приложение, а не на каждого пользователя

Шаг 2. Получить токен

Заявка даёт право обращаться к API. Токен отвечает, чьи именно данные запрашиваются.

• Зарегистрируйте приложение в Яндекс OAuth
• Откройте страницу запроса доступа
• Войдите под логином Директа
• Подтвердите разрешение
• Скопируйте выданную строку — это токен

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

Токен перестаёт работать при смене пароля или отзыве доступа — тогда получают заново.

Шаг 3. Про баллы

• У API суточный лимит, он считается в баллах
• Размер лимита индивидуальный: чем больше показов, кликов и расхода — тем больше баллов
• Баллы списываются за каждый запрос и за каждую операцию
• За ошибку списывают 20 баллов
• На маленьком аккаунте выгрузку иногда приходится делать в два захода

Шаг 4. Скачать Codex

• Зайдите на сайт ChatGPT в раздел Codex
• Скачайте приложение под свою систему — есть версии для Windows и macOS
• Установите как обычную программу
• Оформите любую подписку ChatGPT — Plus, Pro или другую
• Войдите в приложение под своей учётной записью

Отдельно за Codex платить не нужно — он работает по вашей подписке.

Шаг 5. Файл .env

В папке проекта создайте файл с именем .env и положите туда токен:

YANDEX_DIRECT_TOKEN=ваш-токен

Зачем отдельный файл:

• Токен даёт полный доступ к рекламному кабинету
• Он не должен попасть в переписку, в репозиторий или на чужой компьютер
• Файл .env лежит только у вас на диске
• Добавьте .env в .gitignore — тогда он не уедет в общий доступ

Шаг 6. Промт

Не работает: «проанализируй мою рекламу». Ответ будет общий и подойдёт любому аккаунту.

Работает — разделить кампании по типам:

Сделай анализ рекламных кампаний по отдельности — сети, поиск, медийные. По каждой пришли самые результативные примеры: от ключей и площадок до текстов и креативов. А также самые худшие примеры, которые ты бы отключил.

Что в нём важно:

• «по отдельности» — раскладывает аккаунт по типам, а не усредняет
• «самые результативные примеры» — просит конкретику, а не советы вообще
• «от ключей и площадок до текстов и креативов» — задаёт глубину: уровень фраз и объявлений, а не кампаний
• «которые ты бы отключил» — самое ценное: конкретные объекты с обоснованием

Промт работает на любой модели. Чем модель сильнее, тем внимательнее к мелочам и тем реже выдумывает цифры.

Что смотреть по каждому типу

Что делать с ответом

Не отключайте всё подряд по первому отчёту. Модель видит цифры, но не видит контекста: сезонность, тестовый запуск, кампанию под акцию.

Порядок:

• Сначала выключить то, где расход есть, а конверсий нет вовсе
• Потом сверить спорное с Метрикой
• И только после этого трогать то, что приносит результат, но дорого

Чек-лист

• Создана хотя бы одна кампания
• Подана заявка на полный доступ к API
• Заявка одобрена
• Получен OAuth-токен
• Скачано приложение Codex с сайта
• Оформлена подписка ChatGPT
• Токен лежит в файле .env
• Файл .env внесён в .gitignore
• Промт делит кампании на поиск, сети и медийные