Implementazione del servizio ID visitatore di Adobe per Analytics, Audience Manager e Target implement-the-experience-cloud-id-service-for-analytics-audience-manager-and-target

Queste istruzioni sono per i clienti di Analytics, Audience Manager e Target che desiderano usare il servizio ID visitatore e non usano tag. Tuttavia, si consiglia vivamente di utilizzare i tag per implementare il Servizio ID visitatore. I tag agevolano il flusso di lavoro di implementazione e assicurano automaticamente il posizionamento e la sequenza del codice corretti.

Passaggio 1: pianificazione dell’inoltro lato server section-880797cc992d4755b29cada7b831f1fc

Oltre ai passaggi qui descritti, i clienti che utilizzano 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:

Passaggio 2: scarica il codice del servizio ID visitatore section-0780126cf43e4ad9b6fc5fe17bb3ef86

Il servizio ID visitatori richiede la libreria di codici VisitorAPI.js. Per scaricare la libreria dei codici:

Passaggio 3: aggiungi la funzione Visitor.getInstance al codice del servizio ID visitatore section-9e30838b4d0741658a7a492153c49f27

Parte 1: copia la funzione Visitor.getInstance di seguito

var visitor = Visitor.getInstance("INSERT-IMS-ORG-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: aggiungere 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-IMS-ORG-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 IMS a Visitor.getInstance section-e2947313492546789b0c3b2fc3e897d8

Nella funzione Visitor.getInstance, sostituisci INSERT-IMS-ORG-ID-HERE con l’ID organizzazione IMS. Se non conosci il tuo ID organizzazione IMS, puoi trovarlo nella pagina di amministrazione di CX Enterprise. La funzione modificata deve essere simile a quella riportata di seguito.

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

Passaggio 5: aggiungi i server di monitoraggio a Visitor.getInstance section-0dfc52096ac2427f86045aab9a0e0dfc

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:

Parte 2: imposta le variabili del server di tracciamento

Per determinare quali variabili del server di tracciamento utilizzare:

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 section-5517e94a09bc44dfb492ebca14b43048

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-IMS-ORG-ID-HERE");

(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 section-c2bd096a3e484872a72967b6468d3673

Inserisci il VisitorAPI.js file entro i tag <head> di ogni pagina. Quando inserisci il VisitorAPI.js file nella pagina:

Passaggio 8: (facoltativo) configura un periodo di tolleranza section-aceacdb7d5794f25ac6ff46f82e148e1

Se uno di questi casi d’uso si applica alla tua situazione, chiedi a 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 visitatore e altre no e tutte le pagine riferiscono alla stessa suite di rapporti di Analytics, devi attivare 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 visitatore è stato distribuito su tutte le pagine web che riferiscono alla stessa suite di rapporti.

Requisiti del cookie s_vi

Se dopo la migrazione al servizio ID visitatore devi assegnare ai nuovi visitatori un cookie s_vi, devi attivare un periodo di tolleranza. 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 ID visitatori.

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 acquisizione 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 section-f857542bfc70496dbb9f318d6b3ae110

Le soluzioni CX Enterprise di questa implementazione restituiscono gli ID sotto forma di coppie chiave-valore. Ogni soluzione utilizza chiavi diverse (ad esempio, SDID di Analytics rispetto a mboxMCSDID di Target) 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 visitatore è stato implementato correttamente se le coppie chiave-valore elencate di seguito restituiscono gli stessi valori ID.

Tutte le soluzioni

Controlla che ci siano:

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

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:

Quando ricevi un AID, controllane il valore rispetto al valore mboxMCAVID di Target. Questi valori sono identici quando il Servizio ID visitatore è 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:

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

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

Implementazione

Passaggio 10: distribuisci section-4188fa95e7dc455a986b48a6c517c1c9

Distribuisci il codice dopo aver superato il test.

Se hai abilitato un periodo di tolleranza: