Что такое DeviceUUID
  • 28 Jun 2022
  • 3 минуты
  • Темная тема
    Светлая тема
  • формат pdf

Что такое DeviceUUID

  • Темная тема
    Светлая тема
  • формат pdf

DeviceUUID — это уникальный идентификатор браузера или мобильного приложения.

Как найти DeviceUUID клиента

Нажимаем «Все устройства» в карточке клиента:

00_deviceuuid

Выбираем активный браузер:

01_deviceuuid

Так как есть различия между DeviceUUID в браузере и мобильном приложении, будем разбирать их отдельно.

DeviceUUID в браузере

Как создаётся

Присваивается нашим js-трекером в момент первого захода на сайт. Генерируется под браузер на устройстве. То есть в двух браузерах на одном и том же устройстве будут разные DeviceUUID.

Так как сессия записывается в момент завершения (через 30 минут после последнего действия), появление DeviceUUID может приходить с задержкой.

Если deviceUUID передавался только в операции, то никакой информации в карточке клиента не будет, хотя устройство у клиента будет.

Когда обновляется

DeviceUUID сбрасывается, только если почистить cookies и local storage.
При новой сессии и при очистке кеша не сбрасывается.

Зачем он нужен

  • отследить начало и окончание сессии, запустить триггер по этим событиям;
  • отследить действия клиента на сайте без передачи его Id (до регистрации): фиксировать анонимные действия клиента и подтягивать их при его регистрации у нас;
  • для вывода рекомендаций анонимным и идентифицированным клиентам

В каких операциях нужен

  • При передаче событий с сайта (просмотр товара, категории, добавление в список продуктов). Это помогает лучше идентифицировать клиента, даже если он не авторизовался на сайте в этой сессии, и отслеживать время жизни сессии. Поэтому важно передавать девайс при авторизации, чтобы сопоставить авторизованного клиента с неавторизованным.

  • В операциях при передаче событий с бэкенда. Это позволяет фиксировать сессию и связывать данные с фронтенда и бэкенда.

  • В операциях, связанных с вебпушами (получение подписки и подписка).

  • Можно запрашивать и в других операциях, исходя из бизнес-задач. Для этого нужно отметить соответствующий пункт в настройках операции:

Снимок экрана 2021-02-25 в 21.09.05.png

Всегда ли он есть

Да, если трекер установлен на сайте и инициализируется.

Может не быть, если в браузере установлен Ad-Blocker или у клиента в браузере отключен javascript.
В таком случае блокируется работа трекера, так что события с фронтенда не поступают на проект.

Как проверить, что трекер установлен

  • ищем в инструментах разработчика на вкладке Elements скрипт:
<script src="https://api.mindbox.ru/scripts/v1/tracker.js" async></script>

Как проверить, что трекер инициализируется

  • на вкладке console инструмента разработчиков вводим mindbox и применяем.

Если получаем Uncaught ReferenceError: mindbox is not defined, значит трекер не инициализируется.

Как найти в браузере

На сайте открываем инструменты разработчика, переходим на вкладку Application, раздел Cookies, выбираем сайт, находим строку mindboxDeviceUUID:

Снимок экрана 2021-06-07 в 20.21.02.png

Как передавать на бэкенд

Cookies передаются на бэкенд сайта, DeviceUUID получаем из них.

Храним ли у анонимных клиентов и зачем

Да, чтобы подтянуть действия после регистрации.
Подробнее в статье.

Что произойдет, если в операции требуется DeviceUUID, но его не прислали

Операция будет выполнена с ошибкой.
Исключение: идентификация клиента только по DeviceUUID. В таком случае операция не выполнится.

Что произойдет, если нет требования присылать DeviceUUID, но его передали

Операция будет выполнена с ошибкой.

Как формируется DeviceUUID в режиме инкогнито

Каждый раз генерируется новый девайс.

Отличается ли на разных сайтах

Нет, везде один и тот же.

Отличается ли в принципы работы в мобильном браузере

Нет, правила те же.


Для мобильного приложения

Device UUID — это уникальный идентификатор приложения на устройстве. Он генерируется при первом запуске SDK на устройстве.

Передача Device UUID обязательна при вызовах из приложения. При передаче данных через бэкенд его указание опционально.

iOs

В приложениях iOs в Device UUID могут подставляться три возможных значения:

  • IDFA — рекламный идентификатор устройства, который генерируется операционной системой телефона. Идентичен для всех приложений на устройстве. Получается при соглашении пользователя на получение уведомлений. Можно найти на своём устройстве с помощью приложения AppsFlyer.

  • IDFV — идентификатор устройства, который генерируется операционной системой телефона. Присваивает в рамках одного разработчике приложений. То есть он идентичен для приложений одного разработчика, но у разных разработчиков IDFV будет различаться. Можно найти на своём устройстве с помощью приложения AppsFlyer.

  • Сгенерированный идентификатор mindbox. Различается у каждого приложения.

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

Android

В приложениях Android в Device UUID подставляется Advertising ID.
Это рекламный идентификатор устройства, который генерируется операционной системой телефона. Идентичен для всех приложений на устройстве. Получается при отсутствии запрета на отслеживание рекламы в настройках телефона.

Доступ может быть закрыт при отключении пользователем отслеживания рекламы (Настройки -> Конфиденциальность -> Реклама). После включения устройство сформирует новый Advertising ID, но на проекте останется прежний Device UUID. Отправке пушей это никак не мешает.

При недоступности Advertising ID подставляется сгенерированный нами идентификатор.

Меняется ли DeviceUUID

DeviceUUID сохраняется в памяти телефона и не меняется до удаления приложения.

При переустановке приложения DeviceUUID остается тем же, если он был получен на основе рекламного идентификатора.
Если он был сгенерирован с помощью SDK, значение изменится.


Была ли эта статья полезной?