---
title: Аналитика (data.ndocs)
description: 'Аналитика — это то, что Human Plugin сообщает о каждом человеке в каждом ответе, в data.ndocs: кого она описывает, что считает, когда отсутствует и как её читать.'
canonical: https://developer.unico.io/ru/human-plugin/get-started/intelligence
locale: ru
generated_by: markdown-export
---

# Аналитика

data.ndocs: что один и тот же человек делал у вас, в каждом ответе.

Каждый завершённый процесс сообщает, кто этот человек, — через Human Token, и что этот человек делал у вас, — через аналитику в `data.ndocs`: с каким числом ваших клиентов его видели, сколько документов он использовал и когда.

```json
"ndocs": {
  "distinctClientsCount": 2,
  "transactionsCount": 3,
  "firstSeen": "2026-09-08",
  "lastSeen": "2026-11-03",
  "credentials": [
    { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
  ]
}
```

| Поле | Значение |
| --- | --- |
| `distinctClientsCount` | Число различных значений `clientId` среди процессов человека |
| `transactionsCount` | Число процессов человека, включая текущий |
| `firstSeen`, `lastSeen` | Даты в UTC (`YYYY-MM-DD`) самого раннего и самого позднего процесса |
| `credentials[].type` | Тип документа, код из [каталога атрибутов](/ru/human-plugin/additional-resources/attribute-catalog) |
| `credentials[].countryCode` | Страна выдачи документа в формате alpha-3. Отсутствует для типа, которого больше нет в каталоге |
| `credentials[].distinctCredentialCount` | Число различных документов этого типа |

## Как её читать

Значение `distinctClientsCount` больше 1 или `distinctCredentialCount` больше 1 означает, что одно и то же лицо использовалось с разными клиентами или документами. Что делать с этим сигналом, решаете вы.

## Что учитывается

Человек определяется по Human Token. Учитываются только **завершённые** процессы с этим токеном, по всем вашим id клиентов. Процесс, созданный без документа, считается и как транзакция, и как клиент, но не относится ни к одному типу документа. `credentials` равно `[]`, если ни у одного из процессов человека нет документа.

Аналитика охватывает процессы вашей установки Human Plugin.

## Чья это аналитика

- **Идентификация**, завершившаяся с Human Token: этого человека. Не в случае, когда `data.liveness.value` равно `not_live`.
- **Ревалидация** с `data.humanTokenMatch`, равным `"true"`: человека, чей токен вы передали в `references`. Процесс засчитывается этому человеку.
- **В остальных случаях** (отрицательное совпадение или захват без признаков живости): аналитики нет, и `data.ndocs` отсутствует.

## Когда она отсутствует

`data.ndocs` может отсутствовать у известного человека:

- процесс ещё не завершён;
- аналитику не удалось вычислить. Создание или чтение при этом завершается успешно, а последующий `GET` повторяет попытку.

Не воспринимайте отсутствие `data.ndocs` как то, что человека раньше не видели.

## Далее

[Требования и доступ](/ru/human-plugin/get-started/prerequisites)