Show Menu
TOPICS×

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. Dynamic Tag Management semplifica l'implementazione e verifica automaticamente che il codice sia inserito correttamente e nella giusta sequenza.
  • Prima di iniziare , leggi i requisiti.
  • Questa procedura richiede AppMeasurement. I clienti che usano s_code non possono 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 DIL (codice di raccolta dati di Audience Manager) e sostituirlo con il modulo Gestione dell'audience . Per ulteriori informazioni, consulta la documentazione sull'inoltro lato server .
La migrazione all'inoltro lato server richiede un'attenta pianificazione e coordinazione. Il processo comporta modifiche esterne da apportare al codice del sito e passaggi interni che Adobe deve effettuare per il provisioning del tuo account. In effetti, molte di queste procedure di migrazione devono avvenire in parallelo ed essere rilasciate insieme. Il percorso di implementazione dovrà 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. Per iniziare, completa il modulo disponibile sul sito di integrazioni e provisioning .
  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 un'altra sintassi. Se effettui la migrazione da una versione precedente alla 1.4 , prendi nota della nuova posizione e della sintassi indicate in questo documento.
  • Il codice riportato in MAIUSCOLO funge da segnaposto per valori effettivi. Sostituisci tale testo con il tuo ID organizzazione, l'URL del server di tracciamento o altro valore con nome.
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 nel 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 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 usa 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 stabilire quali variabili usare per il server di monitoraggio:
  1. Rispondi alle domande riportate nella griglia seguente. Usa le variabili che corrispondono alle tue risposte.
  2. Sostituisci i segnaposto del server di monitoraggio con gli URL del server di monitoraggio.
  3. Rimuovi dal codice le variabili del server di tracciamento e di Experience Cloud non utilizzate.
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 del server protetto Experience Cloud = URL del server protetto di tracciamento
Se non sei sicuro di come trovare il server di tracciamento, consulta Domande frequenti e Aggiunta corretta delle 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. Vedi Implementazione dell'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

If any of these use cases apply to your situation, ask Customer Care to set up a temporary grace period . 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 rapporti Analytics, devi configurare un periodo di tolleranza. Questa situazione è frequente, se si dispone di una suite di rapporti globale per tutti i domini.
Dopo aver distribuito il servizio ID su tutte le pagine Web che riferiscono alla stessa suite di rapporti, interrompi il periodo di tolleranza.
Requisiti del cookie s_vi
Se, dopo la migrazione al servizio ID, richiedi ai nuovi visitatori il cookie s_vi, devi configurare il periodo di tolleranza. Questa situazione è frequente, se l'implementazione legge il cookie s_vi e lo memorizza in una variabile.
Quando l'implementazione può acquisire il MID, invece di leggere il cookie s_vi, puoi interrompere il periodo di tolleranza.
Integrazione dei dati di clickstream
Se invii dati a un sistema interno da un feed di dati clickstream 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: 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:
Per verificare l'inoltro lato server, consulta How to Verify your Server-Side Forwarding Implementation (Come verificare l'implementazione dell'inoltro lato server).
Distribuzione
Una volta superata la verifica, distribuisci il codice.
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.