Queste istruzioni sono per i clienti di Analytics e Audience Manager 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.
Oltre ai passaggi qui descritti, i clienti che usano Analytics e Audience Manager devono effettuare la migrazione all’inoltro lato server. L’inoltro lato server consente di rimuovere il DIL (codice di raccolta dati di Audience Manager) e sostituirlo con il modulo Gestione dell’audience. Per ulteriori informazioni, consulta la documentazione dell’inoltro lato server.
La migrazione all’inoltro lato server richiede pianificazione e coordinamento. Questo processo comporta modifiche esterne al codice del sito e passaggi interni che Adobe deve effettuare per il provisioning del tuo account. Infatti, molte di queste procedure di migrazione devono avvenire in parallelo ed essere rilasciate insieme. Il percorso di implementazione deve seguire questa sequenza di eventi:
Pianifica con i tuoi contatti per Analytics e Audience Manager la migrazione dell'inoltro lato server e il servizio ID. La selezione del server di tracciamento è una fase importante di questo piano.
Completa il modulo sulle integrazioni e sul sito di provisioning per iniziare.
Implementa il servizio ID e il Audience Management Module simultaneamente. Per funzionare correttamente, il Audience Management Module (inoltro lato server) e il servizio ID devono essere rilasciati per lo stesso set di pagine e allo stesso tempo.
Il servizio ID richiede la VisitorAPI.js
libreria dei codici. 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.
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 Visitor API.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
});
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. La funzione modificata deve essere simile a quella riportata di seguito.
var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...
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.
Analytics utilizza i server di tracciamento per la raccolta dei dati.
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:
Se utilizzato, fai corrispondere gli URL del server Experience Cloud con gli URL del server di tracciamento corrispondenti, come riportato di seguito:
Se non sei sicuro di come trovare il server di tracciamento, consulta le Domande frequenti e Compilare correttamente le variabili trackingServer e trackingServerSecure.
Questo passaggio richiede AppMeasurement. Se utilizzi ancora s_code, non potrai procedere.
Aggiungi la Visitor.getInstance
funzione riportata di seguito al tuo AppMeasurement.js
file. Inseriscilo nella stessa sezione che contiene configurazioni come linkInternalFilters
, charSet
, trackDownloads
, ecc.:
s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");
A questo punto, devi rimuovere il codice Audience Manager DIL e sostituirlo con il modulo Gestione dell'audience. Per istruzioni consulta Implementare l’inoltro lato server.
(Facoltativo ma consigliato) Crea un prop personalizzato.
Imposta un prop personalizzato in AppMeasurement.js
per misurare la copertura. Aggiungi il prop personalizzato alla doPlugins
funzione del AppMeasurement.js
file:
// prop1 is used as an example only. Choose any available prop.
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");
Inserisci il VisitorAPI.js
file entro i tag <head>
di ogni pagina. Quando inserisci il VisitorAPI.js
file nella pagina:
<head>
sezione prima dei tag di altre soluzioni.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 alcune pagine utilizzano il servizio ID e altre no e tutte le pagine riferiscono alla stessa suite di rapporti di Analytics, devi impostare 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 anche Cookie e il servizio Experience Cloud Identity.
Integrazione dei dati di click-stream
Se invii dati a un sistema interno da un feed di dati di 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 anche la colonna di riferimento dei dati di click-stream.
Puoi eseguire il test e distribuirlo come segue.
Test e verifica
Per verificare l’implementazione del servizio ID, controlla i seguenti elementi:
Per verificare l’inoltro lato server, vedi Come verificare l’implementazione dell’inoltro lato server.
Distribuzione
Distribuisci il codice dopo aver superato il test.
Se hai attivato un periodo di tolleranza: