Пользователи (UserID): Обзор

UserID — это уникальный идентификатор, который присваивается каждому пользователю для обеспечения целостности его данных на всех устройствах. Это позволяет обеспечить вашей аудитории бесшовный пользовательский опыт на разных устройствах.

Как связаны пользователь и устройство?

Каждому пользователю присваивается уникальный идентификатор, называемый UserID. UserID могут быть связаны с несколькими устройствами, что позволяет компаниям оставаться на связи с пользователями, даже когда они меняют устройства. Это гарантирует, что целевые сообщения дойдут до нужного пользователя на любом устройстве, которое он использует.

Пользователь (UserID) не является самостоятельной сущностью; его существование зависит от наличия связанных с ним устройств. Если последнее связанное устройство будет удалено или привязано к другому пользователю, пользователь будет автоматически удален из системы.

Пользователь (UserID) также выступает в роли сущности, под которой можно сгруппировать несколько устройств, каждое со своим уникальным Hardware ID (HWID).

Типы пользователей

Существует два типа пользователей: анонимные и известные. У анонимного пользователя UserID совпадает с HWID устройства, но позже его можно заменить на фактический UserID.

У известного пользователя есть собственный, отличный от HWID, UserID. Вы можете указать UserID при регистрации нового устройства с помощью API-вызова /registerDevice.

Получение и управление UserID

Wavesend предоставляет несколько способов для доступа к пользователям и управления ими:

Создание пользователей

По умолчанию, когда приложение с интегрированным Wavesend SDK запускается впервые, в качестве UserID устанавливается HWID устройства. Вы можете вызвать метод setUserId из Wavesend SDK при входе пользователя в систему, чтобы установить любое необходимое значение и связать устройство с конкретным пользователем. Когда пользователь выходит из системы, вы можете сбросить это значение до значения по умолчанию с помощью еще одного вызова setUserId, например, до исходного значения HWID.

Импорт пользователей

Вы можете легко импортировать UserID из CSV-файла для определенного пользовательского Segment. Подробные инструкции вы найдете в нашем руководстве по Segmentам.

Экспорт пользователей

Для экспорта UserID вы можете использовать API-запрос /exportSegment, который позволяет экспортировать данные в формате CSV или JSON.

Получение UserID из логов устройства

UserID также можно получить напрямую из логов устройства. Пошаговые инструкции приведены в статье Как получить логи консоли и токены устройств.

Теги пользователей и устройств

Как и у устройств, у пользователей (UserID) могут быть свои наборы Tag, которые служат метками для категоризации и идентификации пользователей или устройств на основе их характеристик.

Как создавать теги, привязанные к пользователю

Когда вы устанавливаете Tag, привязанный к пользователю, он автоматически применяется как к самому пользователю, так и ко всем связанным с ним устройствам. Это означает, что Tag будет связан с профилем пользователя и отражен на всех его устройствах.

Чтобы создать Tag, привязанный к пользователю, из Wavesend Control Panel, установите флажок User-specific при добавлении нового Tag. Если не отметить Tag как User-specific, он будет связан только с устройством.

Управление переходами пользователей

В Wavesend управление переходами пользователей включает два основных сценария:

Переход от анонимного к известному пользователю

Когда анонимный пользователь становится известным, используемое им устройство связывается с его новым профилем. Во время этого перехода все атрибуты устройства остаются неизменными. Однако важно отметить, что все атрибуты, привязанные к пользователю, сбрасываются до значений известного пользователя или до значений по умолчанию, если они не заданы.

Например, рассмотрим сценарий, в котором гостевой пользователь использовал фитнес-приложение с настройками по умолчанию. Когда он создает аккаунт, данные его устройства остаются неизменными. Однако все пользовательские данные, такие как имя, Email и индивидуальные цели, будут сброшены до значений известного пользователя.

Переход от одного известного пользователя к другому

Если пользователь, связанный с устройством, изменяется с помощью метода setUserID из Wavesend SDK, устройство связывается с новым профилем пользователя. Узнайте больше о настройке UserID для Android и iOS. Вы также можете использовать API-вызов /registerUser.

Как и в предыдущем сценарии, атрибуты устройства остаются прежними, обеспечивая плавный переход. Однако Tag, привязанные к пользователю, будут обновлены значениями нового пользователя. Это необходимо для того, чтобы Tag пользователя точно отражали профиль нового пользователя.

В качестве примера рассмотрим сценарий в стриминговом видеосервисе. Если зарегистрированный пользователь выходит из системы, а на том же устройстве входит другой зарегистрированный пользователь, настройки устройства, такие как предпочитаемый язык и качество видео, сохраняются. Однако любая информация, относящаяся к пользователю, например история просмотров и рекомендации, будет изменена для нового пользователя.

Методы API для управления пользователями

Wavesend предоставляет несколько методов API для управления пользователями в вашем приложении. Понимание этих методов имеет решающее значение для эффективного управления данными пользователей и таргетинга. Вот четыре ключевых метода, которые изменяют статус или атрибуты пользователя:

1. /applicationOpen

• Создает устройство без Push Token и анонимного пользователя, если они не существуют.
• Устанавливает на устройстве Tag, привязанные к устройству.
• Не обрабатывает изменения, связанные с пользователем.

2. /registerDevice

• Создает устройство с Push Token и пользователя, если они не существуют.
• Связывает устройство с пользователем из API-запроса (в противном случае — с анонимным пользователем)
• Присваивает все указанные Tag как устройству, так и связанному с ним пользователю.
• Во избежание потенциальных состояний гонки (когда несколько операций пытаются одновременно изменить общие данные), воздержитесь от одновременного использования /registerDevice и /registerUser.

3. /registerUser

• Создает устройство без Push Token и пользователя, если они не существуют.
• Переносит устройство между пользователями, сохраняя Tag устройства.

4. /setTags

• Создает устройство без Push Token и анонимного пользователя, если они не существуют.
• Присваивает Tag устройства этому устройству.
• Присваивает Tag пользователя пользователю, указанному в запросе (если такой пользователь существует).
• Этот метод не переносит устройство и, как следствие, не может создать нового известного пользователя (для создания нового известного пользователя можно использовать метод /registerUser).

Если с пользователем связано несколько устройств, на какое из них придет сообщение в Customer Journey?

Если с аккаунтом пользователя связано несколько устройств, способ доставки сообщений между ними зависит от типа сценария:

Сценарии с входом по Audience и Webhook

По умолчанию в этих сценариях сообщения отправляются на последнее активное устройство, связанное с пользователем. Это гарантирует, что сообщение получит пользователь, который с наибольшей вероятностью с ним взаимодействует.

Сценарии с входом по триггеру

По умолчанию сообщение отправляется на устройство, на котором в последний раз было совершено триггерное действие. Это позволяет сохранить контекст и релевантность, доставляя сообщение на то устройство, где произошла соответствующая активность пользователя.

Доставка на все устройства

Однако вы можете переопределить эти настройки по умолчанию и отправить сообщение на все устройства, связанные с UserID, одновременно. Для этого в настройках сообщения прокрутите вниз до раздела Опции и активируйте переключатель Отправлять на все устройства пользователя.

Эта опция может быть полезна для массовых рассылок или срочных уведомлений, которые должны дойти до пользователя независимо от того, какое устройство он сейчас использует.