Implementazione del servizio Experience Cloud Identity per Analytics e Audience Manager

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.

Passaggio 1: pianificazione dell'inoltro lato server

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:

1. 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.

2. Completa il modulo sulle integrazioni e sul sito di provisioning per iniziare.

3. 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.

Passaggio 2: scarica il codice del servizio ID

Il servizio ID richiede la VisitorAPI.js libreria dei codici. 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 3: aggiungi la funzione Visitor.getInstance al codice del servizio ID

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
});

Passaggio 4: 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. La funzione modificata deve essere simile a quella riportata di seguito.

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

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

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:

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 non utilizzate del server di tracciamento e del server Experience Cloud.

• URL del server Experience Cloud = URL del server di tracciamento
• URL protetto del server Experience Cloud = URL protetto 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 6: aggiorna il file AppMeasurement.js

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");

(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");

Passaggio 7: 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.

Passaggio 8: (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 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.

Passaggio 9: 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:

• Cookie AMCV nel dominio di hosting della pagina.
• Valore MID nella richiesta di immagine di Analytics con Adobe debugger.
• Consulta anche Testare e verificare il servizio Experience Cloud Identity.

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:

• Verifica che l’ID di Analytics (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.