Добро пожаловать в Yootap! Наша платформа создана для автоматической оптимизации рекламных кампаний в Яндекс.Директ и защиты вашего бюджета от скликивания (фрода) и неэффективных площадок в РСЯ. В этой статье мы пошагово настроим систему, чтобы вы получили первые результаты.

Шаг 1. Регистрация аккаунта

Для начала работы вам необходимо зарегистрироваться на платформе:

  1. Перейдите на страницу регистрации (или нажмите кнопку «Начать бесплатно» в шапке сайта).
  2. Введите ваш рабочий Email и задайте надежный пароль.
  3. Или войдите через аккаунт Яндекс к которому подключен Яндекс.Директ

Шаг 2. Подключение рекламного кабинета Яндекс.Директ

Подключение рекламного кабинета Яндекс.Директ к Yootap выполняется через API и состоит всего из 3 простых шагов:

Шаг 2.1. Регистрация приложения в Яндекс ID

Сначала необходимо зарегистрировать ваше приложение для авторизации на стороне Яндекса:

  1. Перейдите по ссылке для создания приложения в Яндекс для доступа к API или отладки.
  2. Авторизуйтесь в сервисе Яндекс OAuth через ваш аккаунт на Яндексе, с помощью которого вы работаете в Яндекс.Директ.
  3. При настройке приложения в поле Доступ к данным введите passport:business и direct:api для доступа к необходимым правам.
Регистрация приложения и настройка прав доступа

Шаг 2.2. Заявка на доступ к API Яндекс.Директ

После этого подайте заявку на доступ к API Яндекс.Директ:

  1. Перейдите по ссылке подачи заявки на доступ к API.
  2. Обязательно выберите полный доступ, а не тестовый.
  3. Выберите зарегистрированное приложение из списка.
  4. Заполните поля формы точно так же, как показано на скриншотах ниже:

Укажите один или несколько контактов, по которым с вами быстро сможет связаться служба поддержки - укажите свои данные

Данные о компании - укажите название своей компании и ссылку на свой сайт

Далее как на скриншоте

Заявка на доступ к API Яндекс.Директ - Шаг 1

Для примера успешной работы приложения, укажите один или несколько логинов в Директе, для которых оно используется - советуем указать тот email, через который вы будете входить на сайт yootap.ru. Его же нужно будет указать в настройках подключения сайта yootap.ru

Остальные настройки как на скриншоте

Заявка на доступ к API Яндекс.Директ - Шаг 2

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

Скачать скриншот интерфейса

Опишите схему взаимодействия вашего приложения с Директом - введите текст ниже:

Техническое описание, схема, частота и потоки: Приложение раз в сутки в один поток последовательно запрашивает активные кампании (Campaigns.get), скачивает отчет по площадкам (Reports.get) и обновляет список заблокированных сайтов (Campaigns.update) через фоновые очереди Laravel. Цели использования методов: Метод Campaigns.get определяет активные кампании, сервис Reports собирает статистику кликов и отказов на площадках РСЯ, а метод Campaigns.update передает новые неэффективные площадки в список ExcludedSites. Объем данных сейчас и в будущем: Сейчас приложение тестируется на 1 аккаунте с 5 кампаниями, а в будущем планируется обрабатывать до 150 клиентов и 2000 кампаний без запроса избыточных данных по объявлениям и ключевым фразам. Учет бальных ограничений: Система контролирует остаток баллов через заголовки Units в каждом ответе API и автоматически приостанавливает выполнение фоновых задач на час при достижении критического лимита. Обработка ошибок: Временные сбои сети обрабатываются очередью с повторными попытками, ошибки авторизации переводят кампанию в паузу с отправкой уведомления пользователю, а превышение лимита в 1000 площадок превентивно регулируется алгоритмом ротации в базе данных.

Заявка на доступ к API Яндекс.Директ - Шаг 3

Шаг 2.3. Выпуск отладочного токена и подключение

Получите токен доступа и привяжите его в личном кабинете Yootap:

  1. Выпустите отладочный токен (подробнее в документации Яндекс ID), перейдя по ссылке: 
    https://oauth.yandex.ru/authorize?response_type=token&client_id=<Client_ID>

    * Идентификатор Client_ID доступен в свойствах приложения. Чтобы открыть свойства, перейдите в Яндекс OAuth и нажмите на название вашего приложения в списке.

    2. Выберите ваше созданное приложение из списка и скопируйте ClientID

    Ввод OAuth токена и логина в кабинете Yootap
  2. Полученный токен введите в поле OAuth Токен API, а логин (тот, что вы указывали на Шаге 2.2) введите в поле Логин Яндекс в личном кабинете Yootap.
Ввод OAuth токена и логина в кабинете Yootap
Важное примечание
Если вы работаете через агентский кабинет Директа, убедитесь, что вы предоставляете доступ с правами главного представителя или представителя с доступом к нужным клиентским кампаниям.

Если у вас возникнут вопросы по настройке, напишите нам в чат поддержки Telegram - мы с радостью поможем разобраться!