Рефералы и клиенты

Полный перечень полей — в глоссарии.

​

Обзор

Страница «Рефералы и клиенты» объединяет два независимых блока аналитики:

• Реферальная программа — сколько компания начислила вознаграждений агентам-рефералам за период, кто эти агенты и какова история отдельных начислений.
• Клиентская аналитика — список клиентов с денежными показателями по каждому (прогноз, долг, оплаты), а также сводный обзор роста базы, оттока, LTV и демографии.

Оба блока строятся поверх операционных данных аренд (заявок) и почти везде фильтруются по выбранному периоду дат. Способ выбора периода и его влияние на расчёты различаются между отдельными отчётами внутри страницы — это подробно описано в каждом разделе ниже.

​

Реферальная программа

​

Модель данных

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

​

Период, по которому считается программа

Все три отчёта реферальной программы (сводка, история начислений, список агентов) фильтруют начисления по дате окончания аренды, а не по дате создания самого начисления. Это значит, что начисление попадёт в отчёт за тот период, когда закончилась аренда, за которую оно выплачивается — независимо от того, когда фактически было создано начисление или изменён его статус. Период задаётся общими параметрами начала и конца диапазона дат (по умолчанию — текущий календарный месяц, если период не передан явно).

​

Сводка по рефералам

Сводный отчёт возвращает три агрегированных значения по всем начислениям, у которых аренда закончилась в выбранном периоде: Если за период нет ни одного подходящего начисления, все три значения возвращаются нулевыми (а не пустыми) — специально применяется подстановка нуля, чтобы отчёт не падал и не возвращал пустое значение при отсутствии данных. Сводка поддерживает дополнительную фильтрацию — по конкретному агенту, по статусу самой аренды и по статусу начисления. Полнотекстовый поиск по номеру заявки, имени или телефону агента для этого отчёта настроен на уровне полей, но фактически не работает: механизм поиска не подключён к сводному отчёту, поэтому такие параметры поиска будут проигнорированы.

​

История начислений

Отдельный отчёт возвращает построчную историю начислений за период (та же фильтрация по дате окончания аренды), отсортированную от новых к старым по дате создания начисления. Для каждой строки дополнительно подтягивается статус самой аренды (не путать со статусом начисления) — это позволяет видеть, находится ли аренда, за которую начислено вознаграждение, всё ещё в процессе, завершена или отменена. История поддерживает те же фильтры, что и сводка — по агенту, по статусу аренды, по статусу начисления, — а также (в отличие от сводки) действительно работающий полнотекстовый поиск и сортировку по сумме, статусу и номеру заявки.

​

Список реферальных агентов

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

​

Клиентская аналитика

​

Модель данных

Базовая единица клиентской аналитики — клиент: физическое лицо или юридическое лицо (со своей организационно-правовой формой — ИП, ТОО, АО или производственный кооператив). У клиента есть дата создания (регистрации), а также отдельная связанная запись об отключении клиента — если такая запись существует, клиент считается деактивированным; сама запись хранит дату и способ отключения и не является просто датой в карточке клиента.

​

Список клиентов

Список клиентов — это основная таблица с фильтрами (по типу, телефону, меткам, источнику привлечения, форме юрлица, статусу подписания, ИИН, БИН, имени) и полнотекстовым поиском по имени, комментарию, email, номеру договора, телефону, ИИН и БИН. Для каждого клиента дополнительно вычисляются денежные показатели: Все денежные показатели вычисляются заранее в самом запросе к базе (а не после получения данных), что позволяет сортировать список клиентов по любому из них — например, показать сначала клиентов с наибольшим долгом. Помимо перечисленного, в карточке клиента в списке также отображаются бонусы клиента и привязанные к нему метки. Поле баланса кошелька Kaspi присутствует в структуре ответа, но в этом отчёте оно не заполняется данными ни при каких условиях и всегда возвращается пустым — наполнение баланса подключено только в отдельной карточке клиента, не в этом списке.

​

Обзор клиентской аналитики

Обзорная карточка — это набор показателей за выбранный период, где почти каждый показатель оформлен в виде блока “текущее значение / значение за предыдущий период / изменение в процентах”. Изменение в процентах считается по формуле: (текущее значение делить на предыдущее и умножить на 100) минус 100. Если предыдущего значения нет или оно равно нулю, изменение считается равным нулю — деление на ноль не допускается. Показатели обзора: Количество клиентов — общее число активных (не отключённых) клиентов, у которых дата создания не позже конца периода. Значение “предыдущее” считается точно так же, но по дате начала периода — то есть это фактически два среза базы клиентов на две контрольные даты, а не прирост за период. Уникальные арендаторы — число уникальных клиентов, у которых аренда закончилась в текущем периоде (без повторов одного клиента). Значение “предыдущее” считается за предшествующий период такой же длины, сдвинутый назад от начала текущего периода. Отток клиентов — рассчитывается по формуле: (число клиентов с арендой, закончившейся в предыдущем периоде, такой же длины, плюс число клиентов, зарегистрированных в текущем периоде, минус число клиентов с арендой, закончившейся в текущем периоде) делить на число клиентов с арендой, закончившейся в предыдущем периоде, и умножить на 100. Если знаменатель (число клиентов из предыдущего периода) равен нулю, отток считается равным нулю. Пожизненная ценность клиента (LTV) — оценочный показатель, учитывающий аренды, закончившиеся не раньше чем за 90 дней до конца периода (соответственно от начала периода — для предыдущего значения), без верхней границы по дате, и исключающий заявки в статусах “заявка” и “отменена”. Расчёт: средняя сумма одного платежа по этим арендам умножается на количество клиентов с более чем одной арендой за эти 90 дней и делится на утроенное общее число таких аренд. Если подходящих аренд не найдено, значение равно нулю. Распределение по полу — процентная разбивка клиентов на мужской, женский пол и “не определено”. Пол здесь не берётся из карточки клиента, а вычисляется отдельно по чётности седьмой цифры ИИН физического лица (чётная цифра — женский пол, нечётная — мужской); если ИИН отсутствует или не подходит под шаблон, клиент попадает в категорию “не определено”. Расчёт учитывает клиентов, зарегистрированных не позже конца периода. Распределение по возрасту — процентная разбивка по шести возрастным группам (0–17, 18–24, 25–34, 35–44, 45–54, 55 и старше), где возраст вычисляется как разница между текущим моментом и датой рождения из паспорта физического лица. Клиенты без даты рождения (например, юридические лица) в проценты не включаются — знаменателем служит только количество клиентов с известным возрастом.

​

График роста числа клиентов

Показывает количество новых клиентов, зарегистрированных за каждую неделю периода: точки строятся с недельным шагом от начала до конца периода, и если за какую-то неделю новых клиентов не было, в графике всё равно появляется точка с нулевым значением (пропусков в датах нет). Поддерживается дополнительная фильтрация по типу клиента, источнику привлечения и меткам — при применении фильтров общее число клиентов на графике будет отражать только отфильтрованную группу.

​

График оттока клиентов

Показывает процент оттока клиентов на каждую неделю периода по формуле скользящего окна: для каждой недельной точки сравнивается число активных клиентов на конец 30-дневного окна, заканчивающегося в этой точке, с числом активных клиентов на конец такого же окна, начинающегося на 30 дней раньше. Изменение выражается в процентах от более позднего (текущего) значения, а не от более раннего; если более позднее значение равно нулю, используется единица вместо него, чтобы избежать деления на ноль. Точки строятся с шагом в неделю на всём протяжении периода.

​

Как это используется

Оба блока — реферальная программа и клиентская аналитика — рассчитаны на панель метрик компании, где руководитель или менеджер:

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

Все отчёты этой страницы read-only: они ничего не изменяют в данных, а только агрегируют существующие аренды, платежи и начисления под выбранный период и фильтры.

​

Особенности поведения

• Полнотекстовый поиск по номеру заявки, имени и телефону агента заявлен в сводном отчёте по рефералам, но фактически не работает — в отличие от истории начислений, где такой поиск подключён и работает.
• В списке реферальных агентов, если у агента нет начислений с арендой, закончившейся в периоде, оба денежных показателя возвращаются пустыми, а не нулём. Сам отчёт также не возвращает имя и телефон агента — только идентификатор и суммы.
• Правило об ограничении изменения начислений по завершённым или отменённым арендам действует только при добавлении и изменении начисления; при удалении эта проверка не выполняется.
• Период для списка клиентов задаётся отдельными параметрами по дате создания клиента и не совпадает с общими параметрами периода, которые использует обзор клиентской аналитики и оба графика.
• Пол клиента в блоке распределения по полу вычисляется по чётности седьмой цифры ИИН, а не берётся из поля пола в карточке клиента — расхождение между вручную указанным и вычисленным полом возможно и ожидаемо.
• Возрастные группы вычисляются через приблизительное количество дней в году без учёта високосных лет, что даёт небольшую погрешность в пограничных случаях.
• Расчёт LTV не ограничен сверху по дате окончания аренды — учитываются все аренды, закончившиеся не раньше чем за 90 дней до контрольной даты, включая более поздние даты окончания.
• Все отчёты клиентской аналитики учитывают только клиентов без записи об отключении — это может занижать исторические показатели при ретроспективном сравнении.
• История начислений и сводка по рефералам фильтруют по дате окончания аренды, а не по дате создания или изменения статуса начисления, поэтому начисление может попасть в отчёт за период, далёкий от момента его фактического создания или оплаты.
• В списке клиентов поле баланса кошелька Kaspi присутствует в структуре ответа, но никогда не заполняется данными в этом отчёте.

​

Связанные страницы