Посібник з управління кампаніями

Що таке кампанія?

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

Ключові концепції

• Унікальний токен: Кожна кампанія отримує унікальний 64-символьний токен, який автоматично генерується при створенні
• Точка входу трафіку: URL кампанії - це місце, куди ви надсилаєте свій трафік
• Контейнер потоків: Кампанії містять один або більше потоків, які обробляють і фільтрують трафік
• Відстеження статистики: Кожна кампанія відстежує кліки, унікальних відвідувачів, конверсії та бот-трафік
• Прив'язка до домену: Кожна кампанія повинна бути пов'язана з активним доменом

Життєвий цикл кампанії

Створити кампанію → Вибрати домен → Додати потоки → Налаштувати фільтри → Додати таргети → Активувати → Надіслати трафік

Кампанія може бути:

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

Створення кампанії

Передумови

Перед створенням кампанії у вас повинно бути:

Покроковий посібник

1. Перейдіть на сторінку кампаній

У головному меню натисніть Кампанії, щоб переглянути список ваших кампаній.

2. Натисніть кнопку "Створити кампанію"

Натисніть кнопку + Створити кампанію у верхньому правому куті.

3. Заповніть деталі кампанії

Назва кампанії (обов'язково)

• Описова назва для внутрішнього використання
• Приклад: "Facebook Мобільні США", "Google Десктоп ЄС", "Нативний трафік 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 з 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. Якщо маркера немає → відвідувач залишається на сторінці (клік все одно логується)

URL лендингу (з маркером):
https://your-blog.com/article/?redirect=a3f8e9d4c2b1...

                    ↓ JS-сніпет перевіряє маркер
                    ↓ Видаляє ?redirect=... з адресного рядка (history.replaceState)
                    ↓ Відправляє AJAX-запит на TDS-сервер

Рішення TDS-сервера:
  маркер є     → редіректити → браузер переходить на офер
  маркера нема → no-redirect → відвідувач залишається

Увімкнення режиму маркера

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

Налаштування кампанії

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

Вкладка Integration у деталях кампанії генерує готовий обфускований скрипт. Скопіюйте та вставте його в <head> або <body> вашого лендингу:

<script>(function(_0xa,_0xb,_0xc){var _0xd=function(s){return atob(s)};
window.TDS_URL=_0xd(_0xa);window.TDS_MARKER_KEY=_0xd(_0xc);
var _0xe=document.createElement('script');_0xe.src=_0xd(_0xb);
document.head.appendChild(_0xe);})('BASE64_URL','BASE64_SCRIPT','BASE64_KEY')</script>

Після розшифровки цей скрипт:

• Встановлює window.TDS_URL на URL вашої кампанії
• Встановлює window.TDS_MARKER_KEY на назву маркера (redirect)
• Динамічно завантажує tds-redirect-v2.js з вашого TDS-сервера

Формат URL трафіку

Надсилаючи трафік на лендинг, додайте маркер до URL:

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

Вкладка Integration показує приклад цього URL з вашим реальним значенням маркера.

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

Якщо ваше значення маркера скомпрометоване (хтось копіює ваші URL трафіку):

1. Натисніть кнопку Regenerate поруч зі значенням маркера
2. Підтвердьте дію
3. Нове 64-символьне значення генерується негайно
4. Старе значення маркера перестає працювати миттєво
5. Оновіть всі посилання трафіку з новим значенням маркера

Усунення несправностей режиму маркера

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

Публічна статистика дозволяє вам ділитися метриками продуктивності кампанії із зовнішніми сторонами (партнерами, рекламодавцями, покупцями трафіку) без надання їм доступу до вашого облікового запису 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: За зростанням/спаданням
• Назва: За алфавітом
• Статус: Спочатку активні або спочатку неактивні
• Створено: Спочатку найновіші/найстаріші

Індикатор сортування (іконка стрілки) показує поточний напрямок сортування.

Масові операції

Ви можете швидко керувати кількома кампаніями:

Швидке переключення статусу:

• Натисніть перемикач у будь-якому рядку для активації/деактивації
• Не потрібно відкривати деталі кампанії
• Оптимістичне оновлення UI (миттєвий зворотний зв'язок)
• Перевірка: Кампанії потрібні активні потоки для активації

Копіювання URL:

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

Ланцюжки кампаній

Ланцюжки кампаній дозволяють направляти трафік з однієї кампанії в іншу внутрішньо без додаткового HTTP-перенаправлення. Це забезпечує складні багатокрокові сценарії розподілу трафіку.

Що таке ланцюжки кампаній?

Замість перенаправлення на зовнішній URL, таргет може вказувати на іншу кампанію в межах вашої організації. Коли трафік потрапляє на цей таргет, він обробляється другою кампанією прозоро.

Приклад використання:

Кампанія A (Трафік з Facebook)
  ↓
Потік A (Фільтр США Мобільні)
  ↓
Таргет: Кампанія 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, нативна реклама
• Геоспецифічні кампанії: Розділіть за країною для кращого таргетингу
• Специфічні для пристроїв: Мобільні проти десктопних для різних офферів
• Сезонні кампанії: Створюйте нові кампанії для промоакцій/подій

Оптимізація продуктивності

Мінімізувати потоки

• Тримайте максимум 3-5 потоків на кампанію
• Більше потоків = довший час обробки
• Використовуйте групи фільтрів замість багатьох потоків

Ефективність кешу

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

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

• Використовуйте окремі домени для різних джерел трафіку
• Ротуйте домени, щоб уникнути блокування
• Моніторте здоров'я доменів (SSL, DNS)

Безпека

Захист токена

• Ніколи не діліться токенами кампаній публічно
• Токени постійні (не можуть бути змінені)
• Використовуйте публічну статистику для спільного використання метрик

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

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

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

• Використовуйте ізоляцію на рівні організації
• Різні команди = різні організації
• Призначайте ролі користувачів відповідно (адмін/менеджер/користувач)

Управління трафіком

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

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

Гарячі клавіші