Implementazione del servizio Experience Cloud Identity per Analytics

Queste istruzioni sono per i clienti di Analytics che desiderano usare il servizio Experience Cloud Identity e non usano Dynamic Tag Management (DTM). Tuttavia, si consiglia vivamente di usare Dynamic Tag Management per implementare il servizio ID. DTM semplifica il flusso di lavoro di implementazione e assicura automaticamente il posizionamento e la sequenza del codice corretti.

IMPORTANTE
  • Prima di iniziare, leggi i requisiti.
  • Configura e verifica questo codice in un ambiente di sviluppo prima di implementarlo in produzione.

Per implementare il servizio ID per Adobe Analytics, effettua le seguenti operazioni:

  1. Scarica il codice del servizio ID
  2. Aggiungi la funzione Visitor.getInstance al codice del servizio ID
  3. Aggiungi l'ID organizzazione Experience Cloud a Visitor.getInstance
  4. Aggiungi i server di monitoraggio a Visitor.getInstance
  5. Aggiorna il file AppMeasurement.js o s_code.js
  6. Aggiungi il codice API del visitatore alla pagina
  7. (Facoltativo) Configura un periodo di tolleranza
  8. Verifica e distribuisci il codice del servizio ID

Passaggio 1: scarica il codice del servizio ID

Il servizio ID richiede la libreria dei codici VisitorAPI.js. Per scaricare la libreria dei codici:

  1. Seleziona Amministratore > Gestione codici.

  2. In Gestione codici, fai clic su JavaScript (Nuovo) o su JavaScript (Legacy).

    Verranno scaricate le librerie dei codici compresse.

  3. Decomprimi il file dei codici e apri il VisitorAPI.js file.

Passaggio 2: Aggiungi la funzione Visitor.getInstance al codice del servizio ID

IMPORTANTE
  • Le versioni precedenti dell’API del servizio ID inserivano questa funzione in una posizione diversa e richiedevano una sintassi diversa. Se stai eseguendo la migrazione da una versione precedente alla versione 1.4, tieni presente la nuova posizione e la sintassi qui documentate.
  • Il codice in maiuscolo è un segnaposto per i valori effettivi. Sostituisci questo testo con il tuo ID organizzazione, l’URL del server di tracciamento o un altro valore denominato.

Parte 1: copia la funzione Visitor.getInstance di seguito

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION-ID-HERE", { 
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer 
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure 
 
     // To enable CNAME support, add the following configuration variables 
     // If you are not using CNAME, DO NOT include these variables 
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE", 
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure 
}); 

Parte 2: aggiungi il codice della funzione al file VisitorAPI.js

Posiziona la Visitor.getInstance funzione alla fine del file, dopo il blocco del codice. Il file modificato deve essere simile al seguente:

/* 
========== DO NOT ALTER ANYTHING BELOW THIS LINE ========== 
Version and copyright section 
*/ 
 
// Visitor API code library section 
 
// Put Visitor.getInstance at the end of the file, after the code library

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION-ID-HERE", { 
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer 
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure 
 
     // To enable CNAME support, add the following configuration variables 
     // If you are not using CNAME, DO NOT include these variables 
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE", 
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure 
}); 

Passaggio 3: aggiungi l'ID organizzazione Experience Cloud a Visitor.getInstance

Nella Visitor.getInstance funzione sostituisci INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE con l'ID organizzazione Experience Cloud. Se non conosci il tuo ID organizzazione, puoi trovarlo nella pagina di amministrazione di Experience Cloud. Vedi anche Amministrazione - Servizi di base. La funzione modificata deve essere simile a quella riportata di seguito.

var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...

IMPORTANTE

Non modificare le lettere maiuscole in minuscole e viceversa nell'ID organizzazione. L'ID distingue tra maiuscole e minuscole e deve essere utilizzato esattamente così come è stato fornito.

Passaggio 4: aggiungi i server di monitoraggio a Visitor.getInstance

I server di monitoraggio sono utilizzati per la raccolta dati di Analytics.

Parte 1: trova gli URL del server di tracciamento

Gli URL del server di monitoraggio si trovano nei file s_code.js e AppMeasurement.js. Devi trovare gli URL specificati dalle seguenti variabili:

  • s.trackingServer
  • s.trackingServerSecure

Parte 2: imposta le variabili del server di tracciamento

Per determinare quali variabili del server di tracciamento utilizzare:

  1. Rispondi alle domande riportate nella matrice di decisione seguente. Utilizza le variabili corrispondenti alle risposte.
  2. Sostituisci i segnaposto del server di tracciamento con gli URL del server di tracciamento.
  3. Rimuovi dal codice le variabili del server di tracciamento e di Experience Cloud non utilizzate.

Nota

Se utilizzati, gli URL del server Experience Cloud devono corrispondere a quelli del relativo server di tracciamento, come riportato di seguito:

  • URL del server Experience Cloud = URL del server di tracciamento
  • URL sicuro del server Experience Cloud = URL sicuro del server di tracciamento

Se non sei sicuro di come trovare il server di tracciamento, consulta le Domande frequenti e Compilare correttamente le variabili trackingServer e trackingServerSecure.

Passaggio 5: aggiorna il file AppMeasurement.js o s_code.js

Aggiungi questa funzione al file AppMeasurement.js o s_code.js:

s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");

Posiziona il codice nella stessa sezione che contiene configurazioni come linkInternalFilters, charSet, trackDownloads, ecc.

(Facoltativo ma consigliato) Crea un prop personalizzato.

Imposta un prop personalizzato in AppMeasurement.js o in s_code.js per misurare la copertura. Aggiungi il prop personalizzato alla doPlugins funzione del file AppMeasurement.js o s_code.js:

// prop1 is used as an example only. Choose any available prop. 
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

Passaggio 6: aggiungi il codice API del visitatore alla pagina

Inserisci il VisitorAPI.js file entro i tag <head> di ogni pagina. Quando inserisci il VisitorAPI.js file nella pagina:

  • Inseriscilo all'inizio della <head> sezione prima dei tag di altre soluzioni.
  • Deve essere eseguito prima di AppMeasurement e del codice di altre Experience Cloud soluzioni.

Dopo il test e la verifica, trasferisci il codice in produzione.

Passaggio 7: (facoltativo) configura un periodo di tolleranza

Se uno di questi casi d’uso è applicabile alla tua situazione, chiedi all’Assistenza clienti di impostare un periodo di tolleranza temporaneo. I periodi di tolleranza possono durare fino a 180 giorni. Se necessario, puoi rinnovare il periodo di tolleranza.

Implementazione parziale

Se solo alcune pagine utilizzano il servizio ID e tutte le pagine riferiscono alla stessa suite di Analytics rapporti, devi configurare un periodo di tolleranza. Ciò è comune se disponi di una suite di rapporti globale per più domini.

Interrompi il periodo di tolleranza dopo che il servizio ID è stato distribuito su tutte le pagine Web che riferiscono alla stessa suite di rapporti.

Requisiti del cookie s_vi

Devi impostare un periodo di tolleranza se dopo la migrazione al servizio ID richiedi ai nuovi visitatori un cookie s_vi. Ciò è comune se l’implementazione legge il cookie s_vi e lo memorizza in una variabile.

Puoi interrompere il periodo di tolleranza dopo che l’implementazione sarà in grado di acquisire il MID invece di leggere il cookie s_vi.

Consulta Cookie e il servizio Experience Cloud Identity.

Se invii dati a un sistema interno da un feed di dati click-stream e per i processi sono utilizzate le colonne visid_high e visid_low, devi attivare un periodo di tolleranza.

Quando il processo di inserimento dei dati può utilizzare le colonne post_visid_high e post_visid_low, interrompi il periodo di tolleranza.

Vedi la colonna di riferimento dei dati di click-stream.

Inserimento dei dati di click-stream

Passaggio 8: verifica e distribuisci il codice del servizio ID

Puoi eseguire il test e distribuirlo come segue.

Test e verifica

Per verificare l’implementazione del servizio ID, controlla i seguenti elementi:

Consulta Test e verifica del servizio Experience Cloud Identity.

Distribuisci il codice

Distribuisci il codice dopo aver superato il test.

Se hai attivato un periodo di tolleranza nel passaggio 7:

  • Verifica che Analytics l'ID di (AID) e il MID siano presenti nella richiesta di immagine.
  • Ricorda di disattivare il periodo di tolleranza quando sono presenti i requisiti per l'interruzione.

In questa pagina