Ключевые понятия

Краткий словарь, чтобы остальная документация читалась без запинки. Термины расположены от «что показываем» к «как считаем».

Воркспейс

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

PWA

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

Direct Link (прямая ссылка)

Альтернативная цель правила потока без страницы в стиле магазина. Трафик остаётся в том же флоу с правилами, клоакой и аналитикой, а после выбора Direct Link сразу переходит на оффер.

Direct Link может дополнительно использовать webview-bypass, push-запрос и Mini-PWA. Он не наследует настройки PWA или потока: эти значения хранятся отдельно в 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 и исходящих постбеков. Полный перечень — Справочник макросов.