Поддомены
Подключите свой поддомен, подтвердите его DNS-записями и настройте SDK отправлять запросы через него.
По умолчанию SDK загружает скрипт и отправляет запросы на адреса Fingprint. Блокировщики рекламы могут их блокировать, и тогда запрос идентификации не выполнится. Если подключить свой поддомен, например metrics.example.com, SDK будет обращаться к Fingprint через ваш домен.
Список поддоменов общий для аккаунта и не зависит от выбранной группы.
Что понадобится
- Свободный поддомен вашего сайта: на нём не должно быть других DNS-записей.
- Доступ к настройкам DNS домена.
1. Добавьте поддомен
Откройте Поддомены и нажмите Добавить поддомен. В поле Адрес поддомена укажите полное имя, например metrics.example.com, и нажмите Создать.
Поддомен появится в таблице со статусом Ожидает верификации, и откроется окно Данные поддомена с DNS-записями для подтверждения.
2. Добавьте DNS-записи
В блоке Верификация указаны две записи. Скопируйте значения полей Имя и Значение и создайте записи у своего DNS-провайдера:
| Тип | Имя | Значение |
|---|---|---|
| CNAME | Имя поддомена без основного домена: metrics | Адрес Fingprint из поля Значение. |
| TXT | _fingerprint-verify.metrics.example.com | fingerprint-domain-verification=… из поля Значение. |
CNAME направляет запросы к поддомену в Fingprint. TXT подтверждает, что домен принадлежит вам.
Кабинет показывает имя CNAME-записи относительно домена второго уровня: для metrics.example.com это metrics. Если ваша DNS-зона устроена иначе, например example.co.uk, укажите имя относительно своей зоны. Для TXT-записи кабинет показывает полное имя. Если DNS-провайдер сам дописывает домен зоны, укажите только часть до него: _fingerprint-verify.metrics.
Чтобы снова открыть записи, в строке поддомена откройте меню и выберите Детали.
3. Дождитесь подтверждения
Fingprint проверяет ожидающие поддомены примерно раз в 5 минут. Обновление DNS у провайдера обычно занимает от нескольких минут до нескольких часов, а в редких случаях — до 24–48 часов: срок зависит от TTL записей и конкретного провайдера.
Когда обе записи найдены, статус в таблице меняется на Активен.
После подтверждения Fingprint выпускает TLS-сертификат для поддомена, поэтому HTTPS на нём может заработать не сразу после смены статуса.
4. Укажите поддомен в SDK
Передайте адрес поддомена в параметр endpoint. Укажите только протокол и домен, без пути:
import { start } from '@fingerru/agent'
const agent = start({
apiKey: 'pk_live_example',
endpoint: 'https://metrics.example.com',
})SDK загрузит скрипт с https://metrics.example.com и отправит запрос на https://metrics.example.com/api/visit. Остальные параметры описаны в справочнике SDK.
5. Проверьте запрос
Откройте сайт, вызовите agent.get() и во вкладке Network инструментов разработчика найдите запрос к /api/visit. Он должен уходить на ваш поддомен и завершаться успешным статусом. Затем найдите событие в кабинете в Идентификация → События идентификации.
Если SDK вернул ошибку, проверьте её код на странице Ошибки SDK. Чаще всего причина — поддомен ещё не в статусе Активен или в endpoint указан путь.
Статусы поддомена
| Статус | Что означает |
|---|---|
| Ожидает верификации | Записи ещё не найдены. Проверьте их у DNS-провайдера и дождитесь проверки. |
| Активен | Записи подтверждены, поддомен можно указывать в endpoint. |
| Неактивен | Поддомен был подтверждён, но при повторной проверке записи не найдены. |
Не удаляйте CNAME- и TXT-записи, пока используете поддомен: без них статус сменится на Неактивен. Если записи вернуть, статус снова станет Активен после следующей проверки.