ДАРА АНАЛИТИКА

ДАРА АНАЛИТИКА — аналитика посещаемости и сеть сайтов: она знает о посетителе то, чего он вашему сайту не сообщал, — пол, возрастную группу, город, интересы и категории покупок. Подключение к проекту ДАРА — по желанию: без него выдача работает на ваших данных и на истории действий.

Данные сети хранятся отдельно от данных, которые вы передаёте сами, и их не заменяют: значение, пришедшее от вас, всегда важнее значения сети.

Что даёт подключение#

Приём событий и выдача от подключения не зависят и его не ждут: данные сети подтягиваются в фоне.

Где выпустить ключ#

1. В кабинете ДАРА АНАЛИТИКИ, в разделе «Настройки сайта → Интеграции», выпустите ключ API сайта ak_… — того сайта, на страницах которого стоит её тег и вызывается dara('user') с вашим user_id.
2. В кабинете ДАРА: проект → «ДАРА АНАЛИТИКА» → поле «Ключ API сайта ДАРА АНАЛИТИКИ» → «Проверить и сохранить».

Ключ определяет сайт аналитики: к проекту подключается один её сайт, и пользователи других сайтов через этот ключ не находятся. Секретный ключ DARA Fingerprint sk_… здесь не подходит — это ключ другого сервиса, и ДАРА отклонит его подсказкой.

Что происходит при сохранении:

• пробелы и перевод строки по краям ключа убираются; строка не вида ak_… отклоняется сразу, без запроса к аналитике;
• ДАРА отправляет в ДАРА АНАЛИТИКУ один проверочный запрос о случайном посетителе:
  • ответ «такого посетителя нет» — ключ действует, подключение сохраняется;
  • «ключ неверен» — «Ключ неверен или отозван: ДАРА АНАЛИТИКА ответила 401», прежнее подключение не меняется;
  • доступ сайту закрыт (403) — ключ сохраняется, подключение получает состояние «ключ отклонён»: ДАРА перепроверяет его раз в сутки и включит сама, когда доступ вернут;
  • аналитика не ответила или ответила иначе — «Не удалось проверить ключ», не сохраняется ничего;
• не больше 10 проверок ключа за 10 минут на проект.

Ключ хранится зашифрованным. После сохранения в кабинете виден только его префикс — первые 12 символов; в журналы, аудит и ответы API ключ не попадает и больше не показывается. В запросах к API ДАРА он не передаётся.

После сохранения страница подключения показывает строки «Ключ», «Дата подключения», «Последний ответ ДАРА АНАЛИТИКИ», «Доля пользователей с найденными данными», «Состояние» и «Последняя ошибка». Доля — сколько ваших пользователей, активных за 30 дней, нашлись в сети; она пересчитывается раз в час.

О чём ДАРА спрашивает сеть#

Тег ДАРА АНАЛИТИКИ записывает посетителю cookie _dara_a. Передавайте её значение в analytics_id объекта user — в событиях, заказах, профиле, склейке и выдаче:

{"user": {"user_id": "u-501", "anonymous_id": "a-7f3c2e", "analytics_id": "8a5f1d2e-9c3b-4e17-bf40-2d6a7c8e9f01"}}

analytics_id пользователя не определяет: запрос, в котором из идентификаторов только он, отклоняется как запрос без пользователя. Передавайте его вместе с user_id или anonymous_id — подробнее в разделе Пользователи.

О каждом пользователе ДАРА спрашивает аналитику теми идентификаторами, какие у неё есть:

Когда ДАРА спрашивает:

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

Если user_id на вашем сайте и в dara('user') разные, человек не найдётся: аналитика ищет ровно по тому значению, которое ей передал тег.

Что ДАРА хранит из ответа#

Из ответа ДАРА АНАЛИТИКИ ДАРА сохраняет только:

• пол и уверенность в нём;
• возрастную группу;
• страну, регион и город;
• возрастные группы детей;
• тип, отрасль и регион организации;
• темы интересов с долями;
• категории покупок с ценовым сегментом;
• дату последней проверки.

Года рождения и точного возраста в данных сети нет — только возрастная группа. Параметры посетителя, источник перехода и то, как аналитика определила гео, ДАРА не сохраняет. Данные сети не пишутся и в журналы: туда попадают код ответа и число посетителей в запросе.

Что сохранено о конкретном человеке, видно в кабинете: «Пользователи» → карточка → блок «Данные ДАРА АНАЛИТИКИ». По API те же значения отдаёт блок network в GET /users/profile.

Как это влияет на выдачу#

• Интересы и покупки из сети становятся векторами смысла и входят в интересы профиля рядом с указанными вами интересами. В карточке пользователя такие интересы помечены «по данным ДАРА АНАЛИТИКИ» или «частично по данным ДАРА АНАЛИТИКИ».
• Персональная лента сразу. Новому пользователю без событий интересов из сети хватает, чтобы лента стала персональной (mode: personal), как только они получили векторы.
• Возраст. Если вы не передали год рождения или возраст, фильтр по возрасту работает по нижней границе возрастной группы сети. Объекты без возрастной отметки не фильтруются, как и раньше.
• Сегменты. Пол, возрастная группа, город и страна из сети дают пользователю сегмент, когда вы эти поля не передали.
• Ваши данные важнее. Пол, год рождения, город и страна из профиля перекрывают значения сети. Скрытые авторы, исключённые интересы и отказ от персонализации соблюдаются так же, как без подключения.
• Контрольная группа данных сети не получает — иначе нечем измерить, сколько они дают. Метрики CTR и целей считаются отдельно для основной и контрольной групп среди пользователей, у которых данные сети нашлись; о группе — Данные о пользователях.

Переключатель «Использовать данные сети в выдаче»#

На странице «ДАРА АНАЛИТИКА» есть переключатель «Использовать данные сети в выдаче», по умолчанию включённый. Выключенный переключатель убирает влияние данных сети целиком и сразу — со следующего запроса: интересы, сегменты и возраст из сети перестают учитываться.

Сбор он не выключает. Данные сети по-прежнему запрашиваются и обновляются, карточка пользователя и блок network их показывают. Это разные вещи: переключатель — про выдачу, «Отключить» — про сбор.

Чувствительные темы#

Передавать ли чувствительные темы интересов, решает сайт в кабинете ДАРА АНАЛИТИКИ. Если он их не передаёт, ДАРА таких тем не получает и в выдаче не использует, а полученные раньше перестают учитываться. Настройку ДАРА перечитывает раз в час; в кабинете ДАРА её не меняют.

Когда сайт чувствительные темы не передаёт, на странице подключения появляется строка «Чувствительные темы» с датой проверки.

Смена ключа#

Новый ключ сохраняется той же кнопкой «Проверить и сохранить».

• Другой ключ — другой сайт. Ключ определяет сайт аналитики, поэтому при смене ключа сохранённые данные сети удаляются и запрашиваются заново: они принадлежали прежнему сайту. Кабинет скажет, сколько строк удалено.
• Тот же ключ, введённый заново, ничего не сбрасывает: сайт тот же, удалять нечего — ДАРА проверит ключ и оставит данные на месте. Так подключение возвращают в работу при состоянии «ключ отклонён», если ключ на самом деле действует.

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

При состояниях «ключ отклонён» и «не отвечает» на всех страницах проекта в кабинете показывается предупреждение. Приём событий и выдача при этом работают.

Отключение и удаление#

«Отключить» удаляет ключ: новые данные сети запрашиваться перестают, сохранённые сразу перестают влиять на выдачу и сегменты, а удаляются через 7 дней.

Подключить ДАРА АНАЛИТИКУ снова можно в любой момент, но это подключение заново: сохранённые данные сети удаляются и запрашиваются у неё сызнова — отключение обходится паузой, а не потерей. Переключатель «Использовать данные сети в выдаче» отключение не трогает.

Удаление пользователя. POST /users/delete удаляет данные сети об этом человеке вместе с остальными его данными — сразу. В самой ДАРА АНАЛИТИКЕ при этом не удаляется ничего: там свой оператор данных, свои сроки хранения и свой способ отказаться — ДАРА в неё только читает.