Implementazione del servizio Experience Cloud Identity per Analytics, Audience Manager e Target

Queste istruzioni sono per i clienti di Analytics, Audience Manager e Target 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

Leggi i requisiti del servizio ID e prendi nota dei seguenti requisiti specifici per questa implementazione:

  • I clienti che usano s_code non possono completare questa procedura. Esegui l’aggiornamento al codice mbox v61 per completare questa procedura.
  • Configura e verifica questo codice in un ambiente di sviluppo prima di implementarlo in produzione.

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

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 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", { ...

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

Nota

Se utilizzato, fai corrispondere gli URL del server Experience Cloud con gli URL del server di tracciamento corrispondenti, come riportato di seguito:

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

IMPORTANTE

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

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: test e verifica

Le soluzioni Experience Cloud di questa implementazione restituiscono gli ID sotto forma di coppie chiave-valore. Ogni soluzione usa chiavi diverse (ad esempio, Analytics SDID di e Target mboxMCSDID di) per lo stesso ID. Per verificare il corretto funzionamento dell'implementazione, carica le pagine in un ambiente di sviluppo. Usa la console del browser o un software per monitorare le richieste HTTP e le risposte, e controlla gli ID elencati di seguito. Il servizio ID è stato implementato correttamente se le coppie chiave-valore elencate di seguito restituiscono gli stessi valori ID.

SUGGERIMENTO

Puoi usare Adobe debugger o il proxy HTTP Charles per verificare la presenza degli ID specifici della soluzione. Puoi anche usare un altro strumento o debugger di tua preferenza.

Tutte le soluzioni

Controlla che ci siano:

  • Cookie AMCV nel dominio di hosting della pagina.
  • Experience Cloud ID (MID) con Adobe Debugger o altro strumento di debug.

Per ulteriori verifiche utili per determinare se il servizio ID funziona correttamente, consulta Test e verifica del servizio Experience Cloud Identity.

Analytics

Verifica la presenza dell’identificatore SDID nella richiesta JavaScript. Il valore SDID di Analytics deve corrispondere al valore mboxMCSDID di Target.

Se i test restituiscono un AID, questo può indicare che:

  • Sei un visitatore precedente ed è in corso la migrazione degli Analytics ID precedenti.
  • Hai impostato un periodo di tolleranza.

Quando ricevi un AID, controllane il valore rispetto al valore Target mboxMCAVID di. Questi valori sono identici se il servizio ID è stato implementato correttamente.

Audience Manager

Per verificare l’inoltro lato server, consulta Come verificare l’implementazione dell’inoltro lato server.

Target

Controlla che ci siano:

  • mboxMCGVID
  • mboxMCSDID (il valore mboxMCSDID deve corrispondere al valore SDID di Analytics).

Se i test restituiscono un mboxMCAVID, questo può indicare che:

  • Sei un visitatore precedente ed è in corso la migrazione degli Analytics ID precedenti.
  • Hai impostato un periodo di tolleranza.

Quando ricevi un mboxMCAVID, controllane il valore rispetto al valore Analytics AID di. Questi valori sono identici se il servizio ID è stato implementato correttamente.

Implementazione

Passaggio 10: distribuisci

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.

In questa pagina