Plug-in di Adobe: manageVars

IMPORTANT
Questo plug-in è fornito a titolo di cortesia da Adobe Consulting per aiutarti a ottenere più valore da Adobe Analytics. L’Assistenza clienti di Adobe non fornisce supporto per questo plug-in, per la sua installazione né per la risoluzione di problemi. Se hai bisogno di aiuto con questo plug-in, contatta il team dell’account Adobe della tua organizzazione. Il team può organizzare una riunione con un consulente per l’assistenza.

Il manageVars Il plug-in consente di manipolare i valori di più variabili di Analytics contemporaneamente. Puoi anche impostare i valori in minuscolo o rimuovere contemporaneamente caratteri non necessari da più valori di variabili. L’Adobe consiglia di utilizzare questo plug-in per pulire il valore di più variabili contemporaneamente.

Installare il plug-in utilizzando l’estensione Web SDK o Web SDK

Questo plug-in non è ancora supportato per l’utilizzo nell’SDK per web.

Installare il plug-in utilizzando l’estensione Adobe Analytics

Adobe offre un’estensione che consente di utilizzare i plug-in più comunemente utilizzati con Adobe Analytics.

  1. Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.

  2. Fai clic sulla proprietà del tag desiderata.

  3. Vai a Extensions , quindi fare clic sul pulsante Catalog pulsante

  4. Installare e pubblicare Common Analytics Plugins estensione

  5. Se non lo hai già fatto, crea una regola denominata "Initialize Plug-ins" (Inizializza plug-in) con la seguente configurazione:

    • Condizione: nessuna
    • Evento: Core - Library Loaded (Page Top)
  6. Aggiungi un’azione alla regola precedente con la seguente configurazione:

    • Estensione: Common Analytics Plugins
    • Tipo azione: inizializza manageVars
  7. Salva e pubblica le modifiche apportate alla regola.

Installare il plug-in utilizzando l’editor di codice personalizzato

Se non desideri utilizzare l’estensione del plug-in Common Analytics Plugins, puoi utilizzare l’editor di codice personalizzato.

  1. Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
  2. Fai clic sulla proprietà desiderata.
  3. Vai a Extensions , quindi fare clic sulla scheda Configure sotto l'estensione Adobe Analytics.
  4. Espandi Configure tracking using custom code Pannello a soffietto, che mostra Open Editor pulsante.
  5. Apri l’editor di codice personalizzato e incolla il codice del plug-in fornito di seguito nella finestra di modifica.
  6. Salva e pubblica le modifiche nell’estensione Analytics.

Installare il plug-in utilizzando AppMeasurement

Copia e incolla il seguente codice in qualsiasi punto del file di AppMeasurement dopo la creazione dell'istanza dell'oggetto di tracciamento di Analytics (utilizzando s_gi). Mantenere i commenti e i numeri di versione del codice nella tua implementazione aiuta ad Adobe nella risoluzione di eventuali problemi.

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: manageVars v3.0 (Requires AppMeasurement) */
function manageVars(cb,l,il){var g=cb,c=l,d=il;if("-v"===g)return{plugin:"manageVars",version:"3.0"};var f=function(){if("undefined"!==typeof window.s_c_il)for(var a=0,b;a<window.s_c_il.length;a++)if(b=window.s_c_il[a],b._c&&"s_c"===b._c)return b}();if("undefined"!==typeof f){f.contextData.manageVars="3.0";f.blankVars=function(a){this[a]&&(0>a.indexOf("contextData")?this[a]="":(a=a.substring(a.indexOf(".")+1),this.contextData[a]&&(this.contextData[a]="")))};f.lowerCaseVars=function(a){this[a]&&("events"!==a&&-1===a.indexOf("contextData")?(this[a]=this[a].toString(),0!==this[a].indexOf("D=")&&(this[a]=this[a].toLowerCase())):-1<a.indexOf("contextData")&&(a=a.substring(a.indexOf(".")+1),this.contextData[a]&&(this.contextData[a]=this.contextData[a].toString().toLowerCase())))};f.cleanStr=function(a){function b(a){if("string"===typeof a){for(a=a.replace(/<\/?[^>]+(>|$)/g,"").trim().replace(/[\u2018\u2019\u201A]/g,"'").replace(/\t+/g,"").replace(/[\n\r]/g," ");-1<a.indexOf("  ");)a=a.replace(/\s\s/g," ");return a}return""}this[a]&&"function"===typeof b&&(0>a.indexOf("contextData")?this[a]=b(this[a]):(a=a.substring(a.indexOf(".")+1),this.contextData[a]&&(this.contextData[a]=b(this.contextData[a].toString()))))};f.pt=function(a,b,c,d){if(a&&this[c]){a=a.split(b||",");b=a.length;for(var e,f=0;f<b;f++)if(e=this[c](a[f],d))return e}};if(!f[g])return!1;c=c||"";d=d||!0;var b,e="pageName,purchaseID,channel,server,pageType,campaign,state,zip,events,products,transactionID";for(b=1;76>b;b++)e+=",prop"+b;for(b=1;251>b;b++)e+=",eVar"+b;for(b=1;6>b;b++)e+=",hier"+b;for(b=1;4>b;b++)e+=",list"+b;for(b in f.contextData)e+=",contextData."+b;if(c){if(1==d)e=c.replace("['",".").replace("']","");else if(0==d){c=c.split(",");d=e.split(",");e="";for(x in c)for(y in-1<c[x].indexOf("contextData")&&(c[x]="contextData."+c[x].split("'")[1]),d)c[x]===d[y]&&(d[y]="");for(y in d)e+=d[y]?","+d[y]:""}f.pt(e,",",g,0);return!0}return""===c&&d?(f.pt(e,",",g,0),!0):!1}};
/******************************************** END CODE TO DEPLOY ********************************************/

Utilizzare il plug-in

Il manageVars La funzione utilizza i seguenti argomenti:

  • cb (obbligatorio, stringa): nome di una funzione di callback utilizzata dal plug-in per manipolare le variabili di Analytics. Puoi utilizzare una funzione di Adobe come cleanStr o una funzione personalizzata.

  • l (facoltativo, stringa): elenco delimitato da virgole di variabili di Analytics che desideri manipolare. Se non viene impostato, viene impostato automaticamente su TUTTE le variabili di Adobe Analytics, tra cui:

    • pageName
    • purchaseID
    • channel
    • server
    • pageType
    • campaign
    • state
    • zip
    • events
    • products
    • transactionID
    • Tutte le proprietà
    • Tutte le eVar
    • Tutte le variabili della gerarchia
    • Tutte le variabili elenco
    • Tutte le variabili di dati di contesto
  • Il (facoltativo, booleano): impostato su false se si desidera escludi l’elenco delle variabili dichiarate nel l invece di includerli. Predefinito su true.

La chiamata di questa funzione non restituisce alcun risultato. Cambia invece i valori delle variabili di Analytics in base alla funzione di callback desiderata.

Esempio di chiamate

Esempio di #1

Il seguente codice…

manageVars("lowerCaseVars");

…modifica in minuscolo i valori di tutte le variabili descritte in precedenza. L’unica eccezione è la variabile degli eventi, in quanto alcuni degli eventi (ad esempio scAdd, scCheckout e così via) fanno distinzione tra maiuscole e minuscole e non devono essere minuscole

Esempio di #2

Il seguente codice…

manageVars("lowerCaseVars", "events", false);

…essenzialmente produce lo stesso risultato del primo esempio, poiché la variabile degli eventi non è in minuscolo per impostazione predefinita.

Esempio di #3

Il seguente codice…

manageVars("lowerCaseVars", "eVar1,eVar2,eVar3,list2");

…cambierà (ad esempio, in minuscolo) solo i valori di eVar1, eVar2, eVar3 ed list2

Esempio di #4

Il seguente codice…

manageVars("lowerCaseVars", "eVar1,eVar2,eVar3,list2", false);

…cambierà (ad esempio in minuscolo) i valori di tutte le variabili sopra descritte ECCETTO per eVar1, eVar2, eVar3 ed list2

Esempio di #5

Il seguente codice…

manageVars("cleanStr");

…modifica i valori di tutte le variabili descritte in precedenza, comprese le variabili di eventi. In particolare, la funzione di callback cleanStr esegue le seguenti operazioni sul valore di ciascuna variabile:

  • Rimuove la codifica HTML
  • Rimuove gli spazi vuoti trovati all’inizio e alla fine del valore
  • Sostituisce le virgolette singole a sinistra/destra con una virgoletta singola diritta (')
  • Sostituisce i caratteri di tabulazione, i caratteri di nuova riga e i caratteri di ritorno a capo con spazi
  • Sostituisce tutti i doppi (o tripli, ecc.) spazi con spazi singoli

Cronologia versioni

3.0 (19 marzo 2021)

  • È stato aggiunto il numero di versione come dati contestuali.

2.1 (14 gennaio 2019)

  • Correzione di bug per i browser Internet Explorer 11.
  • Modifiche per s.cleanStr, che ora utilizza il normale cleanStr funzione.

2.0 (7 maggio 2018)

  • Rilascio del punto (inclusa la rianalisi/riscrittura completa del plug-in)
  • Aggiunto cleanStr funzione di callback
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690