DocumentazioneAnalyticsGuida all'implementazione

Plug-in Adobe: getValOnce

Last update: Fri Jan 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Admin
  • Developer
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 getValOnce Il plug-in impedisce che una variabile venga impostata più volte sullo stesso valore. L’Adobe consiglia di utilizzare questo plug-in quando desideri deduplicare le occorrenze in cui un visitatore aggiorna una pagina o visita in altro modo una determinata pagina più volte. Questo plug-in non è necessario se non sei preoccupato per la metrica "Occorrenze" in Analysis Workspace.

Installare il plug-in utilizzando l’estensione Web SDK

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

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

  2. Clic Tags a sinistra, fai clic sulla proprietà tag desiderata.

  3. Clic Extensions a sinistra, quindi fai clic su Catalog scheda

  4. Individuare e installare Common Web SDK Plugins estensione.

  5. Clic Data Elements a sinistra, quindi fai clic sull’elemento dati desiderato.

  6. Imposta il nome dell’elemento dati desiderato con la seguente configurazione:

    • Estensione: Common Web SDK Plugins
    • Elemento dati: getValOnce

  7. Imposta i parametri desiderati a destra.

  8. Salva e pubblica le modifiche apportate all’elemento dati.

Installare manualmente il plug-in implementando Web SDK

Questo plug-in non è ancora supportato per l’utilizzo in un’implementazione manuale dell’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: inizializzare getValOnce

  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: getValOnce v3.1 */
function getValOnce(vtc,cn,et,ep){var e=vtc,i=cn,t=et,n=ep;  if(arguments&&"-v"===arguments[0])return{plugin:"getValOnce",version:"3.1"};var o=function(){if(void 0!==window.s_c_il){for(var e,i=0;i<window.s_c_il.length;i++)if((e=window.s_c_il[i])._c&&"s_c"===e._c)return e}}();if(void 0!==o&&(o.contextData.getValOnce="3.1"),window.cookieWrite=window.cookieWrite||function(e,i,t){if("string"==typeof e){var n=window.location.hostname,o=window.location.hostname.split(".").length-1;if(n&&!/^[0-9.]+$/.test(n)){o=2<o?o:2;var r=n.lastIndexOf(".");if(0<=r){for(;0<=r&&1<o;)r=n.lastIndexOf(".",r-1),o--;r=0<r?n.substring(r):n}}if(g=r,i=void 0!==i?""+i:"",t||""===i){if(""===i&&(t=-60),"number"==typeof t){var f=new Date;f.setTime(f.getTime()+6e4*t)}else f=t}return!!e&&(document.cookie=encodeURIComponent(e)+"="+encodeURIComponent(i)+"; path=/;"+(t?" expires="+f.toUTCString()+";":"")+(g?" domain="+g+";":""),"undefined"!=typeof cookieRead)&&cookieRead(e)===i}},window.cookieRead=window.cookieRead||function(e){if("string"!=typeof e)return"";e=encodeURIComponent(e);var i=" "+document.cookie,t=i.indexOf(" "+e+"="),n=0>t?t:i.indexOf(";",t);return(e=0>t?"":decodeURIComponent(i.substring(t+2+e.length,0>n?i.length:n)))?e:""},e){var i=i||"s_gvo",t=t||0,n="m"===n?6e4:864e5;if(e!==cookieRead(i)){var r=new Date;return r.setTime(r.getTime()+t*n),cookieWrite(i,e,0===t?0:r),e}}return""}
/******************************************** END CODE TO DEPLOY ********************************************/

Utilizzare il plug-in

Il getValOnce La funzione utilizza i seguenti argomenti:

  • vtc (obbligatorio, stringa): variabile da verificare e vedere se è stata impostata su un valore identico in precedenza
  • cn (facoltativo, stringa): nome del cookie che contiene il valore da verificare. Impostazione predefinita "s_gvo"
  • et (facoltativo, numero intero): scadenza del cookie in giorni (o minuti, a seconda del ep ). Impostazione predefinita 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 si desidera et l'argomento scade in minuti anziché in giorni. Impostazione predefinita "d", che imposta et in giorni.

Se il vtc corrisponde al valore di argomento e cookie, questa funzione restituisce una stringa vuota. Se il vtc e cookie non corrispondono, 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.1 (22 settembre 2022)

  • È stato corretto un bug di scadenza

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

  • Versione a punti (ricompilata, con codice di dimensioni inferiori).

1,1

  • È stata aggiunta l’opzione per scegliere i minuti o i giorni per la scadenza tramite il t parametro.
  • È stato corretto l'ambito del k variabile utilizzata per limitarla al solo plug-in. Questa modifica evita possibili interferenze con altri codici sulla pagina.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690