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

Кампанія — це основна одиниця трекінгу. Вона обʼєднує трафік, домен, який відкривають відвідувачі, налаштування вартості для звітів і потоки, які визначають, що отримає кожен відвідувач.

Створюйте одну кампанію, коли вам потрібен один спільний звіт для конкретного джерела трафіку та офер. Наприклад, якщо ви купуєте трафік для одного продукту в одній рекламній мережі, створіть одну кампанію для цього налаштування. Якщо пізніше ви просуваєте інший продукт, використовуєте інше джерело трафіку або хочете окремий звіт, створіть окрему кампанію.

Ця стаття пояснює, як створити кампанію Aureon Pulse Ring, налаштувати потоки для Франції та решти світу, підключити домен кампанії та перевірити, що трафік доходить до очікуваної цілі.

Основні поняття

Перед створенням кампанії варто розуміти основні терміни з цього гайду.

Термін	Значення
Кампанія	Контейнер трекінгу для одного джерела трафіку та одного оферу. Він зберігає налаштування вартості, мапінг статусів, резервний потік і контекст для звітів.
Домен кампанії	Публічний домен або піддомен, який відкривають відвідувачі після кліку на рекламу або трекінгове посилання. Він має вказувати на сервер трекера через DNS-запис A.
Потік	Шлях усередині кампанії. Потік визначає, що отримає відвідувач, відповідно правилам потоку.
Лендинг	Сторінка, яку бачить відвідувач. У цьому гайді потоки з режимом Render використовують ZIP-архів із файлами лендингу.
Redirect	Режим, у якому трекер записує візит і перенаправляє браузер на зовнішній URL.
Render	Режим, у якому трекер відображає лендинг. ZIP-архів лендингу має містити index.php у корені.
Правило	Умова, яка визначає, коли потік може отримати відвідувача. У цьому гайді використовуються приклади правил за країною.
Postback-інтеграція	Server-to-server запит від рекламодавця або партнерської системи назад до трекера. Він повідомляє трекеру, що відбулася конверсія, і інформує про статус конверсії.

Трекер обробляє візит кампанії у такій послідовності:

1. Відвідувач відкриває домен кампанії у браузері.
2. Трекер знаходить кампанію, привʼязану до цього домену.
3. Трекер визначає атрибути відвідувача, наприклад IP-адресу, країну, тип пристрою і браузер.
4. Трекер перевіряє увімкнені потоки та їхні правила.
5. Трекер вибирає перший потік, правило якого спрацювало.
6. Трекер відображає лендинг або перенаправляє відвідувача на зовнішній URL.
7. Трекер реєструє дані візиту відповідно до налаштувань кампанії.

У прикладі використовується кампанія Aureon Pulse Ring з двома потоками:

• потік для Франції: country == "FR"
• глобальний потік: country != "FR"

Обидва потоки використовують один домен кампанії:

aureon-pulse-ring.home-and-outdoor.shop

Передумови

Перед початком перевірте, що у вас є потрібний доступ і дані.

Вимога	Опис	Як перевірити
Встановлений трекер	Трекер встановлено і запущено	Відкрийте URL панелі керування
Доступ до панелі керування	Ви можете увійти в панель керування трекера	Увійдіть з обліковим записом панелі
Домен кампанії	У вас є домен або піддомен для трафіку кампанії	Відкрийте налаштування DNS у провайдера домену
Доступ до DNS	Ви можете створювати або редагувати DNS-записи	Перевірте записи у провайдера домену
IP2Location database	Визначення країни налаштовано	Переконайтеся, що інсталятор завершив налаштування IP2Location
Архів лендингу	ZIP-архів із файлами лендингу	Переконайтеся, що архів містить index.php у корені

Крок 1: Створіть кампанію

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

У прикладі Aureon Pulse Ring кампанія приймає трафік на одному домені кампанії та направляє відвідувачів на один із двох лендингів:

• Відвідувачі з Франції отримують французький лендинг.
• Відвідувачі не з Франції отримують глобальний лендинг.

Поля кампанії

Поле	Опис	Приклад використання
Cost Model	Визначає, як трекер рахує вартість трафіку для кампанії.	Виберіть модель, яка відповідає оплаті у вашому джерелі трафіку. Для CPA-кампаній зазвичай це CPA.
Cost Value	Визначає числове значення вартості для вибраної моделі.	Вкажіть вартість за візит, клік або дію залежно від вибраної моделі.
Currency	Визначає валюту для вартості та звітів кампанії.	Використовуйте USD, EUR або іншу підтримувану валюту.
Status Mapper	Необовʼязковий мапінг статусів postback-запитів із зовнішньої системи.	Замапте статуси рекламодавця у статуси трекера: accept, expect, reject або trash.
Default Flow	Визначає резервний потік, якщо жодне правило увімкненого потоку не підійшло для відвідувача.	Виберіть глобальний потік, щоб трафік без збігу все одно отримував цільову сторінку.

Status Mapper і postback-запити

Status Mapper не потрібен для базової кампанії. Використовуйте його, коли інтегруєте трекер з рекламодавцем, партнерською мережею, CRM або іншою зовнішньою системою, яка надсилає postback-запити.

Postback — це server-to-server запит із зовнішньої системи до трекера. Зазвичай він відбувається після конверсії відвідувача. Наприклад, відвідувач клікає посилання кампанії, переходить на офер, відправляє форму ліда, а система рекламодавця викликає postback URL трекера, щоб повідомити про конверсію.

Використовуйте такий формат postback URL у системі рекламодавця:

https://dashboard.<your-domain>/api/v2/track/postback?clickId=<clickId>&status=<status>

API-параметр має називатися clickId. Замініть <clickId> і <status> на синтаксис плейсхолдерів із системи рекламодавця.

Параметр status повідомляє трекеру, що сталося з конверсією. Зовнішні системи можуть використовувати різні назви статусів, наприклад approved, sale, pending, rejected або duplicate. Трекер зберігає статуси у чотирьох внутрішніх значеннях:

Статус трекера	Коли використовувати
accept	Конверсія підтверджена і має рахуватися як прийнятий дохід.
expect	Конверсія очікує підтвердження.
reject	Конверсія відхилена і не має рахуватися як прийнятий дохід.
trash	Конверсія невалідна, дубльована, тестова або має бути виключена зі звичайних звітів.

Приклад мапінгу:

Вхідне значення status	Статус трекера
approved	accept
sale	accept
pending	expect
rejected	reject
duplicate	trash

Приклад JSON:

{
  "parameter": "status",
  "mapping": {
    "approved": "accept",
    "sale": "accept",
    "pending": "expect",
    "rejected": "reject",
    "duplicate": "trash"
  }
}

Значення parameter повідомляє трекеру, який параметр postback-запиту містить зовнішній статус. Обʼєкт mapping перекладає статуси рекламодавця у статуси трекера.

Цей мапінг визначає, як результати postback-запитів впливають на звіти кампанії. Він допомагає трекеру розділяти прийнятий дохід, очікуваний дохід, відхилені ліди та невалідні або дубльовані конверсії.

Створіть кампанію

1. Відкрийте панель керування трекера.
2. Перейдіть до Campaigns.
3. Створіть нову кампанію.

4. Встановіть назву кампанії:

   Aureon Pulse Ring

5. Налаштуйте поля вартості кампанії:

   Поле	Значення
   Cost Model	Виберіть CPA, якщо кампанія оплачується за підтверджену дію
   Cost Value	Введіть числове значення вартості
   Currency	Виберіть валюту для звітів

6. Налаштуйте Status Mapper тільки якщо кампанія отримує postback-запити або оновлення статусів із зовнішньої системи.

7. Збережіть кампанію.

Після збереження перевірте, що кампанія відображається у списку і відкривається без помилок валідації.

Крок 2: Створіть потоки

Потік — це шлях усередині кампанії. Він визначає, що трекер зробить із відвідувачем після того, як відвідувач відкриє домен кампанії.

Потоки корисні, бо не всі відвідувачі завжди мають отримувати одну й ту саму ціль. Наприклад, відвідувачі з однієї країни можуть бачити локальну пропозицію, відвідувачі з іншої країни — глобальну пропозицію, а повторні відвідувачі можуть побачити інший лендинг, якщо не сконвертувалися першого разу.

Кожен потік має дві важливі частини:

Частина	Значення
Ціль	Визначає, чи трекер перенаправить відвідувача на зовнішній URL, чи покаже локальний архів лендингу.
Правило	Умова, яка визначає, коли потік може бути вибраний.

Redirect або Render

Redirect/render керує тим, як трекер доставляє ціль потоку.

Використовуйте Redirect, коли лендинг або сторінка оферу розміщена поза трекером. У цьому режимі трекер приймає відвідувача, записує його і перенаправляє браузер на Redirect URL.

Використовуйте Render, коли лендинг завантажений у трекер як ZIP-архів. У цьому режимі відвідувач залишається на домені кампанії, а трекер відображає лендинг.

У цьому прикладі обидва потоки використовують вкладку Render file і вибирають ZIP-архів із лендингом.

Режим	Що отримує відвідувач	Обовʼязкове поле
Redirect	Браузер переходить на зовнішній URL	Redirect URL, наприклад https://aureon.com/pulse-ring
Render	Браузер отримує архів лендингу від трекера	Render file, ZIP-архів з index.php у корені

Правила

Правило визначає, коли потік може отримати відвідувача. Трекер перевіряє увімкнені потоки і вибирає перший потік, правило якого спрацювало.

У цьому гайді використовуються два приклади правил за країною:

Правило	Значення
country == "FR"	Відвідувач із визначеною країною Франція.
country != "FR"	Відвідувач із визначеною країною не Франція.

Правила можуть підтримувати складніший роутинг, ніж у цьому прикладі. Роутинг за країною використовується тут тільки для простої ілюстрації правил.

Повторний показ: Show only once per visitor

Show only once per visitor обмежує, як часто той самий відвідувач може отримати той самий потік.

Використовуйте цю опцію, коли у вас є кілька лендингів і ви хочете, щоб повторні відвідувачі з часом проходили через різні варіанти. Наприклад, якщо відвідувач сьогодні побачив перший лендинг і не став лідом, наступний візит може пропустити цей перший потік і дозволити іншому потоку спрацювати. Так інший лендинг отримує шанс сконвертувати того самого відвідувача.

Крок 2.1: Створіть потік для Франції

Створіть перший потік для відвідувачів із Франції.

1. Відкрийте кампанію Aureon Pulse Ring.
2. Створіть новий потік.

3. Заповніть форму:

   Поле	Значення
   Redirect/render	Виберіть Render
   Render file	Виберіть ZIP-архів для французького лендингу
   Rule	country == "FR"
   Show only once per visitor	Оскільки для Франції у нас лише один лендинг, залиште неактивним

4. Збережіть потік.

5. Перевірте, що правило відображається як:

   country == "FR"

Крок 2.2: Створіть глобальний потік

Створіть другий потік для відвідувачів не з Франції.

1. Відкрийте кампанію Aureon Pulse Ring.
2. Створіть ще один потік.

3. Заповніть форму:

   Поле	Значення
   Redirect/render	Виберіть Render
   Render file	Виберіть ZIP-архів для глобального лендингу
   Rule	country != "FR"
   Show only once per visitor	Оскільки у нас лише один глобальний лендинг, залиште неактивним

4. Збережіть потік.

5. Перевірте, що правило відображається як:

   country != "FR"

Крок 3: Встановіть резервний потік

Встановіть Default Flow, щоб визначити резервну поведінку.

1. Відкрийте кампанію Aureon Pulse Ring.
2. Знайдіть Default Flow.
3. Виберіть глобальний потік для трафіку без збігу.
4. Збережіть кампанію.

Резервний потік потрібен, коли правила не покривають усі можливі стани відвідувача. У цьому прикладі country != "FR" покриває визначений трафік не з Франції, але резервний потік також захищає кампанію, якщо визначення країни не спрацює або правила потоків зміняться пізніше.

Крок 4: Налаштуйте домен кампанії

Домен кампанії — це публічне імʼя хоста, яке відкривають відвідувачі. Він має вказувати на сервер трекера через DNS-запис A і мати призначення Campaign у трекері.

Налаштовуйте домен кампанії після того, як кампанія і потоки збережені. Це підключає публічний браузерний трафік до роутингу кампанії. Один і той самий домен може показувати різні лендинги або перенаправлення, тому що трекер перевіряє атрибути відвідувача перед вибором потоку.

Це налаштування схоже на налаштування домену панелі керування:

1. Створіть DNS-запис A у провайдера домену.
2. Додайте домен у панелі керування трекера.
3. Встановіть призначення домену Campaign.
4. Виберіть кампанію, яка має отримувати трафік із цього домену.

Приклад домену кампанії:

aureon-pulse-ring.home-and-outdoor.shop

1. Відкрийте сторінку керування DNS для вашого домену.
2. Додайте запис A для імені хоста кампанії.

3. Заповніть значення запису:

   Поле	Значення
   Type	A
   Name	aureon-pulse-ring
   Value	<server-ip>
   Time to Live (TTL)	Значення за замовчуванням від DNS-провайдера

4. Збережіть DNS-запис.

5. Відкрийте панель керування трекера.
6. Перейдіть до Domains.
7. Створіть новий домен.

8. Встановіть Hostname:

   aureon-pulse-ring.home-and-outdoor.shop

9. Встановіть Purpose у Campaign.

10. Привʼяжіть або виберіть кампанію Aureon Pulse Ring, щоб повʼязати домен із кампанією.
11. Збережіть домен.
12. Відкрийте збережений запис домену кампанії у панелі керування.
13. Зачекайте, доки статус домену покаже, що DNS і випуск сертифікату завершені.

Очікувані значення статусу домену:

Поле	Очікуване значення	Значення
A Record	Set	DNS вказує імʼя хоста на сервер трекера
Certificate / Status	Active	Трекер випустив і встановив HTTPS-сертифікат
CA	letsencrypt	Сертифікат випущений Let's Encrypt

Оновлення DNS і випуск сертифікату можуть зайняти час. Трекер може випустити сертифікат тільки після того, як домен вказує на сервер трекера.

Крок 5: Відкрийте домен кампанії

Відкрийте домен кампанії у браузері після того, як сертифікат стане активним:

https://aureon-pulse-ring.home-and-outdoor.shop

Коли запит приходить із Франції, той самий домен показує французький лендинг.

Коли запит приходить з іншої країни, той самий домен показує глобальний лендинг.

Перевірка

Використовуйте такі перевірки для валідації налаштування.

Перевірка	Очікуваний результат
Кампанія існує	Aureon Pulse Ring відкривається в панелі керування
Потік для Франції існує	Правило потоку — country == "FR"
Глобальний потік існує	Правило потоку — country != "FR"
Резервний потік встановлено	Кампанія має резервний потік
Домен кампанії резолвиться	DNS-запис A (aureon-pulse-ring.home-and-outdoor.shop) вказує на <server-ip>
Сертифікат активний	Домен кампанії відкривається через HTTPS без попередження браузера про сертифікат
Трафік із Франції	Браузер показує французький лендинг
Трафік не з Франції	Браузер показує глобальний лендинг

Можливі складнощі

• Якщо визначення країни не спрацює, трекер може використати резервний потік.
• Якщо кілька увімкнених потоків підходять для одного відвідувача, порядок потоків може вплинути на вибрану ціль.
• Якщо жоден потік не збігся і резервний потік не встановлений, відвідувач може отримати порожню сторінку.
• Якщо Show only once per visitor увімкнено, повторні візити того самого відвідувача можуть пропустити цей потік.
• Якщо сертифікат не активний, браузер може показати HTTPS-попередження або не відкрити домен.

Вирішення проблем

Проблема	Причина	Рішення
Домен кампанії не відкривається	DNS не вказує на сервер трекера	Перевірте значення DNS-запису A і зачекайте на оновлення DNS
Браузер показує попередження про сертифікат	HTTPS-сертифікат не активний	Перевірте, що A Record має значення Set, потім зачекайте завершення випуску сертифікату
Відвідувач із Франції бачить глобальний лендинг	Визначення країни не повертає FR, або потік для Франції вимкнений	Перевірте геолокацію IP, статус потоку і правило country == "FR"
Відвідувач не з Франції бачить французький лендинг	Правило налаштовано неправильно	Перевірте, що потік для Франції використовує country == "FR", а глобальний потік використовує country != "FR"
Відвідувач отримує порожню сторінку	Немає увімкненого потоку, який збігається, і резервний потік не встановлений	Встановіть Default Flow у глобальний потік
Потік з Redirect не відкриває ціль	Redirect URL відсутній або має неправильний формат	Використовуйте повний URL з https:// або http://
Потік з Render не показує сторінку	Архів Render file відсутній, недоступний або не містить index.php у корені	Завантажте ZIP-архів з index.php у корені