Глосарій термінів Adset.Pro

Повний довідник термінів, що використовуються в трекері Adset.Pro, з прив'язкою до внутрішніх сутностей системи, мовних файлів (i18n) та кодових ідентифікаторів. Призначений для MCP-асистента, баєрів та всіх учасників команди.

Ключова термінологія Adset.Pro

Критично важливо розуміти різницю між пікселями та постбеками в контексті Adset.Pro:

Постбек (Postback) — ВХІДНИЙ сигнал

Постбек — це HTTP-запит, який приходить В Adset.Pro ІЗ партнерських мереж (CPA-мереж). Партнерка повідомляє трекеру про те, що відбулася цільова дія (реєстрація, депозит, повторний депозит тощо).

• Напрямок: CPA-мережа → Adset.Pro

• Містить: click_id, status, payout, currency

• Обробляє: PostBackController (/postback endpoint)

• В UI: Tracker → CPA → вкладка «Постбек»

• i18n: Постбек, Завантажити постбеки, URL постбеку, Шаблон статусу постбеку

Піксель (Pixel) — ВИХІДНИЙ сигнал

Піксель — це HTTP-запит або API-виклик, який надсилається ІЗ Adset.Pro В джерела трафіку (Facebook, TikTok тощо). Трекер повідомляє рекламній платформі про конверсійну подію для оптимізації алгоритмів.

• Напрямок: Adset.Pro → Джерело трафіку (Facebook, TikTok, URL, Telegram)

• Типи (PixelType enum): facebook, tiktok, url (HTTP Get), telegram_bot

• В UI: Tracker → Pixels (розділ «Пікселі та постбеки»)

• i18n: Пікселі та постбеки, Піксель, ID пікселя, Токен доступу до пікселя

Зведена таблиця напрямків

---

Сутності трекера (Tracker Entities)

Кампанія (Campaign)

Основна сутність, що об'єднує всі налаштування для запуску трафіку. Містить: домен, джерело, стрім-сети з фільтрами (клоакою), потоки (flows, офер лінки), пікселі, PWA, лендинги.

• i18n: Кампанії, Кампанію, Нова кампанія

• Код: cmp_campaign (статистика)

• Синоніми MCP: campaign, кампания → cmp_campaign

CPA (Партнерська мережа)

Сутність, що представляє партнерську мережу / рекламодавця, а також інший трекер (наприклад, Keitaro), який стоїть у ланцюжку після Adset.Pro, але перед кінцевою партнерською програмою. Зберігає мапінг статусів, postback macros, param template, валюту.

• i18n: Партнерські мережі, Партнерська мережа

• Код: cmp_cpa (статистика)

• Синоніми MCP: cpa, партнёрка, affiliate network

• Приклади: пряма партнерка (1win, Pin-Up), або проміжний трекер (Keitaro, Binom), що стоїть перед партнерською програмою

Офер (Offer)

Конкретна пропозиція (продукт, послуга, додаток) від партнерської мережі. Прив'язаний до CPA. Має тип, ставку (revenue), країни, мову.

• Revenue (Базовий дохід) — дефолтна ціна офера, що використовується при розрахунку доходу, якщо партнерка не передає суму revenue в постбеку. Коли постбек містить поле revenue — використовується значення з постбеку.

• i18n: Офери, Офер, Назва оферу, Базовий дохід

• Типи оферів (OfferType): cpa (партнерський), agency (агентський)

• Код: cmp_offer, cmp_offer_type

• Синоніми MCP: offer, оффер → cmp_offer

Flow (Посилання на офер / Потік)

URL-адреса, куди направляється трафік. Прив'язаний до CPA та Offer. Може бути зовнішнім (external URL), внутрішнім (завантажений ZIP) або Telegram-каналом.

• i18n: Посилання на офери, Посилання на офер, Референсне посилання на офер

• Код: cmp_flow

• Синоніми MCP: flow, поток, ссылка на оффер → cmp_flow

Джерело трафіку (Source)

Рекламна платформа, звідки приходить трафік: Facebook, TikTok, Google, нативні мережі тощо. Визначає шаблон параметрів, UTM-мапінг, зовнішній Click ID.

• i18n: Джерела трафіку, Джерело, Назва джерела трафіку

• Код: cmp_source

• Синоніми MCP: source, источник, traffic source → cmp_source

Сет (Set / Stream Set)

Набір фільтрів і напрямків всередині кампанії. Визначає, який трафік куди направляється. Кампанія може містити кілька сетів.

• Фільтри: налаштовуються умови (ГЕО, пристрій, ОС, мова, параметри), за якими трафік розподіляється між сетами

• Пікселі: до кожного сету прив'язуються пікселі, які будуть викликатися при отриманні конверсій (постбеків) на даному потоці трафіку. Це дозволяє надсилати різні події в різні джерела в залежності від сету

• i18n: Сет, Додати сет, Назва сета

• Код: cmp_set

Ротація (Rotation)

Механізм розподілу трафіку між потоками всередині сету на основі ваг (weights).

• i18n: Ротація

• Код: cmp_rotation

Креатив (Creative)

Рекламний матеріал (банер, відео, текст), що використовується в кампанії. Відстежується в статистиці.

• i18n: Креатив

• Код: cmp_creative

---

Типи подій (EventType)

Всі події, які відстежує трекер. Визначені в EventType enum.

Події кліків і переглядів

Події PWA

Події сповіщень

Telegram-події

CPA-події (конверсії з партнерок)

Мапінг статусів (CpaStatusesMap): accept → CPA_ACCEPT, redep → CPA_REDEP, hold → CPA_HOLD, decline → CPA_DECLINE, trash → CPA_TRASH

---

Пікселі та постбеки

Типи пікселів (PixelType)

Термінологія пікселів

• Pixel ID (pixel_id) — ідентифікатор пікселя в рекламній платформі (наприклад, Facebook Pixel ID)

• Access Token (access_token) — токен доступу до API рекламної платформи

• Test Event Code — тестовий код події Facebook для верифікації пікселя

• Event Mapping (зіставлення подій) — мапінг внутрішніх статусів трекера на події пікселя (наприклад, accept → Purchase)

• External Event (ext_event) — довільна назва події на стороні рекламної платформи

• Trigger — умова спрацьовування пікселя (прив'язка до певного статусу конверсії)

Події пікселів (i18n SourceTemplateCrudView)

Постбек-термінологія

• Postback URL — URL, на який партнерка відправляє конверсії. Генерується Adset.Pro автоматично

• Postback Macros (Макроси postback) — поля в налаштуваннях CPA: clickId, status, revenue, currency, externalId

• Postback Status Template (Шаблон статусу постбека) — рядкові значення статусів партнерки, які мапляться на внутрішні типи подій

• Завантаження постбеків — масовий імпорт конверсій з CSV (clickId, status, revenue, currency)

• Дублікати конверсій — налаштування, що дозволяє приймати кілька конверсій одного типу для одного click ID

---

PWA (Progressive Web App)

PWA — веб-додаток, який можна встановити на пристрій користувача як звичайний додаток. В Adset.Pro PWA використовується як проміжний крок між лендингом і офером.

Типи PWA (PwaType)

Термінологія PWA

• PWA Store — сторінка-вітрина PWA, що імітує сторінку додатку в Google Play / App Store. Містить: логотип, назву, опис, скріншоти, коментарі, рейтинг, відгуки, кнопку встановлення

• PWA Constructor (Конструктор PWA) — інструмент створення PWA всередині Adset.Pro з покроковим wizard'ом

• Manifest (manifest.json) — JSON-файл, що описує PWA для браузера (ім'я, іконки, кольори, display mode)

• Service Worker — скрипт, що працює в фоні; забезпечує офлайн-роботу та пуш-сповіщення

• Install Prompt — браузерний діалог пропозиції встановлення PWA

• PWA Install Rate — метрика pwa_view_to_instal_rate: відношення встановлень до показів PWA

Події PWA в статистиці

---

Лендинги та постлендинги

Лендинг (Landing)

Посадкова сторінка, яку користувач бачить першою після кліка по рекламному посиланню. В Adset.Pro називається «Гра / Прелендінг».

• Типи хостингу:

  • internal — завантажений ZIP-архів (локальний лендинг)

  • external — зовнішнє посилання (редирект)

  • telegram — Telegram-канал

• i18n: Гра / Прелендінг, Лендинг, Назва лендінгу

• Код: cmp_landing

Постлендинг (Postlanding)

Сторінка, що показується після сторінки підписки (PWA Store) і перед редиректом на Flow. Додатковий крок у воронці для збільшення конверсії.

• i18n: Гра / Постлендінг, Постлендинг, Назва постлендінгу

• Код: cmp_postlanding

• Події: POSTLANDING_VIEW, POSTLANDING_CLICK

• Метрики: postlanding_views, postlanding_clicks, postlanding_ctr

White Page (Біла сторінка)

Безпечна сторінка, що показується користувачам, які не пройшли фільтри (клоакінг). Використовується для проходження модерації рекламних платформ.

• i18n: White Page, Тип White Page, URL редиректу

• Типи: системний шаблон, власний URL, whitepage зі списку

---

Метрики та статистика

Фінансові метрики

Конверсійні метрики

Метрики трафіку

LTV-метрики (Lifetime Value)

---

Джерела трафіку

Популярні джерела

Термінологія Facebook

• BM (Business Manager) — акаунт управління бізнесом у Facebook

• Ad Account (Рекламний акаунт) — акаунт для запуску реклами

• Campaign (Кампанія FB) — верхній рівень ієрархії реклами у FB

• Ad Set (Адсет) — група оголошень з налаштуваннями таргетингу

• Ad (Оголошення) — конкретний рекламний креатив

• Pixel (Піксель FB) — код відстеження Facebook

• CAPI (Conversions API) — серверний API для відправки подій у Facebook (замість/разом із браузерним пікселем)

• Test Event Code — код для тестування подій CAPI

Термінологія TikTok

• TikTok Ads Manager — рекламний кабінет TikTok

• Events API — серверний API відправки подій (аналог Facebook CAPI)

• TT Pixel — піксель відстеження TikTok

UTM-параметри

Стандартні параметри для відстеження джерел трафіку. В Adset.Pro мапляться на поля статистики:

Sub-параметри

Додаткові параметри для передачі довільних даних:

---

Вертикалі (ніші)

Gambling (Гемблінг)

Онлайн-казино, слоти, азартні ігри. Найпопулярніша вертикаль в арбітражі.

• Особливості: Високі виплати, FTD-модель, редепи

• Ключові події: CPA_HOLD (реєстрація), CPA_ACCEPT (FTD/депозит), CPA_REDEP (повторний депозит)

• PWA-тематики (i18n): Гемблінг, Казино, Слоти

• Категорії PWA: casino, action, arcade

Betting (Беттінг)

Ставки на спорт.

• Особливості: Сезонність, прив'язка до спортивних подій

• PWA-тематики: Беттінг

Dating (Дейтинг)

Знайомства, сайти знайомств.

• Особливості: Smartlink-модель, SOI (Single Opt-In) та DOI (Double Opt-In)

• Ключові події: Реєстрація (CPA_HOLD), Premium-підписка (CPA_ACCEPT)

Nutra (Нутра)

Товари для здоров'я, БАДи, засоби для схуднення.

• Особливості: COD (Cash on Delivery) модель, односторінкові лендинги

• PWA-тематики: Нутра

Crypto (Крипто)

Криптовалютні біржі, гаманці, ICO.

• Особливості: Високі ставки, довгий цикл конверсії

• PWA-тематики: Крипто

Finance (Фінанси)

Кредити, позики, банківські продукти, страхування.

• PWA-тематики: Фінанси

---

Таргетинг і фільтри

Фільтри стрим-сетів

Фільтри визначають, який трафік потрапляє в який сет кампанії. Групуються за категоріями:

Ключові терміни

• ГЕО (GEO) — країна / регіон користувача. Синоніми MCP: geo, country, страна → user_country

• Device (Пристрій) — desktop, mobile, tablet, tv

• OS (Операційна система) — Android, iOS, Windows, macOS

• Cloaking (Клоакінг) — техніка показу різного контенту різним користувачам (модераторам — White Page, цільовим — офер)

• Sticky Flow (Фіксація потоку) — прив'язка повторних відвідувачів до того самого потоку, що й при першому візиті

---

Макроси та параметри

Макроси трекера

Макроси — спеціальні плейсхолдери (змінні) в посиланнях і налаштуваннях, які автоматично замінюються реальними значеннями у момент перенаправлення користувача на цільову сторінку CPA Офера (Flow).

Доступні дві групи: параметри події/трафіку ({event.*}) та параметри баєра ({user.*}).

1. Базові поля події

2. Дані користувача (трафіку) (EventUser)

3. Параметри кампанії (EventCampaign)

4. UTM-мітки та зовнішні параметри

5. Параметри баєра (Buyer)

Використання макросів

• Шаблон параметрів (paramTemplate) — GET-рядок, що додається до URL офера (наприклад, ?clickid={event.event_click_id}&sub1={event.ext_sub1})

• Прокинути всі параметри — кнопка автоматичного додавання всіх макросів у шаблон

• Макроси підставляються у момент перенаправлення користувача на сторінку офера

---

Домени та White Pages

Домен (Domain)

Домен, на якому розміщується трекер і через який проходить трафік.

• i18n: Домен, Оберіть домен

• Хмарні реєстратори: Cloudflare та ін.

White Page (Біла сторінка)

Сторінка-заглушка для модераторів рекламних платформ. Показується користувачам, які не пройшли фільтри.

• Типи: Системний шаблон, Власний URL, WhitePage зі списку

• i18n: Тип White Page, White Page URL, Системна White Page

---

Пуш-сповіщення

Push-сповіщення (Пуші) — браузерні сповіщення, що надсилаються підписаним користувачам через FCM (Firebase Cloud Messaging).

Термінологія

• Push Group (Група пушів) — набір пуш-сповіщень, прив'язаний до кампанії

• Push Slot (Слот пуша) — позиція/слот для відправки пуша

• FCM — Firebase Cloud Messaging, сервіс відправки пушів

• Subscribe (Підписка) — користувач погодився отримувати пуші

• Unsubscribe (Відписка) — користувач відписався

Метрики пушів

Push-атрибуція

Прив'язка конверсій (реєстрацій, депозитів) до конкретних пуш-сповіщень, за якими клікнув користувач.

---

Telegram-інтеграція

Термінологія

• Telegram Bot (Телеграм-бот) — бот, що надсилає сповіщення про конверсії в канал

• Telegram Channel (Телеграм-канал) — канал, куди бот надсилає повідомлення

• TG_JOIN — подія: користувач вступив у Telegram-канал

• TG_START — подія: користувач запустив бота

Метрики

---

Команди та доступи

Команда (Team)

Організаційна одиниця, що об'єднує користувачів і ресурси. Усі сутності (кампанії, CPA, піксели тощо) прив'язані до команди.

• i18n: Команда, Назва команди

• Код: cmp_team

• Синоніми MCP: team, команда → cmp_team

Власник (Owner)

Користувач, відповідальний за конкретну сутність (кампанію, CPA, офер тощо).

• i18n: Власник

Resource Access (Доступ до ресурсів)

Механізм управління правами доступу користувачів до сутностей.

---

Тарифікація трафіку

Cost Model (Модель тарифікації)

Спосіб розрахунку вартості трафіку для кампанії:

• CPC (Cost Per Click) — оплата за клік

• CPA — оплата за цільову дію (реєстрацію, депозит)

  • CPA Event (cpa_event) — подія CPA для тарифікації

  • CPA Price (cpa_price) — вартість за подію

Синоніми для асистента

---

Аліаси та синоніми для MCP-асистента

Мапінг користувацької мови на канонічні ключі статистики. Визначений у statsAssistantMeta.ts.

Метрики

Групування

Семантика подій (Event Semantics)

Правила іменування

• Будь-який ключ із суфіксом _name — це зрозуміла людині назва для базового поля без _name (наприклад, cmp_team_name — назва для cmp_team)

• Під час виведення таблиць включайте і ID, і _name разом

---