Ottenere ID utente e aree geografiche tramite il servizio Adobe Experience Platform Identity

I clienti del servizio ID devono consultare questa sezione per informazioni su come leggere il cookie del visitatore per gli ID richiesti per effettuare chiamate DCS API.

Il servizio Adobe Experience Platform Identity assegna gli ID visitatore e regione agli utenti che visitano il tuo sito web. Questi ID identificano gli utenti in tutte le soluzioni di Experience Cloud e sono necessari se desideri effettuare chiamate DCS.

  • È necessario user ID per identificare e associare i dati a un particolare visitatore.
  • Il region ID è obbligatorio perché è associato a un nome di server regionale, che è necessario inviare ai DCS. Il DCS memorizza le informazioni nei centri dati geograficamente più vicini ai visitatori del sito. Consulta ID regioni DCS, posizioni e nomi host.

I clienti del servizio ID possono estrarre queste informazioni dal cookie del servizio ID o chiamando una funzione . La tabella seguente descrive le attività o i passaggi da completare per iniziare.

Il codice in corsivo rappresenta un segnaposto variabile.

Attività Descrizione

1. Controlla il tuo stato Experience Cloud

Per usare il servizio ID è necessario un account Experience Cloud . Se disponi di un account Experience Cloud, ottimo!

Se non fai parte dell' Experience Cloud, registrati. Ci piacerebbe avere te e c'è sempre spazio per di più. Per istruzioni su come impostare un account, consulta Abilitazione delle soluzioni per i servizi di base .

2. Imposta il servizio ID

Il servizio ID è costituito da codice JavaScript da inserire in ogni pagina da utilizzare per la raccolta dei dati. Per ulteriori informazioni, consulta le guide all'implementazione del servizio ID .

3. Leggi il cookie del servizio ID

Il servizio ID memorizza l'ID utente e regione nel cookie AMCV. Il nome completo del cookie è AMCV_###@AdobeOrg. Gli elementi ### sono segnaposto per l’ID organizzazione. Per ulteriori informazioni, consulta Cookie e l'Experience Cloud ID .

Analizza il cookie AMCV per queste coppie chiave-valore:

  • mid=user ID: Questa coppia chiave-valore contiene l'ID utente Experience Cloud.
  • aamlh=region ID: Questa coppia chiave-valore contiene l'ID di regione (talvolta denominato hint di posizione) associato a un nome di server regionale.

Puoi effettuare chiamate al DCS una volta che disponi degli ID utente e di regione.

4. Recupera l' ID Experience Cloud con getMarketingCloudVisitorID

(Facoltativo) Questa funzione restituisce l'ID visitatore di Experience Cloud. È progettato per soluzioni personalizzate e casi d’uso specifici. Consulta Utilizzo di getMarketingCloudVisitorID di seguito e la relativa documentazione del servizio ID.

Non devi utilizzarlo se ottieni gli ID utente e posizione dal cookie del servizio ID.

Utilizzo di getMarketingCloudVisitorID

Un altro modo per ottenere l’ID visitatore è la funzione getMarketingCloudVisitorID . Quando viene invocata, questa funzione esegue una query sul ID service e restituisce un ID. getMarketingCloudVisitorID accetta l’ callback argomento facoltativo illustrato di seguito:

var analyticsID = visitor.getAnalyticsVisitorID(callback)

Utilizzo e scopo del callback

callback è facoltativo. Questa funzione funziona senza di essa, ma restituisce un ID solo quando un visitatore ha un cookie Experience Cloud nel proprio browser. Se manca il cookie del visitatore o se un visitatore non dispone di un ID, la funzione restituisce un oggetto () vuoto. Questo può accadere anche dopo il caricamento della pagina e il visitatore riceve un nuovo ID. Per evitare questo problema, callback forza questa funzione a verificare la presenza di un ID visitatore dopo il caricamento della pagina. Senza callback, la funzione ID visitatore non restituisce un ID nemmeno se è scritto nel browser del visitatore in un secondo momento.

Passaggi successivi

Una volta ottenuto l’ID utente e di regione, puoi iniziare a inviare e ricevere i dati DCS. Consulta Effettuare chiamate API DCS.

In questa pagina