Implementazione del servizio Experience Cloud Identity per Analytics implement-the-experience-cloud-id-service-for-analytics
Queste istruzioni sono per chi utilizza Analytics e desidera usare il servizio Experience Cloud Identity e non usa i tag di Raccolta dati. Tuttavia, si consiglia vivamente di usare i tag per implementare il servizio ID. I tag agevolano il flusso di lavoro di implementazione e assicurano automaticamente il posizionamento e la sequenza del codice corretti.
- 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:
- Scarica il codice del servizio ID
- Aggiungi la funzione Visitor.getInstance al codice del servizio ID
- Aggiungi l'ID organizzazione Experience Cloud a Visitor.getInstance
- Aggiungi i server di monitoraggio a Visitor.getInstance
- Aggiorna il file AppMeasurement.js o s_code.js
- Aggiungi il codice API del visitatore alla pagina
- (Facoltativo) Configura un periodo di tolleranza
- Verifica e distribuisci il codice del servizio ID
Passaggio 1: scarica il codice del servizio ID section-ead9403a6b7e45b887f9ac959ef89f7f
Il servizio ID richiede la libreria dei codici VisitorAPI.js
. Per scaricare la libreria dei codici:
-
Seleziona Amministratore > Gestione codici.
-
In Gestione codici, fai clic su JavaScript (Nuovo) o su JavaScript (Legacy).
Verranno scaricate le librerie dei codici compresse.
-
Decomprimi il file dei codici e apri il
VisitorAPI.js
file.
Passaggio 2: Aggiungi la funzione Visitor.getInstance al codice del servizio ID section-6053a6b7c16c466a9f9fdbf9cb9db3df
- 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 section-7b8a6e76dc124d0e9ab1ce96ab2ffb0e
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", { ...
Passaggio 4: aggiungi i server di monitoraggio a Visitor.getInstance section-70ec9ebff47940d8ab520be5ec4728c5
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:
- Rispondi alle domande riportate nella matrice di decisione seguente. Utilizza le variabili corrispondenti alle risposte.
- Sostituisci i segnaposto del server di tracciamento con gli URL del server di tracciamento.
- Rimuovi dal codice le variabili del server di tracciamento e di Experience Cloud non utilizzate.
- 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 section-b53113aea1bd4de896e0e4e9a7edee19
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 section-d46d6aa324c842f2931d901e38d6db1d
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 section-7bbb2f72c26e4abeb8881e18366797a3
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 section-e9c1764ac21a4ec5be1ff338c0e2e01b
Puoi eseguire il test e distribuirlo come segue.
Test e verifica
Per verificare l’implementazione del servizio ID, controlla i seguenti elementi:
- Cookie AMCV nel dominio di hosting della pagina.
- Valore MID nella richiesta di immagine Analytics con lo strumento Adobe Debugger.
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.