Интеграция с Яндекс Директ¶
Настройка интеграции¶
Если Вы хотите интегрировать свои данные из Яндекс Директ с UX Rocket, вам необходимо самостоятельно получить специальный код доступа – токен. Это выполняется через Яндекс Директ.
Токен – это ключ, который позволяет системе взаимодействовать с данными Яндекс Директ без вашего постоянного участия.
Инструкция по получению токена для Яндекс Директ:
Шаг 1. Создание приложения для Яндекс Директ:
- Зайдите на страницу создания приложения Яндекс (UX Rocket рекомендует провести создание через данную ссылку).
- Придумайте название для своего приложения (любое удобное название) и выберите платформу (например, веб-приложение).
- Выберите нужные права доступа для вашего приложения (для работы с API Яндекс Директ).
Шаг 2. Заявка на доступ к API Яндекс Директ:
- После создания приложения, вам нужно скопировать его ClientID (это уникальный номер приложения).
- Перейдите на страницу заявок на доступ к API.
- Нажмите Мои заявки → Новая заявка → Полный доступ.
- Вставьте ваш ClientID в первое поле и заполните остальные обязательные поля (они отмечены звёздочками).
Что написать в заявке?
Здесь вам нужно объяснить, для чего вам нужен доступ к API. Например: «Я собираюсь использовать API Яндекс Директ для получения информации и анализа метрик». Важно также указать, как часто Вы планируете делать запросы, если Вы укажете слишком высокую частоту запросов, это может привести к отклонению заявки. Вместо этого лучше указать разумную частоту запросов и описать механизм обработки ошибок, чтобы продемонстрировать, что запросы будут оптимизированы и безопасны для использования.
Шаг 3. Получение токена:
- После одобрения заявки, Вы сможете получить свой токен.
- Используйте данную ссылку:
- Подставьте ClientID своего приложения вместо <идентификатор приложения> и перейдите по ссылке.
- В открывшейся странице после входа в аккаунт Яндекса Вы увидите свой токен в адресной строке.
Подробнее Вы можете изучить процесс получения токена в документации Яндекс.
Что делать с токеном?
Скопируйте его и вставьте в UX Rocket. Теперь система сможет автоматически получать данные из Яндекс Директ.
После того как токен получен, его вводят в систему на специальной странице. Для ввода перейдите в раздел 
→ Рекламные кабинеты → Яндекс Директ.
Когда Вы первый раз введете токен, UX Rocket загрузит все данные, которые есть в вашем аккаунте Яндекс Директ за весь период.
После этого данные обновляются ежедневно. На странице всегда можно увидеть дату, когда данные загружались в последний раз.
Если токен станет неактуальным (например, срок его действия истек) или он не действительный, на странице появится уведомление, Возникла проблема с токеном. Воспользуйтесь следующей инструкцией для устранения неполадок.
Важно помнить
Максимальное время жизни токена зависит от прав, выбранных при регистрации приложения.
Если Вы получаете новый токен в Яндекс Директ и вводите его, то система автоматически продолжит работу. Она догрузит все данные за те дни, когда они не обновлялись, и потом опять начнет обновлять данные каждый день.
Важно помнить
Если у Вас на балансе закончились денежные средства в Яндекс Директ, то данные о рекламе не будут поступать в систему.
Проверка актуальности и настроек OAuth-токена¶
Если у вас возникла проблема с токеном убедитесь:
Шаг 1. Убедитесь, что статус созданного вами приложения Подключено.
Шаг 2. Если Вы изменили настройки вашего приложения, убедитесь, что после внесения изменений вам было выведено сообщение Существующие токены продолжат работу после сохранения настроек. В противном случае вам придется получить новый токен.
Шаг 3. Убедитесь, что срок действия вашего токена не истек. Со временем токен может стать недействительным и потребуется получить новый.
Шаг 4. Проверьте следующие ситуации.
Токены всех ваших приложений будут отозваны, если:
- Вы изменили пароль на Яндексе.
- Вы нажали Выйти на всех компьютерах в настройках безопасности Яндекса.
Что делать?
Повторите шаги получения нового токена.
Токен конкретного приложения будет отозван, если:
- Вы отменили доступ приложения к своим данным через Яндекс.Паспорт.
- Разработчик приложения изменил права доступа к данным (например, добавил или убрал разрешения).