Identità - Recupero dell'ID Experience Cloud

Adobe Experience Platform Web SDK sfrutta servizioidentità Adobe. In questo modo, ogni dispositivo ha un identificatore univoco persistente sul dispositivo, in modo che l'attività tra le pagine possa essere legata insieme.

Identità di prima parte

L' Identity Service identità viene memorizzata in un cookie in un dominio di prime parti. Il cookie Identity Service tenta di impostarlo utilizzando un'intestazione HTTP sul dominio. In caso contrario, Identity Service torneranno a impostare i cookie tramite Javascript. Adobe consiglia di impostare un CNAME in modo che i cookie non siano limitati dalle restrizioni ITP lato client.

identità di terze parti

L' Identity Service utente può sincronizzare un ID con un dominio di terze parti (demdex.net) per abilitare il tracciamento tra siti. Quando questa opzione è attivata, la prima richiesta per un visitatore (ad esempio, un utente senza un ECID) verrà effettuata su demdex.net. Questo verrà fatto solo sui browser che lo consentono (ad es. Chrome) ed è controllato dal thirdPartyCookiesEnabled parametro nella configurazione. Se desiderate disattivare questa funzione tutte insieme, impostate thirdPartyCookiesEnabled su false.

Migrazione ID

Durante la migrazione dall’utilizzo dell’API Visitor, puoi anche migrare i cookie AMCV esistenti. Per abilitare la migrazione ECID, imposta il idMigrationEnabled parametro nella configurazione. La migrazione degli ID abilita i seguenti casi di utilizzo:

  • Quando alcune pagine di un dominio utilizzano l’API del visitatore e altre pagine utilizzano questo SDK. Per supportare questo caso, l’SDK legge i cookie AMCV esistenti e scrive un nuovo cookie con l’ECID esistente. Inoltre, l’SDK scrive i cookie AMCV in modo che, se l’ECID viene ottenuto per primo su una pagina dotata di strumenti SDK, le pagine successive strumentalizzate con l’API del visitatore abbiano lo stesso ECID.
  • Quando Adobe Experience Platform Web SDK è impostato su una pagina che dispone anche di Visitor API. Per supportare questo caso, se il cookie AMCV non è impostato, l’SDK cerca l’API del visitatore sulla pagina e la chiama per ottenere l’ECID.
  • Se l’intero sito utilizza Adobe Experience Platform Web SDK e non dispone di API visitatore, è utile migrare gli ECID in modo da mantenere le informazioni sul visitatore di ritorno. Dopo che l’SDK è stato distribuito con idMigrationEnabled per un periodo di tempo tale da consentire la migrazione della maggior parte dei cookie del visitatore, l’impostazione può essere disattivata.

Recupero dell’ID visitatore

Se desiderate utilizzare questo ID univoco, usate il getIdentity comando. getIdentity restituisce l’ECID esistente per il visitatore corrente. Per i nuovi visitatori che non dispongono ancora di un ECID, questo comando genera un nuovo ECID.

NOTA

Questo metodo viene in genere utilizzato con soluzioni personalizzate che richiedono la lettura dell' Experience Cloud ID. Non viene utilizzata da un’implementazione standard.

alloy("getIdentity")
  .then(function(result) {
    // The command succeeded.
    console.log(result.identity.ECID);
  })
  .catch(function(error) {
    // The command failed.
    // "error" will be an error object with additional information.
  });

Sincronizzazione delle identità

NOTA

Il syncIdentity metodo è stato rimosso nella versione 2.1.0, oltre alla funzione di hashing. Se si utilizza la versione 2.1.0+ e si desidera sincronizzare le identità, è possibile inviarle direttamente nell' xdm opzione del sendEvent comando, sotto il identityMap campo.

Inoltre, Identity Service consente di sincronizzare i propri identificatori con l'ECID utilizzando il syncIdentity comando.

NOTA

Si consiglia vivamente di trasmettere tutte le identità disponibili su ogni sendEvent comando. Questo consente di aprire una serie di casi di utilizzo, inclusa la personalizzazione. Ora che puoi trasmettere queste identità nel sendEvent comando, puoi posizionarle direttamente nel tuo DataLayer.

La sincronizzazione delle identità consente di identificare un dispositivo/utente utilizzando più identità, impostarne lo stato di autenticazione e decidere quale identificatore è considerato principale. Se non è stato impostato alcun identificatore, primaryil valore predefinito principale sarà il ECID.

alloy("sendEvent", {
  xdm: {
    "identityMap": {
      "ID_NAMESPACE": [ // Notice how each namespace can contain multiple identifiers.
        {
          "id": "1234",
          "authenticatedState": "ambiguous",
          "primary": true
        }
      ]
    }
  }
});

Ogni proprietà all'interno identityMap rappresenta identità appartenenti a un particolare spazio dei nomi diidentità. Il nome della proprietà deve essere il simbolo dello spazio dei nomi dell'identità, che è possibile trovare elencato nell'interfaccia utente di Adobe Experience Platform in "Identities". Il valore della proprietà deve essere un array di identità appartenenti a tale namespace di identità.

Ciascun oggetto identity nell'array identities è strutturato come segue:

id

Tipo Obbligatorio Valore predefinito
Stringa Nessuno

Questo è l'ID che si desidera sincronizzare per lo spazio dei nomi specificato.

authenticationState

Tipo Obbligatorio Valore predefinito Valori possibili
Stringa ambiguo ambiguo, autenticato e logout

Stato di autenticazione dell’ID.

primary

Tipo Obbligatorio Valore predefinito
Booleano optional false

Determina se questa identità deve essere utilizzata come frammento principale nel profilo unificato. Per impostazione predefinita, l’ECID è impostato come identificatore principale per l’utente.

In questa pagina