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

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

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

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

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

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

Ограничение на количество устройств для одного пользователя

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

Как выбирается устройство для удаления

1. Если все привязанные устройства — это только email-устройства, удаляется случайное email-устройство.
2. В противном случае система находит самое старое не-email устройство по времени последнего открытия приложения и удаляет его.
3. Если нет данных об активности для сравнения (например, устройства были добавлены через API без фактического использования приложения), удаляется случайное не-email устройство.

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

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

Существует два типа пользователей: анонимные и известные. У анонимного пользователя 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, установите флажок User-specific при добавлении нового тега. Если вы не отметите тег как user-specific, он будет связан только с устройством.

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

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

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

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

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

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

Если пользователь, связанный с устройством, изменяется с помощью 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.

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