Show Menu
TOPICS×

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

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

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