Документация
Справочник по работе с CPA-платформой
На этой странице
Offer Goals
Статус: draft
Назначение
В этом разделе администратор настраивает цели оффера: за что именно создаются конверсии, какие у них revenue и payout, какие действуют лимиты и есть ли индивидуальные ставки для отдельных партнёров.
Где находится
Админ-панель → Офферы → Карточка оффера → Цели оффера
Что такое цель оффера
Цель оффера — это конкретное действие, за которое создаётся конверсия.
Примеры:
- регистрация;
- заявка;
- продажа;
- клик, если используется такая модель.
Что видит администратор
В блоке целей есть:
- список существующих целей;
- кнопка добавления новой цели;
- карточки целей;
- revenue, payout и profit;
- тип цели;
- признак цели по умолчанию;
- лимиты;
- индивидуальные ставки по партнёрам.
Зачем нужны цели
Цели нужны, чтобы:
- принимать разные типы конверсий внутри одного оффера;
- считать revenue и payout на уровне конкретного действия;
- передавать в postback точную цель;
- использовать разные ставки для разных партнёров.
Основные действия
Добавить цель
- Откройте карточку оффера.
- Перейдите в блок
Цели оффера. - Нажмите
Добавить goal. - Заполните параметры цели.
- Сохраните форму.
Результат: новая цель появится в списке целей оффера.
Изменить цель
- Откройте карточку нужной цели.
- Измените поля.
- Сохраните изменения.
Результат: новые revenue, payout, лимиты или другие настройки начнут применяться к следующим конверсиям.
Настроить индивидуальную ставку партнёру
- Откройте нужную цель.
- В блоке индивидуальных ставок выберите партнёра.
- Укажите revenue и payout для этого партнёра.
- Сохраните изменения.
Результат: для выбранного партнёра цель будет рассчитываться по отдельной ставке.
Основные поля цели
| Поле | Что означает | Когда используется |
|---|---|---|
| Name | Название цели | Чтобы отличать цели внутри оффера |
| Type | Тип цели: cpl, cpa, cpc | Для классификации модели действия |
| Revenue | Сумма, которую платит рекламодатель | Для расчёта дохода |
| Payout | Сумма, которую получает партнёр | Для расчёта выплаты |
| Profit | Revenue - payout | Для контроля маржи |
| Is default | Цель по умолчанию | TODO: уточнить точную логику выбора по умолчанию в каждом сценарии postback |
| Limit enabled | Включён ли лимит | Когда нужно ограничить объём по цели |
| Limit type | Тип лимита | По текущей реализации подтверждён conversions_count |
| Limit value | Значение лимита | Когда лимит включён |
Payout
Payout — это выплата партнёру по конверсии этой цели.
Он используется:
- в карточках конверсий;
- в dashboard и агрегированной статистике;
- при расчёте подтверждённых и pending сумм.
Revenue
Revenue — это сумма, которую по этой цели платит рекламодатель.
Он используется:
- в статистике;
- в финансовых расчётах;
- при вычислении profit.
Валюта
В проекте цель форматируется с валютой. По интерфейсу и расчётам основной рабочий сценарий сейчас ориентирован на RUB.
TODO: уточнить, поддерживается ли выбор валюты цели администратором в интерфейсе.
Модель оплаты
По типам целей подтверждены:
CPL;CPA;CPC.
Тип помогает классифицировать цель, но фактические суммы revenue и payout задаются отдельно.
Индивидуальные ставки партнёров
Для цели можно задать отдельные revenue и payout для конкретного партнёра.
Это нужно, когда:
- один партнёр работает по особым условиям;
- payout в карточке цели отличается от общей ставки;
- нужно сравнить базовую и партнёрскую монетизацию.
Как цель связана с postback
Postback должен ссылаться на конкретную цель оффера через goalId или goal_id.
Практически это означает:
- одного postback token недостаточно;
- рекламодатель должен передать ещё и цель;
- система проверяет, что цель действительно принадлежит этому офферу.
Как цель влияет на конверсии
При создании конверсии цель определяет:
- какую цель увидит администратор в списке конверсий;
- какой revenue будет записан;
- какой payout будет записан;
- какой profit попадёт в статистику;
- применится ли индивидуальная ставка партнёра вместо базовой.
Фильтры и поиск
Внутри блока целей отдельные фильтры не подтверждены.
TODO: уточнить, появятся ли отдельные фильтры или сортировки для большого числа целей.
Статусы
У самих целей отдельные статусы в интерфейсе не подтверждены.
TODO: уточнить, есть ли отключение цели без удаления.
Частые ошибки и ситуации
| Ситуация | Что проверить |
|---|---|
| Postback пришёл без цели | Проверьте, передаёт ли рекламодатель goalId или goal_id. |
| Postback пришёл с неизвестной целью | Проверьте, принадлежит ли goal этому офферу и не была ли цель удалена или изменена. |
| Payout отличается от ожидаемого | Проверьте базовый payout цели и индивидуальные ставки партнёра. |
| Revenue не совпадает с payout | Это нормально, если у цели есть маржа. Проверьте обе суммы отдельно. |
| Партнёр имеет индивидуальную ставку | Проверьте блок персональных ставок по цели. |
Ожидаемый результат
После работы с разделом администратор должен:
- завести все нужные цели оффера;
- настроить revenue и payout;
- понимать, какую цель должен передавать postback;
- при необходимости задать отдельные ставки для конкретных партнёров.