IKuznetsov: Новая страница: «= Управление пользователями и сессиями = Ключ-АСТРОМ позволяет идентифицировать пользователей в разных сессиях и на разных устройствах, управлять жизненным циклом сессии и добавлять свойства, которые применяются ко всем событиям в рамках сессии. == И...»

2026-08-19T16:52:57Z

Новая страница: «= Управление пользователями и сессиями = Ключ-АСТРОМ позволяет идентифицировать пользователей в разных сессиях и на разных устройствах, управлять жизненным циклом сессии и добавлять свойства, которые применяются ко всем событиям в рамках сессии. == И...»

Новая страница

= Управление пользователями и сессиями =

Ключ-АСТРОМ позволяет идентифицировать пользователей в разных сессиях и на разных устройствах, управлять жизненным циклом сессии и добавлять свойства, которые применяются ко всем событиям в рамках сессии.

== Идентификация пользователей ==

Используйте функцию <code>identifyUser()</code> для присвоения текущей сессии идентификатора пользователя. Это позволяет отслеживать отдельных пользователей в разных сессиях, браузерах и устройствах.

=== Важные соображения ===

* '''Данные не сохраняются''' — пользовательский тег не хранится. Необходимо вызывать функцию <code>identifyUser()</code> для каждой новой сессии.
* '''Автоматическая перемаркировка''' — когда сессия разделяется из-за простоя или истечения времени ожидания, последующая сессия автоматически перемаркируется тем же идентификатором пользователя.
* '''Конфиденциальность''' — при выборе идентификатора следует учитывать правила защиты конфиденциальности. Хэшированные или анонимизированные идентификаторы могут быть предпочтительнее.
* Когда пользователь закрывает приложение или изменяет настройки конфиденциальности, сессии не переименовываются автоматически. Необходимо повторно вызвать функцию <code>identifyUser()</code> после начала новой сессии.

=== Базовое использование ===

'''Kotlin'''
<pre>
// После входа пользователя в систему
Astromkey.identifyUser("user@example.com")

// Или используйте внутренний идентификатор пользователя
Astromkey.identifyUser("user-12345")
</pre>

'''Java'''
<pre>
// После входа пользователя в систему
Astromkey.identifyUser("user@example.com");

// Или используйте внутренний идентификатор пользователя
Astromkey.identifyUser("user-12345");
</pre>

=== Удалить идентификацию пользователя ===

Чтобы удалить пользовательский тег (например, при выходе из системы), передайте <code>null</code> либо пустую строку:

'''Kotlin'''
<pre>
fun logout() {
// Четкая идентификация пользователя
Astromkey.identifyUser(null)
}
</pre>

'''Java'''
<pre>
public void logout() {
// Четкая идентификация пользователя
Astromkey.identifyUser(null);
}
</pre>

== Используйте свойства сессии ==

Свойства сессии представляют собой пары «ключ-значение», которые применяются ко всем событиям в текущей сессии. Используйте их для добавления контекста, характеризующего сессию пользователя.

Свойства событий и сессий необходимо настроить перед их использованием. Входящие свойства событий и сессий, которые не настроены, отбрасываются во время приема событий.

=== Отправить свойства сессии ===

'''Kotlin'''
<pre>
Astromkey.sendSessionPropertyEvent(
SessionPropertyEventData()
.addSessionProperty("session_properties.product_tier", "premium")
.addSessionProperty("session_properties.loyalty_status", "gold")
.addSessionProperty("session_properties.onboarding_complete", true)
)
</pre>

'''Java'''
<pre>
Astromkey.sendSessionPropertyEvent(
new SessionPropertyEventData()
.addSessionProperty("session_properties.product_tier", "premium")
.addSessionProperty("session_properties.loyalty_status", "gold")
.addSessionProperty("session_properties.onboarding_complete", true)
);
</pre>

=== Правила наименования свойств ===

Ключи должны иметь префикс <code>session_properties.</code> и соответствовать правилам, указанным в разделе «Свойства событий и сессий».

Для настройки параметров сессии в Ключ-АСТРОМ требуется конфигурация на стороне сервера. Параметры, которые не настроены, отбрасываются во время приема данных.

=== Обновить свойства сессии ===

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

'''Kotlin'''
<pre>
// Начальные свойства
Astromkey.sendSessionPropertyEvent(
SessionPropertyEventData()
.addSessionProperty("session_properties.cart_value", 0)
)

// Обновить после добавления пользователем элементов
Astromkey.sendSessionPropertyEvent(
SessionPropertyEventData()
.addSessionProperty("session_properties.cart_value", 149.99)
)
</pre>

'''Java'''
<pre>
// Начальные свойства
Astromkey.sendSessionPropertyEvent(
new SessionPropertyEventData()
.addSessionProperty("session_properties.cart_value", 0)
);

// Обновить после добавления пользователем элементов
Astromkey.sendSessionPropertyEvent(
new SessionPropertyEventData()
.addSessionProperty("session_properties.cart_value", 149.99)
);
</pre>

Управление пользователями и сессиями - История изменений