Перейти к основному содержимому

Расход других площадок — рядом с их депозитами

Клики, регистрации и депозиты по трафику с любой площадки Qubix считает по своим ссылкам и постбэкам. Теперь к ним приходит и расход: расход площадки, у которой нет своей выгрузки в Qubix, присылается по ключу — и окупаемость этого трафика считается в тех же отчётах, что у Facebook.

Это приём расхода по ключу. Ключ выпускается на странице MCP/API, а ваша программа — любая, что умеет отправить HTTP-запрос, — шлёт на адрес панели почасовой расход: по объявлению или по сайту целиком, в валюте площадки. Расход Facebook Qubix, как и прежде, выгружает сам.

Что это даёт​

Окупаемость — там же, где у Facebook. Расход по объявлению ложится рядом с его кликами, регистрациями и депозитами и дальше идёт в отчёты так же, как расход Facebook: в список объявлений, на Главная, в карточку источника трафика. ROAS и цена депозита по такому трафику считаются в Qubix.

Новые объявления заводятся сами. Объявления и кампании, которых Qubix ещё не знает, заводятся первой же пачкой. В списке объявлений у них значок Внешний, а статус меняется в кабинете самой площадки: от неё Qubix получает только расход. Владельца новой кампании Qubix определяет так же, как у Facebook, — по назначению администратора или по правилу привязки, которое встречается в названии кампании.

Расход сайта — своей строкой. Если за трафик платят целиком за сайт, а не по объявлениям, расход присылается на сайт. В списках кампаний, офферов и партнёрок он стоит отдельной строкой Расход сайтов — отдельно от строк Без кампании, Без оффера и Без партнёрки.

Валюта площадки. Суммы присылаются в валюте площадки, а Qubix пересчитывает их в доллары по курсу того дня, к которому относится строка.

Повтор заменяет, а не удваивает. Клетка — это день, час, объявление или сайт и источник, под которым прислан расход. Та же клетка, присланная ещё раз в том же часовом поясе, заменяет прежние числа. Поэтому пачку можно слать по расписанию целиком за весь период, который обновила площадка. Расход того же объявления за тот же час, присланный под другим источником, ложится отдельно и складывается с первым.

Передать расход можно и словами. ИИ-Ассистент записывает его тем же приёмом — средство Передать расход — и перед записью спрашивает подтверждение. Тот же приём открыт и внешнему ИИ-клиенту, подключённому по MCP.

И прямо из скрипта. Скрипт раздела Скрипты — по расписанию или кнопкой Запустить — подаёт расход тем же приёмом командой QubixApp.submitSpend, строками того же вида, что у запроса по ключу. Пишет он правами своего владельца: владельцу нужно право Управление источниками трафика, а расход подаёт только код, который владелец скрипта или администратор изменил и сохранил — в панели или средством script_save через MCP, — подробнее в статье Написание скрипта.

Как это устроено​

Ключ определяет, от чьего имени пишется расход, а значит — в какие источники, объявления и сайты его можно записать. Администратор может выпустить ключ и на другого человека: тогда расход пишется в пределах прав этого человека. Ключ показывается один раз и нигде не хранится. Он действует, пока учётная запись активна и её сессии не сброшены кнопкой Сбросить все сессии в карточке пользователя; новый ключ прежних не отменяет.

Источник у всей пачки один, а каждая строка описывает одну клетку: день и час, ровно одно из двух — объявление или сайт — и расход, по желанию с показами и кликами. Расход пачки записывается целиком или не записывается вовсе, а на отказ приём отвечает причиной. Пока курс на дату строки ещё не вышел — так бывает с текущим днём — или источники курса не ответили, приём отвечает кодом 503 с заголовком Retry-After, и ту же пачку отправляют позже; если курса на эту дату нет ни у одного источника, такие строки присылают в долларах.

Источником в пачке служит источник трафика этой площадки из раздела Источники — тот, который вам разрешено править. Источники площадок, чей расход Qubix выгружает сам, приём не берёт: иначе расход лёг бы дважды.

Сверьте первую пачку в отчётах

На недействующий ключ приём отвечает так же, как на принятую пачку, но ничего не записывает. После первой отправки убедитесь, что расход появился в Qubix.

Пример​

Расход за один час: по объявлению, которого Qubix ещё не знает, и по сайту целиком. Суммы в евро, день и час — по берлинскому времени:

Bash
curl -X POST 'https://адрес-вашей-панели/cost-intake' \
-H 'Content-Type: application/json' \
-d '{
"key": "ключ из блока «Приём расхода по ключу»",
"source": "опознаватель источника трафика",
"currency": "EUR",
"tz": "Europe/Berlin",
"rows": [
{"date": "2026-09-28", "hour": 14, "ad_id": "7700123",
"campaign_id": "881", "campaign_name": "BR push 881", "ad_name": "banner 3",
"spend": 12.5, "impressions": 1000, "clicks": 40},
{"date": "2026-09-28", "hour": 14, "website_id": "опознаватель сайта", "spend": 3}
]
}'

Первая строка заводит объявление 7700123 в кампании, которая хранится под номером с приставкой ext- — так она не займёт номер кампании самой площадки. Каждая строка нового объявления называет одни и те же campaign_id, campaign_name и ad_name. Кампания заводится, только если у неё находится владелец из тех, в чьи объявления вы вправе писать; кампанию без владельца заводит только администратор. Вторая строка — расход сайта: у неё website_id вместо ad_id. Валюту и часовой пояс можно не указывать — тогда это доллары и UTC. В ответ приходит число записанных строк.

Где включить​

  1. Заведите в разделе Источники источник для площадки, если его ещё нет.
  2. Откройте страницу MCP/API, блок Приём расхода по ключу. Администратор выбирает, кому выпускается ключ: Себе или другому человеку.
  3. Нажмите Выпустить ключ и сразу сохраните ключ — второй раз он не показывается.
  4. Настройте свою программу слать пачки на адрес из блока. Пример тела с вашим ключом — там же, под заголовком Тело запроса.

Блок на странице и средство Передать расход доступны тем, у кого есть право Управление источниками трафика.


Расход, клики и депозиты площадки теперь сходятся в одних и тех же отчётах — рядом с Facebook.

Что дальше​