Вход и пароль

• Логин и временный пароль выдаёт лид или интегратор. При первом входе реестр попросит придумать свой пароль, не короче 10 символов.
• Сменить пароль можно в любой момент: «Сменить пароль» внизу меню.
• После 5 неверных попыток подряд вход по этому логину блокируется на 15 минут.
• Забыли пароль — попросите лида или интегратора нажать «Сбросить пароль». Вы получите новый временный пароль, а все старые входы завершатся.

Роли

На интегратора бронь не ставится: интегратор только настраивает и следит за системой.

Приложения

Все приложения от Onyx, WWA и Trident в одной таблице. Реестр собирает их из API поставщиков (раз в час), из таблиц поставщиков и из сообщений их Telegram-ботов (сразу, как бот написал). Время последнего обновления — вверху справа.

Колонки

• Приложение — название, ID в сторе (у Android — package name, у iOS — номер в App Store). Под ним серым — категория, возрастной рейтинг, WebView или Custom Tabs; наведите курсор, чтобы увидеть всё. Пометка «метка FB» — у приложения есть метка Facebook.
• Поставщик — у кого есть это приложение. Бывает сразу у нескольких.
• Статус:
  • «Активна» — можно брать в работу;
  • «Забанена» — в бане; брони остаются, пока баер их не снимет;
  • «На паузе» — поставщик временно попросил остановить трафик; новые брони не принимаются, старые остаются;
  • «Не видно у поставщика» — приложение пропало из ответов поставщика; брони остаются, пока баер их не снимет.
  Подпись под статусом говорит, откуда он: «по боту» — из сообщения бота поставщика, «только по таблице» — API поставщика этого ещё не подтвердил, «вручную» — статус поставил лид или интегратор.
• Доступные гео — где можно работать. Обычно это «все, кроме …» с закрытыми странами.
• Источники — FB, UAC, TikTok, In-App, Unity, Moloco. «Не указаны» — поставщик их не сообщил.
• Кто и на каком гео работает — активные брони: гео и баер. Ваши брони подсвечены; нажмите на свою метку, чтобы снять бронь.
• Добавлена — когда приложение появилось у поставщика.

Фильтры

• Поиск — по названию, бренду или bundle ID. Регистр букв и пробелы не важны.
• Поставщик, ОС, статус, источник — сочетаются друг с другом.
• Гео — две буквы страны (DE, BR). Останутся только приложения, где это гео открыто.
• «Только свободные на этом гео» — работает вместе с гео: активные приложения, где это гео ещё никто не взял.
• Баер — приложения, которые взял конкретный баер.

Таблица показывает по 50 приложений на странице; переключатель страниц — под таблицей. Поиск и фильтры работают по всему реестру, а не только по текущей странице.

Если сверху появилась жёлтая плашка — это предупреждение поставщика для всех (например, Onyx просит временно остановить In-App и TikTok из-за сбоя Adjust). Она исчезнет сама, когда поставщик напишет, что можно продолжать.

Взять в работу

1. Найдите приложение и нажмите «Взять» в конце строки (кнопка есть только у активных приложений).
2. Лид, суперлид и интегратор выбирают, за кого берут бронь.
3. Укажите гео. В подсказке — только открытые и свободные страны; закрытые перечислены под полем.
4. Кампания в Кейтаро (необязательно) — ID или название кампании, если она идёт только на это приложение. Тогда в бронь попадёт трафик только этой кампании.
5. Начало трафика — с этого дня в бронь пойдёт статистика из Кейтаро. По умолчанию сегодня; можно поставить прошлую дату (до 90 дней назад), если трафик уже идёт.
6. Нейминг (необязательно) — нужен, когда одна кампания идёт на несколько приложений: по нему реестр поймёт, какой трафик ваш. Нейминг видите только вы, лид и интегратор.
7. Нажмите «Взять в работу».

Правила броней

• Бронь — это пара «приложение + гео». На одну пару может быть только одна бронь. Если два человека нажали одновременно, бронь получит первый, второй увидит, кто её занял.
• Бронь держится, пока её не снимут: сам баер, лид или интегратор. Срока у брони нет.
• Реестр сам брони не снимает. Если приложение забанили, поставщик его убрал или закрыл гео, бронь остаётся. Во вкладке «В работе» она отмечена красной полосой и пометкой: «Забанена», «Снята поставщиком» или «Гео закрыто». Снимите её сами, когда остановите трафик.
• Если баера отключили, его брони тоже остаются, с пометкой «Баер отключён». Их снимает лид, суперлид или интегратор.
• Пауза бронь не снимает, но новые брони на приложение на паузе не берутся.
• Один нейминг можно указать в бронях одного приложения на разные гео, но не у разных приложений и не у разных баеров — реестр не даст сохранить.

В работе и статистика

Все активные брони: приложение, гео, баер, кампания, нейминг и дата начала трафика. Галочка «Только мои» оставляет ваши.

• Изменить — поменять кампанию, нейминг или дату начала трафика у своей брони. Новые значения учтутся в статистике при следующей загрузке, в течение часа.
• Снять бронь — освободить пару «приложение + гео».
• Сдвинуть столбец — стрелки ‹ › в заголовке столбца двигают его влево или вправо. Например, «Нейминг» можно передвинуть в конец, чтобы длинный нейминг был виден целиком. Порядок запоминается в этом браузере.
• Красная полоса слева — с бронью что-то случилось: пометка рядом говорит что («Забанена», «Снята поставщиком», «Гео закрыто», «Баер отключён»).

Цифры из Кейтаро

Если Кейтаро подключён, в таблице есть колонки «Клики», «Рег.», «Деп.» и «Доход», а сверху — выбор периода (сегодня, 3 дня, 7 дней, включая сегодня) и вида дохода:

• весь — весь доход по постбэкам;
• с депозитов — только доход по депозитам;
• ожидаемый — доход по лидам, которые ещё не подтверждены.

Наведите курсор на сумму — увидите все три вида сразу. Внизу — итог по видимым броням.

• Баер видит цифры только своих броней; у чужих вместо цифр стоит «—», а нейминг скрыт.
• Статистика обновляется раз в час и пересчитывается за последние 7 дней, поэтому поздние депозиты подтягиваются сами.
• Конверсии считаются по дню клика — так же, как в отчётах и на дашборде Кейтаро. Страница «Конверсии» в Кейтаро считает по дню постбэка, поэтому её цифры могут быть больше.
• Валюта — та, что в Кейтаро.

Как статистика попадает в бронь

Реестр раскладывает трафик из Кейтаро по приложениям так:

1. по названию приложения в Sub ID 13 или 16 (Trident Unity);
2. по полю X-Requested-With — это имя пакета Android-приложения, которое открыло ссылку внутри себя (Onyx, WWA);
3. по неймингу из брони — для кликов, открытых в браузере, где X-Requested-With пустой;
4. по уже известному трафику: если этот нейминг в той же кампании встречался только с одним приложением.

Дальше «приложение + страна клика» → бронь, которая в этот день действовала. Чтобы цифры попали к вам:

• гео брони должно совпадать со страной трафика;
• дата начала трафика — не позже первого дня, когда начался ваш трафик;
• если указана кампания — трафик должен идти именно из неё (сравнивается с ID или названием кампании в Кейтаро);
• если кампания идёт на несколько приложений и приложение открывается в браузере — укажите нейминг.

Всё, что не удалось отдать ни одной броне, видно в «Мониторинге» → «Трафик Кейтаро без брони» с причиной.

Работа через API

Всё, что можно сделать на сайте с приложениями и бронями, можно делать и из своих скриптов: искать свободные приложения, брать их в работу, снимать брони и забирать статистику.

1. Получите ключ

1. Нажмите «Мой API-ключ» внизу меню → «Создать ключ».
2. Скопируйте ключ вида rk_…. Он показывается один раз — сохраните его в надёжном месте.
3. Ключ даёт те же права, что и ваш аккаунт. Не передавайте его никому. Если ключ мог утечь — нажмите «Отозвать» и создайте новый.

2. Как обращаться

• Адрес: https://ваш-реестр
• В каждом запросе заголовок Authorization: Bearer rk_ваш_ключ.
• Ответы — JSON. Ошибка выглядит так: {"error": "текст"}.
• Полное описание всех запросов с кнопкой «Попробовать» — /api/docs.

3. Примеры

Свободные приложения на гео — активные, где DE открыто и никем не занято, только Android и FB:

curl -H "Authorization: Bearer $KEY" \
  "{BASE}/api/apps?free_geo=DE&platform=android&source=FB&limit=50"

Другие фильтры: status, supplier (onyx, wwa, trident), geo, q (поиск), claimed_by=me. Постранично: limit (до 1000, по умолчанию 100) и offset; в ответе total — сколько всего.

Карточка приложения — все поставщики, журнал изменений, брони:

curl -H "Authorization: Bearer $KEY" "{BASE}/api/apps/42"

Взять в работу — можно сразу несколько гео:

curl -X POST -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"app_id": 42, "geos": ["DE", "AT"], "flow_id": "2146", "naming": "мой_нейминг", "started_on": "2026-10-29"}' \
  "{BASE}/api/claims"

В ответе created — что получилось, rejected — что нет и почему: taken (гео уже занято, в holder — кем), geo_closed, app_not_active, bad_geo, naming_taken. Поля flow_id, naming и started_on необязательные.

Мои брони:

curl -H "Authorization: Bearer $KEY" "{BASE}/api/claims?mine=1"

У каждой действующей брони есть поле warnings — что с ней случилось: app_ban (приложение забанено), app_removed (снято поставщиком), geo_closed (гео закрыто), user_disabled (баер отключён). Пустой список — всё в порядке. Реестр такие брони сам не снимает.

Добавьте &all=1, чтобы увидеть и снятые — с причиной снятия в release_reason_text.

Изменить кампанию, нейминг или дату начала трафика:

curl -X PATCH -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"naming": "новый_нейминг", "started_on": "2026-10-20"}' "{BASE}/api/claims/123"

Снять бронь:

curl -X DELETE -H "Authorization: Bearer $KEY" "{BASE}/api/claims/123"

Статистика по моим броням за 7 дней (1, 3, 7 … 90):

curl -H "Authorization: Bearer $KEY" "{BASE}/api/keitaro/stats?days=7"

В ответе claims — словарь «ID брони → цифры»: clicks, unique_clicks, regs, deps, leads, revenue, revenue_dep, revenue_expected.

То же на Python:

import requests

BASE = "{BASE}"
H = {"Authorization": "Bearer rk_ваш_ключ"}

free = requests.get(BASE + "/api/apps", headers=H, params={"free_geo": "DE", "source": "FB"}).json()
for app in free["items"][:5]:
    print(app["id"], app["name"], app["store_id"])

r = requests.post(BASE + "/api/claims", headers=H, json={"app_id": free["items"][0]["id"], "geos": ["DE"]})
print(r.status_code, r.json())

Коды ответа

• 200 / 201 — всё хорошо (201 — бронь создана).
• 400 — что-то не так в запросе; причина в error.
• 401 — ключ не передан, неверный или отозван.
• 403 — не хватает прав (например, баер пытается снять чужую бронь).
• 404 — приложение или бронь не найдены.
• 409 — гео уже занято, бронь уже снята или нейминг занят.

Частые вопросы

Нет нужного гео в списке при взятии

Оно закрыто у этого приложения (список закрытых — под полем) или его уже взял другой баер (видно в колонке «Кто и на каком гео работает»).

Пропала моя бронь

Сам реестр брони не снимает, значит её снял лид, суперлид или интегратор. Причину видно в API: /api/claims?mine=1&all=1, поле release_reason_text. Или спросите лида.

В брони нули, хотя трафик идёт

Проверьте: гео брони совпадает со страной трафика; дата начала трафика не позже первого дня, когда пошёл трафик; кампания указана как ID или название из Кейтаро; если кампания на несколько приложений и приложение открывается в браузере — указан нейминг. После правки цифры обновятся в течение часа.

Цифры не совпадают со страницей «Конверсии» в Кейтаро

Реестр, как и отчёты Кейтаро, относит конверсию ко дню клика, а страница «Конверсии» — ко дню постбэка. С дашбордом Кейтаро цифры совпадают.

Статус «на паузе» — можно ли работать?

Поставщик просил временно остановить трафик. Новые брони на такое приложение не принимаются; когда поставщик напишет «снова доступно», статус вернётся сам.