Руководство по управлению кампаниями

Что такое кампания?

Кампания - это основной контейнер для организации и распределения трафика в Simple TDS. Думайте о ней как о воронке трафика, которая принимает посетителей и направляет их через потоки на основе правил фильтрации.

Ключевые концепции

• Уникальный токен: Каждая кампания получает 64-символьный уникальный токен, автоматически генерируемый при создании
• Точка входа трафика: URL кампании - это место, куда вы отправляете свой трафик
• Контейнер потоков: Кампании содержат один или несколько потоков, которые обрабатывают и фильтруют трафик
• Отслеживание статистики: Каждая кампания отслеживает клики, уникальных посетителей, конверсии и ботовый трафик
• Привязка к домену: Каждая кампания должна быть связана с активным доменом

Жизненный цикл кампании

Создание кампании → Настройка домена → Добавление потоков → Добавление таргетов → Активация → Отправка трафика

Кампания может быть:

• Неактивной (по умолчанию): Не обрабатывает трафик, используется для настройки/тестирования
• Активной: Обрабатывает входящий трафик и перенаправляет на таргеты

Создание кампании

Предварительные требования

Перед созданием кампании у вас должны быть:

Пошаговое руководство

1. Перейдите на страницу кампаний

В главном меню нажмите Кампании, чтобы просмотреть список ваших кампаний.

2. Нажмите кнопку "Создать кампанию"

Нажмите кнопку + Создать кампанию в правом верхнем углу.

3. Заполните данные кампании

Название кампании (обязательно)

• Описательное название для внутреннего использования
• Пример: "Facebook Mobile US", "Google Desktop EU", "Native Traffic Q4"
• Лучшая практика: Используйте соглашения об именах, которые указывают на источник трафика и аудиторию

Описание (необязательно)

• Подробные заметки о цели кампании, источнике трафика или стратегии
• Поддерживает многострочный текст
• Полезно для совместной работы в команде и будущих справок

Выбор домена (обязательно)

• Выберите из ваших активных доменов
• В выпадающем списке показаны только активные домены
• Если домен помечен как "Публичный", вы можете использовать поддомены для URL кампаний
• Неактивные домены скрыты (сначала нужно их активировать)

4. Сохраните кампанию

Нажмите Сохранить, чтобы создать кампанию.

Правила валидации:

• Название кампании обязательно
• Домен должен быть выбран
• Выбранный домен должен быть активным
• В вашей организации должен существовать хотя бы один таргет

5. Кампания создана

После успешного создания вы увидите:

• Уведомление об успехе: "Кампания успешно создана"
• Новая кампания появляется в списке кампаний
• Статус кампании Неактивна по умолчанию
• Уникальный токен кампании автоматически сгенерирован

Настройки кампании

Доступ к настройкам кампании

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

• Информация - Настройки и детали кампании
• Потоки - Потоки трафика и правила фильтрации
• Статистика - Метрики производительности и аналитика

Вкладка информации

Основная информация

Название кампании

• Нажмите Редактировать для изменения
• Изменения вступают в силу немедленно
• Нет влияния на существующие URL трафика

Описание

• Необязательное поле для заметок и документации
• Поддерживает форматирование в стиле markdown
• Видно только членам организации

Домен

• Домен, связанный с этой кампанией
• Изменение домена изменит URL кампании
• Нельзя изменить, если кампания активна и получает трафик

Переключатель статуса

• Переключение между Активна/Неактивна
• Визуальный индикатор: Зеленый = Активна, Серый = Неактивна
• Быстрое переключение прямо из списка кампаний

Токен кампании

Токен кампании отображается на вкладке Информация:

• 64-символьная шестнадцатеричная строка
• Автоматически сгенерирован и уникален
• Не может быть изменен (для безопасности и согласованности отслеживания)
• Кнопка копирования для быстрого копирования

URL кампании

Полный URL кампании формируется как:

Стандартный домен:

https://yourdomain.com/{campaign_token}/

Публичный домен с поддоменом:

https://your-org.publicdomain.com/{campaign_token}/

URL отображается с кнопкой Копировать в списке кампаний.

Публичная статистика

Переключатель для включения/отключения публичного доступа к статистике:

• Включено: Генерирует токен публичной статистики
• Отключено: Нет публичного доступа к статистике кампании

См. раздел Публичная статистика для подробностей.

URL кампании и маршрутизация трафика

Структура URL

Каждая кампания имеет уникальный URL трафика на основе своего токена:

https://{domain}/{campaign_token}/

Пример:

https://track.example.com/a3f8e9d4c2b1a0987654321fedcba9876543210fedcba9876543210fedcba98/

Параметры запроса

Параметры запроса сохраняются и передаются таргетам:

Входящий URL:

https://track.example.com/abc123.../?
  utm_source=facebook&
  utm_campaign=mobile_us&
  click_id=xyz789

URL таргета (после обработки):

https://offer.com/landing?
  utm_source=facebook&
  utm_campaign=mobile_us&
  click_id=xyz789&
  unique_id={tds_click_id}

Система автоматически:

• Сохраняет все исходные параметры запроса
• Добавляет параметр unique_id с идентификатором отслеживания кликов TDS
• Передает параметры через цепочки кампаний

Поддомены публичного домена

При использовании публичного домена каждая организация получает уникальный поддомен:

Поддомен организации:

https://myorg-a1b2.publicdomain.com/{campaign_token}/

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

Процесс обработки трафика

Когда посетитель обращается к URL вашей кампании:

1. Поиск кампании - Система находит кампанию по токену
2. Определение клиента - Извлекает IP, страну, устройство, ОС, браузер, язык
3. Обнаружение ботов - Определяет ботовый трафик с помощью user-agent и IP-паттернов
4. Выбор потока - Выбирает потоки по приоритету (сначала наивысший)
5. Проверка фильтров - Применяет правила фильтрации (страна, устройство и т.д.)
6. Выбор таргета - Выбирает таргет на основе весов
7. Отслеживание кликов - Записывает клик асинхронно (неблокирующий)
8. Редирект - Отправляет посетителя на выбранный URL таргета

Режим автоматического редиректа по маркеру

Режим автоматического редиректа по маркеру позволяет кампании перенаправлять только посетителей, пришедших с правильным URL-параметром (маркером). Трафик без маркера логируется, но редирект не происходит — посетитель остаётся на странице.

Как это работает

1. Вы вставляете небольшой JS-сниппет на лендинг (блог, пре-лендер и т.д.)
2. Сниппет проверяет наличие маркера в URL: ?redirect=VALUE
3. Если правильный маркер есть → очищает URL → делает редирект на офер
4. Если маркера нет → посетитель остаётся на странице (клик всё равно логируется)

Включение режима маркера

1. Откройте детали кампании → вкладка Информация
2. Найдите секцию Режим автоматического редиректа по маркеру
3. Включите Enable Marker Mode
4. При необходимости измените Название URL-параметра (по умолчанию: redirect)
5. Нажмите Save Campaign
6. Уникальное 64-символьное значение маркера генерируется автоматически при первом сохранении

Вставка JS-сниппета

Вкладка Integration в деталях кампании генерирует готовый обфусцированный скрипт. Скопируйте и вставьте его в <head> или <body> вашего лендинга.

Формат URL трафика

https://your-landing-page.com/?redirect=a3f8e9d4c2b1...64chars...

Перегенерация значения маркера

Если ваше значение маркера скомпрометировано, нажмите кнопку Regenerate рядом со значением маркера. Новое значение генерируется мгновенно, старые ссылки перестают работать немедленно.

Публичная статистика

Публичная статистика позволяет вам делиться метриками производительности кампании с внешними сторонами (партнерами, рекламодателями, покупателями трафика) без предоставления им доступа к вашей учетной записи TDS.

Включение публичной статистики

1. Перейдите на страницу детальной информации о кампании
2. Переключитесь на вкладку Информация
3. Найдите раздел Публичная статистика
4. Включите переключатель Включить публичную статистику
5. Автоматически генерируется уникальный токен публичной статистики

Токен публичной статистики

При включении вы увидите:

• Токен публичной статистики: 64-символьный уникальный токен
• Публичный URL: Полный URL для обмена с партнерами
• Кнопка "Перегенерировать": Сгенерировать новый токен (делает старый URL недействительным)
• Кнопка "Копировать": Быстро скопировать публичный URL

Формат URL публичной статистики:

https://yourdomain.com/statistics/public/{public_stats_token}

Что могут видеть партнеры

Страница публичной статистики показывает:

• Всего кликов: Весь полученный трафик
• Уникальных кликов: Уникальные IP посетителей
• Конверсии: Всего отслеженных конверсий
• Боты: Обнаруженный ботовый трафик
• Коэффициент конверсии: Конверсии / Уникальные клики
• Графики временных рядов: Трафик во времени (последние 7/30 дней)
• Географическое распределение: Трафик по странам
• Разбивка по устройствам: Статистика десктоп/мобильные/планшеты

Перегенерация токена

Если вам нужно отозвать доступ:

1. Нажмите кнопку Перегенерировать токен
2. Подтвердите действие
3. Генерируется новый токен
4. Старый публичный URL немедленно становится недействительным
5. Поделитесь новым URL с авторизованными партнерами

Сценарий использования: Удалите доступ бывшего партнера, сохранив статистику для других.

Отключение публичной статистики

Переключите Включить публичную статистику в ВЫКЛ, чтобы:

• Отключить весь публичный доступ
• Сохранить токен (повторное включение использует тот же токен)
• Немедленно сделать публичный URL недействительным

S2S Postback URL (ретрансляция в источник трафика)

Поле S2S Postback URL позволяет Simple TDS автоматически пересылать конверсии обратно в ваш источник трафика (RTB Panda, ClickBaza, PropellerAds и др.) через их S2S постбек-протокол.

Как это работает

1. Источник трафика → TDS: Источник отправляет посетителя с собственным click ID в URL (например, ?clickid=abc123). TDS сохраняет это значение в записи клика.
2. Оффер → TDS → Источник трафика: Когда оффер отправляет постбек конверсии в TDS, система записывает конверсию и сразу отправляет GET-запрос в источник трафика — подставляя макросы с оригинальным click ID и данными конверсии.

Источник трафика ──[?clickid=abc123]──→ URL кампании TDS
Оффер ──[постбек конверсии]──→ TDS /c/postback
TDS ──[upstream S2S]──→ Источник трафика (clickid=abc123, payout=25.00)

Настройка

1. Откройте Настройки кампании → вкладка Информация
2. Найдите поле S2S Postback URL
3. Вставьте шаблон URL постбека от вашего источника трафика, заменив их макросы на названия TDS-макросов в фигурных скобках

Пример (RTB Panda / ClickBaza):

https://postback.rtbpanda.com/postback?clickid={clickid}&payout={payout}&status={status}

Доступные макросы

Любой query-параметр, пришедший с посетителем, автоматически доступен как макрос под своим точным именем в фигурных скобках.

Настройка URL в источнике трафика

В панели источника трафика укажите URL кампании TDS с макросом click ID источника:

https://yourdomain.com/{campaign_token}/?clickid={CLICK_ID}

Замените {CLICK_ID} на реальный макрос сети (RTB Panda использует {CLICK_ID}).

Управление несколькими кампаниями

Просмотр списка кампаний

Список кампаний показывает все ваши кампании с ключевыми метриками:

Столбцы:

• ID: ID кампании в базе данных
• Название: Название кампании (кликабельно для просмотра деталей)
• Описание: Заметки о кампании
• URL: Кнопка копирования URL трафика кампании
• Статус: Переключатель Активна/Неактивна
• Статистика: Встроенные метрики (клики, уникальные, конверсии, боты)
• Создано: Дата создания кампании
• Действия: Кнопки просмотра, редактирования, удаления

Встроенная статистика

Каждая строка кампании показывает статистику в реальном времени:

• 🖱️ Клики (Синий значок): Весь трафик
• 👤 Уникальные (Голубой значок): Уникальные посетители
• 🤖 Боты (Желтый значок): Обнаруженный ботовый трафик
• ✅ Конверсии (Зеленый значок): Всего конверсий

Наведите курсор на значки, чтобы увидеть подсказки с полными описаниями.

Фильтрация и поиск

Используйте панель поиска для поиска кампаний:

Фильтр по названию:

• Введите частичное название кампании
• Поиск без учета регистра
• Нажмите Enter для поиска

Фильтр по статусу:

• Все / Активные / Неактивные
• Выбор из выпадающего списка

Фильтр по домену:

• Фильтр по связанному домену
• Выпадающий список с отображением всех доменов

Действия поиска:

• Кнопка Поиск: Применить фильтры
• Кнопка Очистить: Сбросить все фильтры и перезагрузить все кампании

Сортировка

Нажмите на заголовки столбцов для сортировки:

• ID: По возрастанию/убыванию
• Название: По алфавиту
• Статус: Сначала активные или сначала неактивные
• Создано: Сначала новые/старые

Индикатор сортировки (значок стрелки) показывает текущее направление сортировки.

Массовые операции

Вы можете быстро управлять несколькими кампаниями:

Быстрое переключение статуса:

• Нажмите переключатель в любой строке для активации/деактивации
• Не нужно открывать детали кампании
• Оптимистичное обновление интерфейса (мгновенная обратная связь)
• Валидация: Кампании нужны активные потоки для активации

Копирование URL:

• Нажмите значок копирования в столбце URL
• Уведомление об успехе подтверждает копирование
• URL включает префикс https://

Цепочки кампаний

Цепочки кампаний позволяют вам перенаправлять трафик из одной кампании в другую внутренне без дополнительного HTTP-редиректа. Это позволяет реализовать сложные многоэтапные сценарии распределения трафика.

Что такое цепочки кампаний?

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

Пример использования:

Кампания A (Трафик Facebook)
  ↓
Поток A (Фильтр US Mobile)
  ↓
Таргет: Кампания B ← Вместо внешнего URL
  ↓
Кампания B (Ротация офферов)
  ↓
Поток B (Временной фильтр)
  ↓
Таргет: https://offer.com

Преимущества

• ✅ Без дополнительного редиректа: Один HTTP-редирект к конечному назначению
• ✅ Полное отслеживание: Обе кампании записывают статистику кликов
• ✅ Распространение параметров: Параметры запроса проходят через цепочку
• ✅ Сложная логика: Наслаивайте множественные стратегии фильтрации
• ✅ Изоляция организации: Можно связывать только кампании в одной организации

Как создать цепочку кампаний

1. Создайте таргет со ссылкой на кампанию:
   • Перейдите на страницу Таргеты
   • Нажмите "Создать таргет"
   • Выберите тип: Цепочка кампаний
   • Выберите целевую кампанию из выпадающего списка
   • Сохраните таргет
2. Свяжите таргет с потоком:
   • Перейдите на страницу детальной информации о потоке кампании
   • В разделе Таргеты добавьте таргет цепочки кампаний
   • Установите вес (если используются несколько таргетов)
   • Сохранить
3. Активируйте обе кампании:
   • Исходная кампания должна быть активной
   • Целевая кампания должна быть активной
   • Обе должны иметь активные потоки

Ограничения цепочки

• Максимальная глубина: 5 уровней (A→B→C→D→E)
• Предотвращение циклов: Система обнаруживает круговые цепочки (A→B→A блокируется)
• Та же организация: Нельзя связывать кампании из других организаций
• Производительность: Каждый уровень цепочки добавляет ~50мс времени обработки

Отслеживание кликов в цепочках

Каждая кампания в цепочке записывает клик с метаданными:

Клик кампании A:

{
  campaign_id: 1,
  source_campaign_id: null,  // Прямой трафик
  chain_depth: 0
}

Клик кампании B:

{
  campaign_id: 2,
  source_campaign_id: 1,     // Пришел из кампании A
  chain_depth: 1             // Первый уровень в цепочке
}

Это позволяет вам анализировать производительность цепочки и показатели отсева.

Лучшие практики

Организация кампаний

Соглашения об именовании

Используйте последовательные шаблоны именования:

{Источник}-{ГЕО}-{Устройство}-{Квартал}
Примеры:
- FB-US-Mobile-Q4
- Google-EU-Desktop-BlackFriday
- Native-Worldwide-All-Evergreen

Структура кампании

• Одна кампания на источник трафика: Разделите Facebook, Google, нативную рекламу
• Кампании для конкретных гео: Разделите по странам для лучшего таргетинга
• Для конкретных устройств: Мобильные vs Десктоп для разных офферов
• Сезонные кампании: Создавайте новые кампании для акций/событий

Оптимизация производительности

Минимизируйте потоки

• Держите максимум 3-5 потоков на кампанию
• Больше потоков = более длительное время обработки
• Используйте группы фильтров вместо многих потоков

Эффективность кэширования

• Кампании кэшируются на 60 секунд
• Кампании с высоким трафиком остаются в кэше
• Автоматическое уменьшение запросов к базе данных

Стратегия доменов

• Используйте отдельные домены для разных источников трафика
• Ротируйте домены, чтобы избежать блокировки
• Мониторьте состояние доменов (SSL, DNS)

Безопасность

Защита токенов

• Никогда не делитесь токенами кампаний публично
• Токены постоянны (не могут быть изменены)
• Используйте публичную статистику для обмена метриками

Публичная статистика

• Включайте только при необходимости
• Перегенерируйте токены при удалении доступа партнера
• Мониторьте доступ к публичной статистике в логах

Контроль доступа

• Используйте изоляцию на уровне организации
• Разные команды = разные организации
• Назначайте роли пользователей соответствующим образом (admin/manager/user)

Управление трафиком

Тестирование перед запуском

1. Создайте кампанию (неактивную)
2. Добавьте потоки с фильтрами
3. Добавьте тестовые таргеты
4. Протестируйте с образцом трафика
5. Проверьте отслеживание кликов
6. Активируйте, когда готово

Постепенная активация

• Начните с небольшого объема трафика
• Мониторьте статистику в течение 24 часов
• Проверяйте паттерны ботового трафика
• Постепенно масштабируйте

A/B тестирование

• Создайте две кампании с разными конфигурациями потоков
• Разделите трафик 50/50 с помощью внешней ротации
• Сравните коэффициенты конверсии
• Оптимизируйте на основе результатов

Мониторинг

Ключевые метрики для отслеживания

• Коэффициент уникальных кликов: Должен быть 60-90% от общего количества кликов
• Процент ботов: Должен быть менее 10% для качественного трафика
• Коэффициент конверсии: Отслеживайте по кампании, потоку и таргету
• Время отклика: Обработка кампании должна быть менее 200мс

Ежедневные проверки

• Просмотрите производительность топовых кампаний
• Проверьте необычные всплески ботового трафика
• Убедитесь, что отслеживание конверсий работает
• Мониторьте состояние домена и статус SSL

Еженедельный анализ

• Сравните производительность кампаний неделя к неделе
• Определите наиболее эффективные потоки и таргеты
• Настройте веса и фильтры на основе данных
• Архивируйте или удаляйте неактивные кампании

Решение проблем

Кампания не активируется

URL кампании не работает

Проблема: URL кампании возвращает 404 или ошибку

Проверьте:

• Кампания Активна (переключатель в списке кампаний)
• Домен Активен и DNS настроен правильно
• Токен в URL точно совпадает с токеном кампании (с учетом регистра)
• URL заканчивается косой чертой /

Правильный формат:

https://domain.com/{exact-token}/

Проблема: URL кампании перенаправляет на неправильный таргет

Проверьте:

• Порядок приоритета потоков (более высокий приоритет обрабатывается первым)
• Правила фильтров (трафик может не соответствовать ожидаемому потоку)
• Веса таргетов (взвешенный случайный выбор)
• Фильтры даты/времени (могут активироваться в определенное время)

Статистика не обновляется

Проблема: Счетчик кликов равен 0, несмотря на трафик

Проверьте:

• Кампания Активна
• Браузер не блокирует URL трафика
• Проверьте обнаружение ботов (боты не считаются как обычные клики)
• Убедитесь, что IP не находится в фильтрах черного списка

Проблемы с публичной статистикой

Проблема: URL публичной статистики показывает ошибку

Проверьте:

• Публичная статистика Включена
• Токен в URL правильный (перегенерация создает новый токен)
• Формат URL: /statistics/public/{token} (без campaign_id)

Проблема: Партнер не может получить доступ к статистике

Решение:

• Скопируйте точный URL со страницы детальной информации о кампании
• Убедитесь, что переключатель публичной статистики ВКЛ (зеленый)
• Проверьте, не был ли перегенерирован токен (старые URL становятся недействительными)
• Убедитесь, что у кампании есть статистика для отображения

Проблемы с цепочками кампаний

Проблема: Таргет цепочки возвращает ошибку

Проверьте:

• Целевая кампания существует и Активна
• Целевая кампания имеет хотя бы один активный поток
• Обе кампании принадлежат одной организации
• Глубина цепочки не превышает 5 уровней
• Нет круговой цепочки (A→B→A)

Проблема: Статистика показывает двойные клики

Связанная документация

• Управление потоками - Создание и настройка потоков трафика
• Управление таргетами - Настройка URL назначения и цепочек кампаний
• Система фильтров - Правила и логика фильтрации трафика
• Статистика - Аналитика и отчетность
• Управление доменами - Конфигурация доменов и SSL

Краткая справка

Состояния кампании

Форматы URL

Горячие клавиши