AdQuest Widget

AdQuest Widget - Справочник по интеграции

Руководство по внедрению AdQuest Widget - решения для защиты от ботов с возможностью монетизации трафика.

Обзор

AdQuest Widget объединяет защиту от ботов и монетизацию трафика. Виджет определяет легитимных пользователей и показывает им релевантную рекламу вместо традиционной CAPTCHA.

Режимы работы

Режим	Описание	Применение
Advertisement	Показ рекламы с вопросом	Монетизация + защита, основной режим
Captcha	Fallback CAPTCHA (checkbox)	Когда нет рекламы или высокий риск
Invisible	Автоматическая проверка	Для легитимных пользователей

Быстрый старт

Базовая интеграция (HTML)

<!-- 1. Подключите CSS -->
<link rel="stylesheet" href="https://cdn.ad-quest.ru/widget/v1/adquest-widget.min.css">

<!-- 2. Добавьте контейнер -->
<div id="adquest-captcha"></div>

<!-- 3. Подключите JS -->
<script src="https://cdn.ad-quest.ru/widget/v1/adquest-widget.min.js"></script>

<!-- 4. Инициализируйте виджет -->
<script>
AdQuest.init({
  siteKey: 'YOUR_SITE_KEY',
  container: document.getElementById('adquest-captcha'),
  onSuccess: (token) => {
    console.log('Токен:', token);
  }
});
</script>

Разделы документации

Конфигурация

Настройка виджета, опции, загрузка скриптов

API Reference

JavaScript API, endpoints, TypeScript типы

Примеры интеграции

Интеграция с формами, примеры для фреймворков

Troubleshooting

Частые ошибки, отладка, ограничения

Ключевые особенности

• Токен действителен: 1 час (настраивается через tokenTTL)
• Одноразовое использование: Каждый токен можно проверить только один раз
• Серверная проверка обязательна: Клиентская проверка недостаточна
• localStorage кэширование: Токен сохраняется для повторных посещений
• Автоматическое скрытие: Опция hideOnSuccess скрывает виджет после успеха

Защитные механизмы

AdQuest включает многоуровневую защиту от автоматизированных запросов и злоупотреблений:

• Анализ поведения пользователя
• Проверка IP-адреса и геолокации
• Fingerprinting браузера
• Rate limiting на уровне API
• Защита от replay-атак

Монетизация

AdQuest позволяет монетизировать трафик через показ рекламы:

• Реклама показывается вместо CAPTCHA
• Пользователь отвечает на вопрос о рекламе
• Вы получаете оплату за просмотры (CPV)
• Если рекламы нет - показывается обычная CAPTCHA

Дополнительные ресурсы

• Dashboard ↗ - управление ключами и настройками
• API документация - полное описание endpoints
• Примеры интеграции - готовые решения для популярных фреймворков