Implementare Experience Cloud Identity Service per Analytics, Audience Manager e Target implement-the-experience-cloud-id-service-for-analytics-audience-manager-and-target

Queste istruzioni sono per chi utilizza Analytics, Audience Manager e Target, desidera utilizzare Experience Cloud Identity Service 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.

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

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:

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

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

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

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

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

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-MARKETING-CLOUD-ORGANIZATION 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 è 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.

Consulta anche I cookie ed Experience Cloud Identity Service.

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.

Vedi anche la colonna di riferimento dei dati di click-stream.

Passaggio 9: test e verifica section-f857542bfc70496dbb9f318d6b3ae110

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.

Tutte le soluzioni

Controlla che ci siano:

Per ulteriori verifiche utili per determinare se il servizio ID funziona correttamente, consulta Testare e verificare Experience Cloud Identity Service.

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

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

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 section-4188fa95e7dc455a986b48a6c517c1c9

Distribuisci il codice dopo aver superato il test.

Se hai attivato un periodo di tolleranza: