Identità Utente

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

Introduzione

Fanplayr 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. Fanplayr 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 Fanplayr.

Quando si fornisce un'identità nota all'integrazione di Fanplayr, Fanplayr è 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 Fanplayr.

Identificazione dell'Utente

Le identità utente vengono condivise con Fanplayr 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 Fanplayr. Associa anche attributi aggiuntivi tramite l'oggetto data.

{
  "$user": {
    "userId": "23872392383"
  },
  "crm1": {
    "userId": "b70115f2-aea8-456a-ab07-f9152257df4d",
    "data": {
      "key1": "value1",
      "key2": "value2"
    }
  }
}

Tipi di dati

MappaIdentità

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

Identità

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à:

{
  "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 Fanplayr

Il Data Layer di Fanplayr può essere utilizzato per inviare identità a Fanplayr 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:

<!--
  Questo esempio presuppone che tu abbia definito l'array del Data Layer di Fanplayr
  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 Fanplayr consente di definire e gestire i provider di identità. Queste informazioni vengono utilizzate dal servizio Streams di Fanplayr per capire quale identità utente debba essere trasmessa con i dati a endpoint esterni che potresti aver definito.

Ad esempio, se hai collegato Fanplayr a un CRM e desideri includere l'ID CRM dell'utente con i dati che Fanplayr 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 Fanplayr 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 Fanplayr. Es. "Salesforce".

Identità dell'Utente Autenticato

Fanplayr 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 Fanplayr per associare l'identità dell'utente autenticato all'utente Fanplayr:

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 Fanplayr 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. Fanplayr associa una chiave utente unica al loro browser, ad esempio "User_1234".
• Fanplayr 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 Fanplayr per informare Fanplayr dell'identità dell'utente autenticato per il sito web

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

• Da questo momento in poi, Fanplayr 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, Fanplayr assegnerà una nuova chiave utente all'utente, ad esempio "User_5678".
• Infine, se l'utente accede nuovamente al sito web e a Fanplayr viene fornita la stessa identità utente autenticata di "234902834211", Fanplayr capirà che gli utenti "User_1234" e "User_5678" sono gli stessi e li unirà per formare un unico profilo e cronologia.