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

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

Il Servizio identità Adobe Experience Platform assegna gli ID visitatore e regione agli utenti che arrivano sul sito Web. Questi ID identificano gli utenti in tutte le soluzioni del Experience Cloud sito e sono richiesti se si desidera effettuare DCS chiamate.

  • L’utente user ID è tenuto a identificare e associare i dati a un particolare visitatore.
  • Il region ID campo è obbligatorio perché è associato a un nome di server regionale, che è necessario inviare ai DCS. Le informazioni DCS vengono memorizzate 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 lo stato Experience Cloud

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

Se non fate parte del Experience Cloud, registratevi. Ci piacerebbe avere te e c'è sempre spazio per di più. Per istruzioni su come impostare un account, consultate Abilitazione delle soluzioni per i servizidi base.

2. Configurare il servizio ID

Il servizio ID è costituito dal codice JavaScript che viene inserito 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 l’ID di regione nel cookie AMCV. Il nome completo del cookie è AMCV_###@AdobeOrg. Gli ### elementi sono segnaposto per l'ID organizzazione. Consulta Cookie e il Experience Cloud ID per ulteriori dettagli.

Analizzare il cookie AMCV per le seguenti 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 hintdi posizione) associato a un nome server regionale.

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

4. Recuperare l’ ID Experience Cloud con getMarketingCloudVisitorID

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

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

Utilizzo getMarketingCloudVisitorID

Un altro modo per ottenere l’ID visitatore è utilizzare la getMarketingCloudVisitorID funzione. Quando viene richiamata, questa funzione esegue una query sull'oggetto ID service e restituisce un ID. getMarketingCloudVisitorID accetta l' callback argomento facoltativo come mostrato:

var analyticsID = visitor.getAnalyticsVisitorID(callback)

Utilizzo e scopo della callback

callback è facoltativo. Questa funzione funziona senza di essa, ma restituisce un ID solo quando un visitatore ha un Experience Cloud cookie nel suo browser. Se manca il cookie del visitatore o se il visitatore non dispone di un ID, la funzione restituisce un () oggetto vuoto. Questo può accadere anche dopo che la pagina viene caricata 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. In caso contrario, callbackla funzione ID visitatore non restituirà un ID nemmeno se verrà successivamente scritto nel browser del visitatore.

Passaggi successivi

Una volta ottenuto l’ID utente e di regione, potete iniziare a inviare e ricevere DCS i dati. Consultate Effettuare chiamateDCS API.

In questa pagina