Show Menu
TOPICS×

Implementazione del servizio Experience Cloud Identity per Analytics

Queste istruzioni sono per i clienti di Analytics 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.
  • Configura e verifica questo codice in un ambiente di sviluppo prima di implementarlo in produzione.
Per implementare il servizio ID per Adobe Analytics, effettua le seguenti operazioni:

Passaggio 1: scarica il codice del servizio ID

Il servizio ID richiede la libreria dei codici
VisitorAPI.js
. 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 2: 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 3: 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. Vedi anche Amministrazione - Servizi principali . 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 4: aggiungi i server di monitoraggio a Visitor.getInstance

I server di monitoraggio sono utilizzati per la raccolta dati di Analytics.
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 Experience Cloud URL del server con gli URL del server di tracciamento corrispondenti, come riportato di seguito: >
  • Experience Cloud URL del server = URL del server di tracciamento
  • Experience Cloud URL del server protetto = URL del server protetto di tracciamento
If you're not sure how to find your tracking server see the FAQ and Correctly Populate the trackingServer and trackingServerSecure variables .

Passaggio 5: aggiorna il file AppMeasurement.js o s_code.js

Aggiungi questa funzione al file
AppMeasurement.js
o
s_code.js
:
s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");
Posiziona il codice nella stessa sezione che contiene configurazioni come
linkInternalFilters
,
charSet
,
trackDownloads
, ecc.
***(Facoltativo ma consigliato)*Crea un prop personalizzato
Imposta un prop personalizzato in
AppMeasurement.js
o in
s_code.js
per misurare la copertura. Aggiungi il prop personalizzato alla
doPlugins
funzione del file
AppMeasurement.js
o
s_code.js
:
// prop1 is used as an example only. Choose any available prop. s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

Passaggio 6: 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.
Dopo il test e la verifica, trasferisci il codice in produzione.

Passaggio 7: (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 Analytics rapporti, 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.
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.
Inserimento dei dati di clickstream

Passaggio 8: 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 lo strumento Adobe Debugger .
Distribuisci il codice
Una volta superata la verifica, distribuisci il codice.
Se hai attivato un periodo di tolleranza al passaggio 7 :
  • Verifica che Analytics l'ID di (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.