Plug-in di Adobe: getValOnce

IMPORTANTE

Questo plug-in è fornito da Adobe Consulting come cortesia per aiutarti a ottenere più valore da Adobe Analytics. L’Assistenza clienti di Adobe non fornisce supporto per questo plug-in, inclusa l’installazione o la risoluzione dei problemi. Se hai bisogno di aiuto con questo plug-in, contatta l’Account Manager della tua organizzazione. Possono organizzare una riunione con un consulente per l'assistenza.

La getValOnce il plug-in impedisce che una variabile venga impostata più di una volta sullo stesso valore. Adobe consiglia di utilizzare questo plug-in quando si desidera deduplicare le occorrenze in cui un visitatore aggiorna una pagina o in altro modo visita una pagina specifica più volte. Questo plug-in non è necessario se non sei preoccupato della metrica "Occorrenze" in Analysis Workspace.

Installare il plug-in utilizzando l’SDK per web o l’estensione Adobe Analytics

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

  1. Accedi a Raccolta dati Adobe Experience Platform utilizzo delle credenziali AdobeID.
  2. Fai clic sulla proprietà tag desiderata.
  3. Vai a Extensions , quindi fai clic sul Catalog pulsante
  4. Installa e pubblica il Common Analytics Plugins estensione
  5. Se non lo hai già fatto, crea una regola denominata "Inizializza plug-in" con la seguente configurazione:
    • Condizione: nessuna
    • Evento: Core - Libreria caricata (pagina in alto)
  6. Aggiungi un'azione alla regola precedente con la seguente configurazione:
    • Estensione: Plug-in comuni di Analytics
    • Tipo azione: Inizializza getValOnce
  7. Salva e pubblica le modifiche alla regola.

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

Se non desideri utilizzare l'estensione plug-in, puoi utilizzare l'editor di codice personalizzato.

  1. Accedi a Raccolta dati Adobe Experience Platform utilizzo delle credenziali AdobeID.
  2. Fai clic sulla proprietà desiderata.
  3. Vai a Extensions , quindi fai clic sul pulsante Configure sotto l'estensione Adobe Analytics.
  4. Espandi la Configure tracking using custom code fisarmonica, che rivela Open Editor pulsante .
  5. Apri l’editor di codice personalizzato e incolla il codice plug-in fornito di seguito nella finestra di modifica.
  6. Salva e pubblica le modifiche all’estensione Analytics.

Installare il plug-in utilizzando AppMeasurement

Copia e incolla il seguente codice in qualsiasi punto del file AppMeasurement dopo la creazione dell'istanza dell'oggetto di tracciamento Analytics (utilizzando s_gi). La conservazione dei commenti e dei numeri di versione del codice nell’implementazione consente ad Adobe di risolvere eventuali problemi.

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getValOnce v3.0 (Requires AppMeasurement) */
function getValOnce(vtc,cn,et,ep){var e=vtc,k=cn,l=et,m=ep;if(arguments&&"-v"===arguments[0])return{plugin:"getValOnce",version:"3.0"};var c=function(){if("undefined"!==typeof window.s_c_il)for(var b=0,a;b<window.s_c_il.length;b++)if(a=window.s_c_il[b],a._c&&"s_c"===a._c)return a}();"undefined"!==typeof c&&(c.contextData.getValOnce="3.0");window.cookieWrite=window.cookieWrite||function(b,a,d){if("string"===typeof b){var h=window.location.hostname,c=window.location.hostname.split(".").length-1;if(h&&!/^[0-9.]+$/.test(h)){c=2<c?
c:2;var f=h.lastIndexOf(".");if(0<=f){for(;0<=f&&1<c;)f=h.lastIndexOf(".",f-1),c--;f=0<f?h.substring(f):h}}g=f;a="undefined"!==typeof a?""+a:"";if(d||""===a)if(""===a&&(d=-60),"number"===typeof d){var e=new Date;e.setTime(e.getTime()+6E4*d)}else e=d;return b&&(document.cookie=encodeURIComponent(b)+"="+encodeURIComponent(a)+"; path=/;"+(d?" expires="+e.toUTCString()+";":"")+(g?" domain="+g+";":""),"undefined"!==typeof cookieRead)?cookieRead(b)===a:!1}};window.cookieRead=window.cookieRead||function(b){if("string"===
typeof b)b=encodeURIComponent(b);else return"";var a=" "+document.cookie,d=a.indexOf(" "+b+"="),c=0>d?d:a.indexOf(";",d);return(b=0>d?"":decodeURIComponent(a.substring(d+2+b.length,0>c?a.length:c)))?b:""};return e&&(k=k||"s_gvo",l=l||0,m="m"===m?6E4:864E5,e!==this.c_r(k))?(c=new Date,c.setTime(c.getTime()+l*m),cookieWrite(k,e,0===l?0:m),e):""};
/******************************************** END CODE TO DEPLOY ********************************************/

Usa il plug-in

La getValOnce La funzione utilizza i seguenti argomenti:

  • vtc (obbligatorio, stringa): Variabile da controllare e vedere se è stata impostata in precedenza su un valore identico
  • cn (facoltativo, stringa): Nome del cookie che contiene il valore da controllare. Predefinito su "s_gvo"
  • et (facoltativo, numero intero): La scadenza del cookie in giorni (o minuti, a seconda del ep (argomento). Predefinito su 0, che scade alla fine della sessione del browser
  • ep (facoltativo, stringa): Imposta questo argomento solo se et viene impostato anche l’argomento . Imposta questo argomento su "m" se vuoi et argomento che scade in minuti anziché in giorni. Predefinito su "d", che imposta et argomento in giorni.

Se la vtc corrispondenza tra argomento e valore cookie, questa funzione restituisce una stringa vuota. Se la vtc il valore dell'argomento e del cookie non corrisponde, la funzione restituisce il vtc come stringa.

Esempi

// Prevent the same value from being passed in to the campaign variable more than once in a row for next 30 days
s.campaign = getValOnce(s.campaign,"s_campaign",30);

// Prevent the same value from being passed in to eVar2 more than once in a row for the browser session
s.eVar2 = getValOnce(s.eVar2,"s_ev2");

// Prevent the same value from being passed in to eVar8 more than once in a row for 10 minutes
s.eVar8 = getValOnce(s.eVar8,"s_ev8",10,"m");

Cronologia versioni

3.0 (19 marzo 2021)

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

2,01

  • È stato risolto un problema relativo alla scrittura di cookie.

2.0

  • Rilascio del punto (ricompilato, dimensioni del codice più piccole).

1.1.

  • È stata aggiunta l’opzione per scegliere minuti o giorni per la scadenza tramite la t parametro .
  • Correzione dell'ambito di applicazione k utilizzata solo per limitarla al plug-in. Questa modifica impedisce possibili interferenze con altro codice sulla pagina.

In questa pagina