Ottenere ID utente e aree geografiche tramite il servizio Adobe Experience Platform Identity get-user-ids-and-regions-through-the-experience-cloud-id-service

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

Il servizio Adobe Experience Platform Identity assegna gli ID visitatore e regione agli utenti che accedono al tuo sito Web. Questi ID identificano gli utenti in tutte le soluzioni di Experience Cloud e sono necessari se si desidera effettuare DCS chiamate.

  • user ID è necessario per identificare e associare i dati a un visitatore specifico.
  • region ID è obbligatorio perché è associato a un nome di server regionale, che è necessario inviare dati a DCS. DCS memorizza le informazioni nei data center 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 Experience Cloud di stato

Per utilizzare il servizio ID è necessario un account Experience Cloud di . Se hai un account Experience Cloud di , benissimo!

Se non fai parte dell'Experience Cloud , iscriviti. Ci piacerebbe averti e c'è sempre spazio per altro. Per istruzioni sulla configurazione di un account, vedere Abilitazione delle soluzioni per i servizi principali.

2. Configura il servizio ID
Il servizio ID è costituito da codice JavaScript inserito in ogni pagina che si desidera utilizzare per la raccolta 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 di regione nel cookie AMCV. Nome cookie completo: AMCV_###@AdobeOrg. Gli elementi ### sono segnaposto per l'ID organizzazione. Per ulteriori dettagli, vedere i cookie e l'ID Experience Cloud.

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.

È possibile effettuare chiamate al DCS di dopo aver ottenuto gli ID utente e di regione.

4. Recupera l'ID Experience Cloud con getMarketingCloudVisitorID

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

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

Utilizzo di getMarketingCloudVisitorID working-with-getmarketingcloudvisitorid

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

var analyticsID = visitor.getAnalyticsVisitorID(callback)

Utilizzo e scopo del callback callback-usage

callback è facoltativo. Questa funzione funziona senza di essa, ma restituisce un ID solo quando un visitatore ha un cookie Experience Cloud nel browser. Se manca il cookie visitatore o un visitatore non ha 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 restituirà un ID anche se viene scritto nel browser del visitatore in un secondo momento.

Passaggi successivi next-steps

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

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695