DocumentazioneAnalyticsGuida all'implementazione

Plug-in Adobe: getValOnce

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Amministratore
  • Sviluppatore
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 plug-in getValOnce impedisce che una variabile venga impostata come uguale allo stesso valore più di una volta. 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. Fare clic su Tags a sinistra, quindi fare clic sulla proprietà tag desiderata.

  3. Fai clic su Extensions a sinistra, quindi sulla scheda Catalog

  4. Individuare e installare l'estensione Common Web SDK Plugins.

  5. Fai clic su Data Elements a sinistra, quindi 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 alla scheda Extensions, quindi fai clic sul pulsante Catalog

  4. Installa e pubblica l'estensione Common Analytics Plugins

  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 alla scheda Extensions, quindi fai clic sul pulsante Configure sotto l'estensione Adobe Analytics.
  4. Espandere il pannello a soffietto Configure tracking using custom code, che mostra il pulsante Open Editor.
  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

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

La funzione getValOnce utilizza i seguenti argomenti:

  • vtc (obbligatorio, stringa): variabile da controllare e verificare se è stato impostato in precedenza su un valore identico
  • 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 dell'argomento ep. Impostazione predefinita: 0, che scade alla fine della sessione del browser
  • ep (facoltativo, stringa): impostare questo argomento solo se è impostato anche l'argomento et. Impostare questo argomento su "m" se si desidera che l'argomento et scada in minuti anziché in giorni. Il valore predefinito è "d", che imposta l'argomento et in giorni.

Se l'argomento vtc e il valore del cookie corrispondono, questa funzione restituisce una stringa vuota. Se l'argomento vtc e il valore del cookie non corrispondono, la funzione restituisce l'argomento 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 minuti o giorni per la scadenza tramite il parametro t.
  • È stato corretto l'ambito della variabile k 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