Пользователи (User ID)

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

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

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

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

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

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

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

У известного пользователя есть отдельный User ID. Вы можете указать User ID при регистрации нового устройства через вызов API /registerDevice.

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

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

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

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

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

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

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

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

Доступ к User ID из логов устройства

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

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

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

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

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

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

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

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

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

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

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

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

Если пользователь, связанный с устройством, изменяется с помощью setUserID из Pushwoosh SDK, устройство связывается с новым профилем пользователя.

Узнайте больше об установке User ID для Android и iOS.

Вы также можете использовать вызов API /registerUser.

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

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

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

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

1. /applicationOpen

• Создает устройство без push-токена и анонимного пользователя, если они не существуют.
• Устанавливает теги, специфичные для устройства, на устройстве.
• Не обрабатывает изменения, связанные с пользователем.

2. /registerDevice

• Создает устройство с push-токеном и пользователя, если они не существуют.
• Связывает устройство с пользователем из API-запроса (в противном случае с анонимным пользователем)
• Присваивает все указанные теги как устройству, так и связанному с ним пользователю.

Осторожно

Чтобы защититься от потенциальных состояний гонки (когда несколько операций пытаются одновременно изменить общие данные), воздержитесь от одновременного использования /registerDevice и /registerUser.

3. /registerUser

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

4. /setTags

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

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

Когда у пользователя есть несколько устройств, связанных с его учетной записью, способ доставки сообщений зависит от типа journey:

Journeys с входом на основе аудитории и на основе вебхуков

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

Journeys с входом на основе триггера

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

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

Однако вы можете переопределить эти настройки по умолчанию и отправить сообщение на все устройства, связанные с User ID, одновременно. Для этого в настройках сообщения прокрутите вниз до Options и включите переключатель Send to all user devices.

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