Implementazione del servizio Experience Cloud Identity per Analytics implement-the-experience-cloud-id-service-for-analytics

Queste istruzioni sono per chi utilizza Analytics e desidera usare il servizio Experience Cloud Identity e non usa i tag di Raccolta dati. Tuttavia, si consiglia vivamente di usare i tag per implementare il servizio ID. I tag agevolano il flusso di lavoro di implementazione e assicurano automaticamente il posizionamento e la sequenza del codice corretti.

IMPORTANT
  • 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 section-ead9403a6b7e45b887f9ac959ef89f7f

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 section-6053a6b7c16c466a9f9fdbf9cb9db3df

IMPORTANT
  • 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 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 section-7b8a6e76dc124d0e9ab1ce96ab2ffb0e

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

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

IMPORTANT
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 section-70ec9ebff47940d8ab520be5ec4728c5

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

NOTE
Se utilizzati, gli URL del server Experience Cloud devono corrispondere a quelli del relativo server di tracciamento, come riportato di seguito:
  • URL del server Experience Cloud = URL del server di tracciamento
  • URL sicuro del server Experience Cloud = URL sicuro 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 5: aggiorna il file AppMeasurement.js o s_code.js section-b53113aea1bd4de896e0e4e9a7edee19

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 section-d46d6aa324c842f2931d901e38d6db1d

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 section-7bbb2f72c26e4abeb8881e18366797a3

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 solo alcune pagine utilizzano il servizio ID e tutte le pagine riferiscono alla stessa suite di Analytics rapporti, devi configurare 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 Cookie e il servizio Experience Cloud Identity.

Se invii dati a un sistema interno da un feed di dati 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 la colonna di riferimento dei dati di click-stream.

Inserimento dei dati di click-stream

Passaggio 8: verifica e distribuisci il codice del servizio ID section-e9c1764ac21a4ec5be1ff338c0e2e01b

Puoi eseguire il test e distribuirlo come segue.

Test e verifica

Per verificare l’implementazione del servizio ID, controlla i seguenti elementi:

Consulta Test e verifica del servizio Experience Cloud Identity.

Distribuisci il codice

Distribuisci il codice dopo aver superato il test.

Se hai attivato un periodo di tolleranza nel 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.
recommendation-more-help
9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a