📚 Документация и База знаний

Полное руководство по работе с веб-сервисом ScaleDemand

ScaleDemand — профессиональный генератор автономных скриптов для Google Ads (Demand Gen / Создание спроса). Сервис автоматизирует полный цикл создания и залива рекламных кампаний через встроенную среду Google Ads Scripts без использования сторонних внешних серверов и без рутины.

⚡ Автономные JS-скрипты 🎯 Demand Gen Google Ads API 🖼️ Интерактивный подбор 5 фото 📚 570+ словарных чипсов 🛡️ Антифрод-уникализатор (CRC32) 🚀 Быстрый режим Boost 💾 Автосохранение LocalStorage

1 Основной интерфейс и панели управления

UI & Управление

📌 1.1. Шапка (Header) и верхняя панель

🌓 Переключатель темы (Liquid Glass Light / Dark)

Позволяет переключать визуальный стиль между светлой и тёмной темой Glassmorphism. Выбранная тема автоматически сохраняется в localStorage вашего браузера (ключ sd_theme).

🚀 Режим Boost (Ультра-быстрый залив)

Компактный режим интерфейса для скоростной сборки кампаний. При его активации скрываются второстепенные блоки (бюджет, расписание, лишние меню), оставляя на экране только самое необходимое: Final URL, Business Name, Заголовки, Описания, Словарные подсказки, Фото и кнопку Генерация скрипта.

💾 Экспорт / Импорт шаблона (JSON)

Экспорт шаблона: сохраняет текущую конфигурацию кампании, таргетингов и объявлений в компактный файл .json (без «тяжёлых» картинок).
Импорт шаблона: мгновенно восстанавливает ранее сохранённый .json конфиг в форму.

📌 1.2. Автосохранение и боковое меню (Side Nav)

⚡ Автосохранение в LocalStorage (sd_settings)

Любые изменения в форме (ввод текста, выбор чекбоксов, смена параметров) автоматически записываются с дебаунсом 400 мс в локальное хранилище браузера. Вы никогда не потеряете прогресс при случайной перезагрузке страницы или смене вкладки.

🧭 Боковая навигация (Side Nav)

Плавающая панель справа (на мобильных устройствах — снизу), обеспечивающая быстрый переход к ключевым блокам формы: Кампания, Расписание, Адгруппы, Объявления, а также кнопку быстрого запуска ⚡ Генерация скрипта.

2 Пошаговая настройка рекламной кампании

Workflow

Шаг 1 Параметры кампании (CONFIG)

Название кампании: Укажите имя вручную или оставьте пустым — сервис автоматически сгенерирует стандартное имя Google Ads вида Создание спроса (ГГГГ-ММ-ДД).
Бюджет мин / макс (в день): Задайте диапазон дневного бюджета. Скрипт подставит случайное число из этого диапазона при создании кампании.
Стратегия ставок:
- TARGET_CPA: требует указания минимального и максимального целевого CPA. Скрипт автоматически создаст целевую конверсию «Покупка» в аккаунте.
- MAXIMIZE_CONVERSIONS: поля Target CPA автоматически блокируются и кампания оптимизируется на максимальное число конверсий.
Статус объявлений при старте:
- PAUSED: кампания и адгруппы создаются активными (ENABLED), но сами объявления создаются на паузе для ручной модерации.
- ENABLED: объявления сразу запускаются активными.
Дата старта кампании:
- Сегодня — запуск сразу при выполнении скрипта.
- Завтра / Послезавтра — отложенный старт на +1 / +2 дня.
- Дата — выбор точной даты в календаре.

Шаг 2 Расписание показов (Ad Schedule)

Время начала показов: Задайте окно времени «От» и «До» (с шагом 15 минут). Скрипт выберет случайное время старта в этом окне.
Время окончания показов: Укажите час завершения показов (например, 18:00 или 24:00).
Дни недели: Отметьте чекбоксами дни, в которые разрешён открут рекламы.
Отключение расписания (24/7): Установите галочку «Не использовать расписание (24/7)», если реклама должна откручиваться круглосуточно во все дни недели без ограничений по времени.

Шаг 3 Группы объявлений и таргетинг (Ad Groups)

Вы можете создавать неограниченное количество групп объявлений через кнопку «+ Добавить адгруппу».

Параметр	Описание
Название группы	Имя группы объявлений внутри кампании.
Optimized targeting	Включение или отключение оптимизированного таргетинга Google Ads.
Гео-таргетинг (Гео 1 / Гео 2)	Поиск и выбор стран по справочнику Google (например, Болгария, Польша, Германия, Испания и др.).
Языковой таргетинг	Выбор языка целевой аудитории. На этот язык автоматически переводятся словарные подсказки.
Каналы Demand Gen	Плейсменты: YouTube In-Stream, YouTube In-Feed, YouTube Shorts, Discover, Gmail, Display.
Демография	Выбор целевых возрастных групп и пола аудитории.

Шаг 4 Объявления и тексты (Ads)

Final URL: Целевая посадочная страница. При вводе протокол автоматически нормализуется в безопасный https://.
Business Name: Название бренда (до 25 символов). Опция «из URL» автоматически заполняет имя из домена посадочной страницы.
Заголовки и Описания:
- Заголовки (до 40 символов) и описания (до 90 символов) вводятся по одному на строку.
- Интерфейс подсвечивает превышение лимитов символов и отображает счётчики строк.

3 Фотографии и Словарные подсказки

Креативы & AI

🖼️ 3.1. Интерактивный подбор 5 фото из проверенных источников

При включенном чекбоксе «✨ Картинка из Google по описанию» во время нажатия на кнопку «Сгенерировать скрипт» открывается модальное окно выбора с 5 качественными вариантами фото.

🌐 Источник фото: Wikimedia Commons

Поиск и подбор реальных фотографий для объявлений осуществляется напрямую через открытую базу Wikimedia Commons (синий бейдж) с фильтрацией форматов (1.91:1, 1:1, 4:5, 9:16) и умной защитой от дубликатов.

🔄 Кнопка «Найти другие» и дедупликация

При клике на «Найти другие» опрашиваются источники со смещением страниц. Алгоритм отслеживает список ранее просмотренных URL (seenUrls) и гарантирует показ 5 полностью новых, уникальных фото.

⌨️ Горячие клавиши (Keyboard Navigation)

Управляйте выбором фото прямо с клавиатуры без мыши:

Клавиши 1, 2, 3, 4, 5 — мгновенный выбор карточки.
Стрелки ← и → — переключение между фото.
Enter — подтвердить выбор и продолжить.
Escape — закрыть окно.

📐 Форматы и автокроп логотипа

Поддерживаются все пропорции Demand Gen: 1.91:1 Horizontal, 1:1 Square, 4:5 Portrait, 9:16 Shorts.

Логотип (512×512px): система автоматически вырезает центральную фокусную часть (45%) из вашего главного фото, избавляя от необходимости искать отдельный файл логотипа.

📚 3.2. Словарные подсказки (Word Chips — 570+ слов)

Под полями текстов каждого объявления расположен блок интерактивных чипсов со словами.

База 570+ существительных и городов: популярные города мира, курорты, природа, транспорт, отели, еда, дом, электроника, одежда, красота и здоровье.
Автоперевод: при клике на чипс слово автоматически переводится на язык целевой аудитории группы и вставляется в поля заголовка и описания.
Кнопка «🔄 Обновить»: мгновенно генерирует случайную пятёрку новых слов из базы.

4 Генерация и запуск скрипта в Google Ads

Запуск

🛡️ 4.1. Антифрод-уникализация кода (Anti-Fingerprint Engine)

Убедитесь, что переключатель «🛡️ Антифрод-уникализация кода» активен (включен по умолчанию).
Нажмите кнопку «Сгенерировать Google Ads Script».
Движок сформирует чистый, 100% прозрачный и понятный для проверок Google код с уникальным Build ID, CRC32-сигнатурой и динамическими batch ID без использования обфускации и мертвого шума.
В блоке «Готовый скрипт» отобразятся метаданные сборки и чистый исполняемый код.
Для быстрого залива на следующий аккаунт нажмите «🔄 Переуникализировать» — вы мгновенно получите новую уникальную копию скрипта без повторного ввода данных.

🚀 4.2. Пошаговая инструкция по запуску в Google Ads

Войдите в рекламный аккаунт Google Ads.
Перейдите в меню: Tools & Settings (Инструменты и настройки) → Bulk Actions (Массовые действия) → Scripts (Скрипты).
Нажмите синюю кнопку «+» (Создать скрипт).
Очистите редактор кода и вставьте скопированный скрипт из ScaleDemand.
Нажмите Authorize (Авторизовать) и подтвердите права скрипта на создание кампаний.
Нажмите Preview (Просмотр) для тестовой проверки или Run (Выполнить) для немедленного создания кампании.
В журнале выполнения (Logs) отобразится подробный статус создания всех ресурсов.

5 Полезные особенности и частые вопросы (FAQ)

Tips & Pro

🛒 Автосоздание конверсии «Покупка» (Purchase)

Стратегия ставок TARGET_CPA требует обязательного наличия конверсионного действия типа PURCHASE. В скрипт встроен модуль ensurePurchaseConversionAction(), который сам проверяет наличие конверсии в аккаунте и создаёт её при отсутствии.

📦 Атомарная отправка через AdsApp.mutateAll

Кампания, расписание, адгруппы, аудитории и креативы создаются единым пакетным запросом через AdsApp.mutateAll. При возникновении ошибки Google Ads API возвращает детальный JSON-ответ в логи для быстрого анализа.

🎲 Рандомизация ассетов (Защита от дубликатов)

Имена всех создаваемых графических ассетов и логотипов генерируются с уникальными UUID. Это предотвращает конфликты имён в библиотеке ассетов Google Ads и исключает ошибки дедупликации.

💡 Почему кампания создаётся в статусе PAUSED?

Если в настройках выбран статус PAUSED, кампания создаётся на паузе для возможности проверки параметров до старта открута бюджета. Для немедленного запуска выберите статус ENABLED.