Группы
Объединяйте API-ключи проектов в группы, выбирайте данные для просмотра в кабинете и учитывайте последствия удаления группы.
Группы помогают организовать проекты в личном кабинете Fingprint. Каждая группа объединяет API-ключи: по ним в кабинете отбираются визиты, аналитика и webhooks. При регистрации аккаунта создаётся группа По умолчанию — вы можете начать с неё или создать свою.
Решите, какие проекты объединить
При поиске посетителя Fingprint API учитывает визиты, полученные через все API-ключи одной группы. Поэтому, объединив несколько проектов в группу, вы сможете находить одного и того же посетителя по его визитам в этих проектах.
Например, вы можете объединить ключи основного сайта и его приложения в одну группу. Для тестового окружения удобно создать отдельную группу, чтобы просматривать его визиты и аналитику отдельно от рабочего проекта.
Само объединение ключей не гарантирует, что Fingprint API вернёт одинаковый идентификатор посетителя на разных сайтах. Результат зависит от данных запроса и условий поиска.
Выберите группу в кабинете
Выберите нужную группу в боковом меню перед работой с её данными. От выбранной группы зависят:
| Данные | Что вы увидите |
|---|---|
| API-ключи | Ключи, которые принадлежат группе. |
| Визиты | Визиты, полученные через ключи группы. |
| Аналитика | Показатели по ключам группы. |
| Webhooks | Webhooks, привязанные к ключам группы. |
Если ожидаемого ключа, визита или webhook нет в списке, сначала проверьте выбранную группу.
Переключение группы меняет данные, которые вы просматриваете в кабинете. Запросы SDK продолжают поступать с публичным ключом, указанным в его настройках. Fingprint API определяет группу запроса по этому ключу.
Создайте группу
В кабинете откройте управление группами и создайте новую группу. Она появится в списке со случайным номером. Название и описание можно изменить после создания.
Новая группа пустая: API-ключи в ней нужно создать отдельно.
Добавьте API-ключ и проверьте визит
Выберите новую группу в боковом меню, затем откройте API-ключи и создайте ключ. Он будет принадлежать выбранной группе.
В группе может быть до 50 API-ключей. Отключённые ключи тоже учитываются в этом ограничении. Если лимит достигнут, перед созданием нового ключа удалите ненужный или создайте другую группу.
Передайте публичный ключ в параметр apiKey SDK и выполните первый запрос по быстрому старту. Затем выберите эту же группу в кабинете и откройте Идентификация: там должен появиться визит, отправленный с новым ключом.
Для настройки доставки событий на ваш сервер перейдите к webhooks. При создании webhook выбирайте ключ нужной группы.
Удалите ненужную группу
Перед удалением проверьте API-ключи группы и убедитесь, что ваши проекты больше их не используют. Затем удалите группу через управление группами в кабинете.
Вместе с группой удаляются все её API-ключи и привязанные к ним webhooks. Запросы с удалёнными ключами больше не принимаются. Если проект должен продолжить работу, заранее создайте ключ в другой группе, обновите настройки SDK и настройте webhooks для нового ключа.
Если удалена выбранная группа, кабинет использует самую новую из оставшихся групп. Проверьте выбор в боковом меню перед дальнейшей работой.