Gestione dell'Identità
Le identità vengono utilizzate per unire i Profili utente in una vista unificata, attraverso le sessioni in un browser, e tra dispositivi e piattaforme.
Se un utente visualizza il tuo sito web e si autentica, puoi inviare un messaggio identify
per far sapere a Fanplayr 360 che questo utente deve essere identificato da una specifica email
e userId
.
Quando lo stesso utente si autentica nella tua app per telefono, puoi effettuare un'altra chiamata identify
con l'indirizzo email
e gli eventi e le informazioni del profilo di entrambi i dispositivi e le sessioni verranno collegati.
Messaggio Identify
Il messaggio identify
ha due parti:
- Il
type
deve essere impostato su "identify" - L'oggetto
identities
deve essere fornito. Si tratta di un oggetto contenente coppie chiave/valore: la chiave è il tipo di identità, ad esempio "email" o "userId".
Gli eventi identify possono essere inviati in qualsiasi momento, anche se suggeriamo
Come vengono collegati i profili
Quando invii un messaggio identify
, il userId
e il sessionId
vengono registrati. Qualsiasi evento raccolto o dato del profilo utente impostato, con lo stesso userId
o sessionId
, viene unito nello stesso Profilo.
WARNING
È importante usare identify
solo quando si è certi di avere le informazioni identificative corrette, altrimenti si rischia di collegare profili non correlati, e non sarà possibile scollegarli in seguito.
Esempio
L'esempio seguente identifica la sessione / l'utente corrente tramite le identità email
e webPush
.
{
"type": "identify",
"identities": {
"email": "dean_martin@email.com",
"webPush": "https://fcm.googleapis.com/fcm/send/coZZH73CpTQ:APA91bFctF2JiYJz_Bf5QBlrAmVc2T5xcIFlegj8a8rIklNtZ9bEWUsadsdl_Xd9s3nps_lwhBBIXHGeYE5pJwJTkswrbx9o5e9Wk_hBElR5oBhw33ST84Zn0tlvqMaWKMy5TWaCtgWZ"
},
// dati generali dell'evento
"writeKey": "<WRITE_KEY>",
"messageId": "213d7f53-ffac-4a58-a20b-5d609455d64c",
"timestamp": "2022-11-15T04:31:44Z",
"userId": "5.wBOQ7hKNVgIUcJn5IbX.1670273082",
"sessionId": "28eef5c8-1098-4f76-abe9-58a921cabfaf",
"pageId": "eca34e0f-4802-4fa4-8db1-11c727839dbd"
}
INFO
Se utilizzi email
o phone
come identificatore, questi verranno automaticamente aggiunti come attributi utente semantici $email
e $phone
. Inoltre, gli identificatori email
e phone
verranno automaticamente mappati alle chiavi: $email
e $phone
.