Глоссарий терминов 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 вместе