Plug-in di Adobe: manageVars
Il plug-in manageVars
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.
-
Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
-
Fai clic sulla proprietà del tag desiderata.
-
Vai alla scheda Extensions, quindi fai clic sul pulsante Catalog
-
Installa e pubblica l'estensione Common Analytics Plugins
-
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)
-
Aggiungi un’azione alla regola precedente con la seguente configurazione:
- Estensione: Common Analytics Plugins
- Tipo azione: inizializza manageVars
-
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.
- Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.
- Fai clic sulla proprietà desiderata.
- Vai alla scheda Extensions, quindi fai clic sul pulsante Configure sotto l'estensione Adobe Analytics.
- Espandere il pannello a soffietto Configure tracking using custom code, che mostra il pulsante Open Editor.
- Apri l’editor di codice personalizzato e incolla il codice del plug-in fornito di seguito nella finestra di modifica.
- Salva e pubblica le modifiche nell’estensione Analytics.
Installare il plug-in utilizzando AppMeasurement
Copiare e incollare il codice seguente 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
La funzione manageVars
utilizza i seguenti argomenti:
-
cb
(obbligatorio, stringa): nome di una funzione di callback utilizzata dal plug-in per manipolare le variabili di Analytics. È possibile utilizzare una funzione di Adobe comecleanStr
o una funzione personalizzata. -
l
(facoltativo, stringa): elenco delimitato da virgole di variabili di Analytics che si desidera modificare. 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): impostare sufalse
se si desidera escludere l'elenco di variabili dichiarate nell'argomentol
anziché includerle. Predefinito sutrue
.
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 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 la funzione regolarecleanStr
.
2.0 (7 maggio 2018)
- Rilascio del punto (inclusa la rianalisi/riscrittura completa del plug-in)
- Aggiunta funzione di callback
cleanStr