Ключові поняття

Короткий словник, щоб решта документації читалася без запинки. Терміни впорядковані від «що показуємо» до «як рахуємо».

Воркспейс

Простір, у якому живе ваша команда, PWA, потоки, домени та кампанії. Усі ресурси й баланс належать воркспейсу, а не окремому користувачу. Учасників запрошують з ролями та правами.

PWA

Прогресивний веб-застосунок з інсталяційною сторінкою у стилі Google Play або App Store. Користувач відкриває сторінку, встановлює застосунок і переходить до офера за налаштованим сценарієм. У PWA Editor → Config зберігаються іконка, взаємодія на iOS, push prompt і webview-bypass. Один воркспейс може мати багато PWA під різні GEO та вертикалі.

Direct Link (пряме посилання)

Альтернативна ціль правила потоку без сторінки у стилі магазину. Трафік залишається в тому самому флоу з правилами, клоакою та аналітикою, а після вибору Direct Link одразу переходить на офер.

Direct Link може додатково використовувати webview-bypass, push-запит та Mini-PWA. Він не успадковує налаштування PWA або Stream: ці параметри зберігаються окремо в Direct Link. Це повноцінна альтернатива PWA для аудиторій, яких може насторожувати сторінка у стилі магазину або зайвий крок інсталяції.

Потік (Stream)

Головна одиниця маршрутизації трафіку. Потік зв'язує домени з правилами вибору PWA або Direct Link, клоакінгом і трек-посиланнями на офер. Він не керує поведінкою PWA. Саме домен активного потоку баєр ставить у рекламну кампанію. Якщо офером є Keitaro, Campaign URL додається в трек-посилання потоку. Детальніше — Потоки.

Домен

Адреса, на якій обслуговується потік. Домен можна купити прямо на платформі (DNS налаштовується автоматично) або підключити власний через CNAME. Домен має пройти шлях DNS → SSL → Активний, перш ніж почне маршрутизувати трафік. Детальніше — Домени.

Клоакінг

Налаштування клоаки на рівні потоку: режим, дозволені ОС, анонімайзери та вайтпейдж. Детальніше — Клоакінг.

Вайтпейдж (whitepage)

«Біла» сторінка, яку бачить заблокований або модераторський трафік замість офера. Може бути порожньою (410), редиректом на зовнішній URL, згенерованою сторінкою fantasy-застосунку, лістингом з реального стору або AI-сторінкою з розділу AI Вайтпейджі.

Офер

URL, куди в підсумку йде конверсійний трафік, часто з макросами на кшталт {click_id}. Це може бути прямий URL партнерської програми або Campaign URL Keitaro. Офери зберігаються в бібліотеці, щоб не вводити URL вручну щоразу, і підставляються у трек-посилання потоку.

click_id

Власний ідентифікатор, який darkcore генерує на кожен клік. Це ключ, за яким пізніше зіставляються всі події. Щоб трекер зміг повернути конверсію, click_id треба прокинути в URL офера через макрос {click_id}: трекер збереже його і віддасть назад у постбеку.

Постбек (postback)

Серверний обмін подіями по HTTP (s2s):

• Вхідний — трекер або партнерка повідомляє darkcore про конверсію (реєстрація, депозит) на адресу /p.
• Вихідний — darkcore пересилає конверсію назад у ваш трекер за шаблоном, налаштованим на потоці.

Детальніше — Постбеки потоку та Інтеграція з Keitaro.

Тип конверсії

Іменований статус конверсії у вашому воркспейсі: registration, deposit та будь-які власні (наприклад redep). Кожен тип має ключ (незмінний), аліаси (як його називає трекер: reg, ftd, sale) і прапорець, чи рахувати його в дохід. Детальніше — Типи конверсій.

Піксель

Інтеграція Facebook, TikTok або Google Ads, прив'язана до потоку. Встановлення, реєстрація й депозит надсилаються у рекламний кабінет через налаштований канал платформи; для Google це sGTM або Data Manager API. Детальніше — Пікселі.

Макрос

Підстановка виду {click_id}, {payout}, {geo}, {sub1}, яку darkcore замінює на реальне значення при формуванні offer URL і вихідних постбеків. Повний перелік — Довідник макросів.