Propiedades de usuario
Gestión de propiedades a nivel de usuario que pueden utilizarse para segmentación y lógica condicional en Streams.
Las propiedades pueden definirse a nivel de usuario y luego utilizarse para segmentación y lógica condicional en Streams.
Actualizaciones a través del Navegador
Las propiedades de usuario pueden gestionarse desde el navegador enviando comandos al array Data Layer de Fanplayr. Se admiten las siguientes operaciones:
user.set
Establece una propiedad en el registro del usuario. Sobrescribe cualquier valor existente para el mismo nombre de propiedad.
Uso:
fanplayr_api.push({
"_type": "user.set",
"key": "email"
"value": "user@domain.com",
// Opcionalmente, la propiedad expira después de 7 días
"maxAge": 7 * 60 * 60 * 24
});| Argumento | Tipo | Descripción |
|---|---|---|
| key | String (obligatorio) | El nombre de la propiedad a almacenar. |
| value | cualquiera (obligatorio) | El valor a almacenar para el nombre de propiedad dado. |
| maxAge | Número (opcional) | Especifica la duración máxima en segundos para almacenar la propiedad. |
user.setOnce
Establece una propiedad en el registro del usuario, solo si aún no existe.
Uso:
fanplayr_api.push({
"_type": "user.setOnce",
"key": "firstSeen"
"value": new Date()
});| Argumento | Tipo | Descripción |
|---|---|---|
| key | String (obligatorio) | El nombre de la propiedad a almacenar. |
| value | cualquiera (obligatorio) | El valor a almacenar para el nombre de propiedad dado. |
| maxAge | Número (opcional) | Especifica la duración máxima en segundos para almacenar la propiedad. |
user.increment
Incrementa o decrementa una propiedad numérica. Si la propiedad no existe, se crea y se establece en la cantidad especificada.
Uso:
fanplayr_api.push({
"_type": "user.increment",
"key": "counter1"
"value": 1
});
fanplayr_api.push({
"_type": "user.increment",
"key": "remainingCount"
"value": -1
});| Argumento | Tipo | Descripción |
|---|---|---|
| key | String (obligatorio) | El nombre de la propiedad a almacenar. |
| value | Número (opcional) | La cantidad a incrementar. Por defecto es 1. |
| maxAge | Número (opcional) | Especifica la duración máxima en segundos para almacenar la propiedad. |
user.unset
Elimina una propiedad del registro del usuario.
Uso:
fanplayr_api.push({
_type: 'user.unset',
key: 'email'
});| Argumento | Tipo | Descripción |
|---|---|---|
| key | String (obligatorio) | El nombre de la propiedad a eliminar. |
Actualizaciones a través de Streams
Las propiedades de usuario también pueden actualizarse mediante la acción Actualizar Datos de Usuario en Streams:
La interfaz de acción Actualizar Datos de Usuario en Streams
Limitaciones
Tamaño máximo de almacenamiento
Se puede almacenar un límite total de aproximadamente 20 KB por cada usuario. Cualquier actualización de los datos del usuario que exceda este límite será ignorada y no se persistirá. Los nombres, valores e información de caducidad de cada propiedad contribuyen al límite total.