Proprietà Utente
Gestione delle proprietà a livello utente che possono essere utilizzate per la segmentazione e la logica condizionale negli Stream.
Le proprietà possono essere definite a livello utente e successivamente utilizzate per la segmentazione e la logica condizionale negli Stream.
Aggiornamenti tramite Browser
Le proprietà utente possono essere gestite dal browser inviando comandi all'array Data Layer di Fanplayr. Sono supportate le seguenti operazioni:
user.set
Imposta una proprietà sul record utente. Sovrascrive qualsiasi valore esistente per lo stesso nome di proprietà.
Utilizzo:
fanplayr_api.push({
"_type": "user.set",
"key": "email"
"value": "user@domain.com",
// Scadenza opzionale della proprietà dopo 7 giorni
"maxAge": 7 * 60 * 60 * 24
});| Argomento | Tipo | Descrizione |
|---|---|---|
| key | Stringa (obbligatorio) | Il nome della proprietà da memorizzare. |
| value | qualsiasi (obbligatorio) | Il valore da memorizzare per il nome di proprietà dato. |
| maxAge | Numero (opzionale) | Specifica la durata massima in secondi per memorizzare la proprietà. |
user.setOnce
Imposta una proprietà sul record utente, solo se non esiste già.
Utilizzo:
fanplayr_api.push({
"_type": "user.setOnce",
"key": "firstSeen"
"value": new Date()
});| Argomento | Tipo | Descrizione |
|---|---|---|
| key | Stringa (obbligatorio) | Il nome della proprietà da memorizzare. |
| value | qualsiasi (obbligatorio) | Il valore da memorizzare per il nome di proprietà dato. |
| maxAge | Numero (opzionale) | Specifica la durata massima in secondi per memorizzare la proprietà. |
user.increment
Incrementa o decrementa una proprietà numerica. Se la proprietà non esiste, viene creata e impostata sull'importo specificato.
Utilizzo:
fanplayr_api.push({
"_type": "user.increment",
"key": "counter1"
"value": 1
});
fanplayr_api.push({
"_type": "user.increment",
"key": "remainingCount"
"value": -1
});| Argomento | Tipo | Descrizione |
|---|---|---|
| key | Stringa (obbligatorio) | Il nome della proprietà da memorizzare. |
| value | Numero (opzionale) | L'importo di cui incrementare. Il valore predefinito è 1. |
| maxAge | Numero (opzionale) | Specifica la durata massima in secondi per memorizzare la proprietà. |
user.unset
Rimuove una proprietà dal record utente.
Utilizzo:
fanplayr_api.push({
_type: 'user.unset',
key: 'email'
});| Argomento | Tipo | Descrizione |
|---|---|---|
| key | Stringa (obbligatorio) | Il nome della proprietà da rimuovere. |
Aggiornamenti tramite Stream
Le proprietà utente possono anche essere aggiornate tramite l'azione Aggiorna Dati Utente negli Stream:
L'interfaccia dell'azione Aggiorna Dati Utente negli Stream
Limitazioni
Dimensione massima di archiviazione
Per ciascun utente è possibile memorizzare un limite complessivo di circa 20 KB. Eventuali aggiornamenti ai dati utente che supererebbero questo limite vengono ignorati e non persistono. I nomi, i valori e le informazioni di scadenza per ciascuna proprietà contribuiscono al limite complessivo.