Verada Docs

Identità Utente ​

Gestire le identità degli utenti per migliorare la capacità di identificare gli utenti di ritorno.

Introduzione ​

Verada identifica gli utenti assegnando un identificatore anonimo unico nel loro browser. Gli utenti di ritorno vengono rilevati quando tornano al tuo sito web con lo stesso browser.

Gli utenti potrebbero utilizzare browser diversi, passare da un dispositivo mobile a un laptop o cancellare periodicamente i dati di navigazione. Verada offre la possibilità di collegare i movimenti degli utenti attraverso diverse piattaforme, fornendo una visione olistica del percorso dell'utente. Ciò si ottiene fornendo una o più identità note a Verada.

Quando si fornisce un'identità nota all'integrazione di Verada, Verada è in grado di collegare e unire gli utenti che condividono la stessa identità. Ciò espande notevolmente la capacità di ottenere insight azionabili dai dati comportamentali acquisiti da Verada.

Identificazione dell'Utente ​

Le identità utente vengono condivise con Verada fornendo un oggetto mappa di identità tramite le integrazioni di Page Tracking e Order Tracking.

Esempio ​

Di seguito è riportato un esempio di struttura dati della mappa di identità che fornisce dettagli per due identità denominate $user e crm1.

  • Ogni oggetto identità ha una proprietà userId obbligatoria che specifica un identificatore utente unico per il tipo di identità.
  • L'identità speciale $user viene utilizzata per specificare l'ID di un utente autenticato sul sito web o sull'app.
  • I nomi dei tipi di identità utilizzati sono arbitrari e possono essere qualsiasi nome alfanumerico significativo per il tuo ambiente. In questo esempio, crm1 viene utilizzato per associare l'ID dell'utente in un sistema di gestione delle relazioni con i clienti all'identità utente di Verada. Associa anche attributi aggiuntivi tramite l'oggetto data.
json
{
  "$user": {
    "userId": "23872392383"
  },
  "crm1": {
    "userId": "b70115f2-aea8-456a-ab07-f9152257df4d",
    "data": {
      "key1": "value1",
      "key2": "value2"
    }
  }
}

Tipi di dati ​

MappaIdentità ​

typescript
// Un oggetto con chiavi che corrispondono a ciascuno
interface IdentityMap {
  [providerId: string]: Identity;
  // Un'identità speciale opzionale supportata da Verada per rappresentare un
  // ID utente autenticato per il sito web.
  $user?: Identity;
}

Identità ​

typescript
interface Identity {
  // L'identificatore utente unico.
  userId: string;
  // Un oggetto opzionale di dati arbitrari.
  data: {
    [key: string]: any;
  };
}

Identificazione degli utenti tramite il tag Page Tracking ​

Il tag JavaScript di Page Tracking supporta una proprietà identities che accetta una mappa di identità:

json
{
  "version": 3,
  "accountKey": "...",
  "data": {
    "pageType": "..."
  },
  "identities": {
    "$user": {
      "userId": "23872392383"
    },
    "crm1": {
      "userId": "b70115f2-aea8-456a-ab07-f9152257df4d",
      "data": {
        "key1": "value1",
        "key2": "value2"
      }
    }
  }
}

Identificazione degli utenti tramite il Data Layer di Verada ​

Il Data Layer di Verada può essere utilizzato per inviare identità a Verada senza doverle predefinire nel tuo tag Page Tracking.

Dopo aver definito il data layer sul tuo sito web, è sufficiente inviare le identità ad esso come segue:

html
<!--
  Questo esempio presuppone che tu abbia definito l'array del Data Layer di Verada
  in precedenza nel documento come segue:
-->
<script>
  var fanplayr_api = [];
</script>

<script>
  fanplayr_api.push({
    _type: 'identities',
    $user: {
      userId: '23872392383'
    },
    crm1: {
      userId: 'b70115f2-aea8-456a-ab07-f9152257df4d',
      data: {
        key1: 'value1",
        key2: "value2"
      }
    }
  });
</script>

Gestione dei Provider di Identità ​

L'area di Gestione delle Identità del Portale Verada consente di definire e gestire i provider di identità. Queste informazioni vengono utilizzate dal servizio Streams di Verada per capire quale identità utente debba essere trasmessa con i dati a endpoint esterni che potresti aver definito.

Ad esempio, se hai collegato Verada a un CRM e desideri includere l'ID CRM dell'utente con i dati che Verada trasmette nel tuo CRM, dovresti creare un provider di identità per il CRM, quindi fornire l'identità pertinente tramite uno dei metodi sopra indicati. Quando Verada trasmette dati nel CRM, includerà l'identità ad essa associata.

Ogni identità fornita ha le seguenti proprietà:

  • chiave - Un identificatore unico che può essere qualsiasi valore stringa. Questa chiave viene utilizzata nell'oggetto JavaScript della mappa di identità. Es. "crm1".
  • nome - Un nome di visualizzazione unico per l'identità. Questo è visibile solo nel portale Verada. Es. "Salesforce".

Identità dell'Utente Autenticato ​

Verada supporta una chiave speciale del provider di identità $user che può essere utilizzata per passare l'identità di un utente autenticato per il sito web.

Ad esempio, dopo che un utente effettua l'accesso al sito web, è possibile utilizzare la variabile del data layer di Verada per associare l'identità dell'utente autenticato all'utente Verada:

javascript
fanplayr_api.push({
  _type: 'identities',
  $user: {
    userId: '234902834211'
  }
});

INFO

Nota: Questo metodo per specificare l'identità dell'utente autenticato è equivalente alla specifica della proprietà customerId nel tag Page Tracking. Questo metodo è quello preferito, tuttavia la proprietà customerId continuerà a funzionare per la retrocompatibilità.

Unione delle Identità Utente ​

È importante capire che Verada unirà automaticamente gli utenti individuali che rileva e che hanno un'identità sovrapposta.

Ad esempio:

  • Un utente anonimo visita il tuo sito web per la prima volta. Verada associa una chiave utente unica al loro browser, ad esempio "User_1234".
  • Verada continuerà a identificare l'utente finché tornerà con la stessa chiave utente.
  • Successivamente, l'utente accede al sito web e il sito web utilizza il sistema di gestione delle identità di Verada per informare Verada dell'identità dell'utente autenticato per il sito web
javascript
fanplayr_api.push({
  _type: 'identities',
  $user: {
    userId: '234902834211'
  }
});
  • Da questo momento in poi, Verada collegherà la sua chiave utente "User_1234" con l'identità utente autenticata del sito web "234902834211".
  • In seguito, se l'utente torna al sito web su un dispositivo diverso o dopo aver cancellato i dati di navigazione, Verada assegnerà una nuova chiave utente all'utente, ad esempio "User_5678".
  • Infine, se l'utente accede nuovamente al sito web e a Verada viene fornita la stessa identità utente autenticata di "234902834211", Verada capirà che gli utenti "User_1234" e "User_5678" sono gli stessi e li unirà per formare un unico profilo e cronologia.

Copyright © 2011-present Verada