DARA Fingerprint

DARA Fingerprint (fingerprint.daratech.ru) узнаёт устройство посетителя и хранит его id в cookie dara_visitor. Если подключить fingerprint к сайту аналитики, посетители сайта с одним и тем же проверенным id устройства считаются одним человеком. Так атрибуты посетителя — пол, возраст, интересы — сохраняются, даже если cookie аналитики _dara_a потерялась.

Подключение необязательное. Для него на сайте должен работать SDK DARA Fingerprint, а у вас должен быть секретный ключ fingerprint sk_….

Как подключить#

1. Откройте настройки сайта аналитики, раздел «Интеграции».
2. В блоке «DARA Fingerprint» введите «Секретный ключ fingerprint» и нажмите «Проверить и сохранить».
3. Аналитика проверяет ключ запросом к fingerprint.daratech.ru со случайным id: если fingerprint отвечает, что такого id нет, ключ действует и сохраняется; ответ 401 значит, что ключ неверен, и прежнее подключение не меняется. Если fingerprint сейчас не отвечает, ключ не сохраняется — попробуйте позже.

• Ключ хранится зашифрованным и никуда не отдаётся — ни в кабинет, ни в API. В кабинете видно только его начало.
• Подключать, менять ключ и отключать DARA Fingerprint кнопкой «Отключить DARA Fingerprint» могут владелец и администраторы сайта.
• Проверок ключа — не больше 20 в час на сайт.
• Новый ключ доходит до тега в течение 5 минут.

Что происходит после подключения#

• Тег читает cookie dara_visitor после события dara:ready SDK fingerprint — до него SDK может заменить значение — и отправляет её вместе с хитами, если это UUID. Других чужих cookie тег не читает.
• Проверка. Каждый новый id устройства аналитика проверяет в fingerprint. Сохраняются только признаки, нужные для связи: спорный ли id и общее ли устройство. Email, телефон, имя, IP и сессии из ответа fingerprint не сохраняются и не пишутся в логи.
• Повторная проверка — раз в 7 дней для id, которые приходили за эти 7 дней.
• Связь. Проверенный, неспорный id на необщем устройстве связывает посетителей сайта: два посетителя с одним таким id — один человек.

Ограничения#

• iPhone и iPad. Устройства iOS и iPadOS fingerprint всегда считает общими, поэтому на них связь не появляется.
• Очистка cookie. Когда посетитель очищает cookie, обычно удаляется и dara_visitor. Связь срабатывает, когда dara_visitor пережила потерю _dara_a — например, если сайт продлевает dara_visitor со своего сервера по тем же правилам, что _dara_a в разделе Cookie и Safari. Фрагменты оттуда нужно поменять: имя cookie — dara_visitor, Domain и Path — как у cookie, которую ставит SDK fingerprint, а служебная cookie — своя, например dara_visitor_srv, чтобы продления двух cookie не мешали друг другу.
• Только один сайт. Через fingerprint связываются посетители одного сайта, но не разные сайты: посетители fingerprint привязаны к сайту.
• Счёт посетителей в отчётах по-прежнему идёт по _dara_a: посетитель с новой _dara_a в отчётах посещаемости остаётся новым посетителем, а атрибуты получает от прежнего.

Статусы подключения#

• При статусах «Ключ неверен» и «Fingerprint недоступен» в разделе «Интеграции» появляется предупреждение.
• Пока подключение не в статусе «Подключён», тег не отправляет dara_visitor, а API не ищет посетителей по fingerprint_uuid. Связи, которые уже появились, остаются.

В API#

В POST /visitors/attributes можно искать посетителя по fingerprint_uuid. Он учитывается, только если fingerprint подключён к сайту и подключение в статусе «Подключён», и используется последним: после user_id и visitor_id. Без подключения поле молча пропускается. Подробнее — в разделе API: посетители.