Plug-in di Adobe: getVisitNum

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.

Il plug-in getVisitNum restituisce il numero di visite per tutti i visitatori che accedono al sito entro il numero di giorni desiderato. Analysis Workspace offre una dimensione "Numero visita" che fornisce funzionalità simili. L’Adobe consiglia di utilizzare questo plug-in se desideri un maggiore controllo sulla modalità di incremento del numero di visite. Questo plug-in non è necessario se la dimensione "Numero visita" integrata in Analysis Workspace è sufficiente per le tue esigenze di reporting.

Installare il plug-in utilizzando l’estensione Adobe Experience Platform Launch

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

  1. Accedi a launch.adobe.com utilizzando le tue credenziali AdobeID.
  2. Fai clic sulla proprietà 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 "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 getVisitNum
  7. Salva e pubblica le modifiche alla regola.

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

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

  1. Accedi a launch.adobe.com utilizzando le tue credenziali AdobeID.
  2. Fai clic sulla proprietà desiderata.
  3. Vai alla scheda Extensions , quindi fai clic sul pulsante Configure sotto l'estensione Adobe Analytics.
  4. Espandi il Configure tracking using custom code pannello a soffietto, che mostra il pulsante Open Editor .
  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: getVisitNum v4.2 */
function getVisitNum(rp,erp){var a=rp,l=erp;function m(c){return isNaN(c)?!1:(parseFloat(c)|0)===parseFloat(c)}function n(c){var b=new Date,e=isNaN(c)?0:Math.floor(c);b.setHours(23);b.setMinutes(59);b.setSeconds(59);"w"===c&&(e=6-b.getDay());if("m"===c){e=b.getMonth()+1;var a=b.getFullYear();e=(new Date(a?a:1970,e?e:1,0)).getDate()-b.getDate()}b.setDate(b.getDate()+e);"y"===c&&(b.setMonth(11),b.setDate(31));return b}if("-v"===a)return{plugin:"getVisitNum",version:"4.2"};var f=function(){if("undefined"!==typeof window.s_c_il)for(var c=0,b;c<window.s_c_il.length;c++)if(b=window.s_c_il[c],b._c&&"s_c"===b._c)return b}();"undefined"!==typeof f&&(f.contextData.getVisitNum="4.2");window.cookieWrite=window.cookieWrite||function(c,b,e){if("string"===typeof c){var a=window.location.hostname,d=window.location.hostname.split(".").length-1;if(a&&!/^[0-9.]+$/.test(a)){d=2<d?d:2;var h=a.lastIndexOf(".");if(0<=h){for(;0<=h&&1<d;)h=a.lastIndexOf(".",h-1),d--;h=0<h?a.substring(h):a}}g=h;b="undefined"!==typeof b?""+b:"";if(e||""===b)if(""===b&&(e=-60),"number"===typeof e){var f=new Date;f.setTime(f.getTime()+6E4*e)}else f=e;return c&&(document.cookie=encodeURIComponent(c)+"="+encodeURIComponent(b)+"; path=/;"+(e?" expires="+f.toUTCString()+";":"")+(g?" domain="+g+";":""),"undefined"!==typeof window.cookieRead)?window.cookieRead(c)===b:!1}};window.cookieRead=window.cookieRead||function(c){if("string"===typeof c)c=encodeURIComponent(c);else return"";var b=" "+document.cookie,a=b.indexOf(" "+c+"="),d=0>a?a:b.indexOf(";",a);return(c=0>a?"":decodeURIComponent(b.substring(a+2+c.length,0>d?b.length:d)))?c:""};a=a?a:365;l="undefined"!==typeof l?!!l:m(a)?!0:!1;var p=(new Date).getTime();f=n(a);if(window.cookieRead("s_vnc"+a))var d=window.cookieRead("s_vnc"+a).split("&vn="),k=d[1];if(window.cookieRead("s_ivc"))return k?(window.cookieWrite("s_ivc",!0,30),k):"unknown visit number";if("undefined"!==typeof k)return k++,d=l&&m(a)?p+864E5*a:d[0],f.setTime(d),window.cookieWrite("s_vnc"+a,d+"&vn="+k,f),window.cookieWrite("s_ivc",!0,30),k;d=m(a)?p+864E5*a:n(a).getTime();window.cookieWrite("s_vnc"+a,d+"&vn=1",f);window.cookieWrite("s_ivc",!0,30);return"1"};
/******************************************** END CODE TO DEPLOY ********************************************/

Usa il plug-in

Il metodo getVisitNum utilizza i seguenti argomenti:

  • rp (facoltativo, stringa OR intera): Il numero di giorni prima della reimpostazione del contatore del numero di visita. Se non è impostato, viene impostato il valore predefinito 365.
    • Quando questo argomento è "w", il contatore viene reimpostato alla fine della settimana (questo sabato alle 11:59)
    • Quando questo argomento è "m", il contatore viene reimpostato alla fine del mese (l’ultimo giorno del mese)
    • Quando questo argomento è "y", il contatore viene reimpostato alla fine dell’anno (31 dicembre)
  • erp (facoltativo, booleano): Quando l' rp argomento è un numero, questo argomento determina se la scadenza del numero di visita deve essere estesa. Se è impostato su true, gli hit successivi al sito reimpostano il contatore dei numeri di visita. Se è impostato su false, gli hit successivi al sito non si estendono quando il contatore del numero di visite viene reimpostato. Predefinito su true. Questo argomento non è valido quando l'argomento rp è una stringa.

Il numero di visite aumenta ogni volta che il visitatore ritorna al tuo sito dopo 30 minuti di inattività. Una chiamata a questo metodo restituisce un numero intero che rappresenta il numero di visita corrente del visitatore.

Questo plug-in imposta un cookie di prime parti denominato "s_vnc[LENGTH]" dove [LENGTH] è il valore passato nell’argomento rp . Ad esempio, "s_vncw", "s_vncm" o "s_vnc365". Il valore del cookie è una combinazione di un timestamp Unix che rappresenta quando il contatore di visite viene reimpostato, come la fine della settimana, la fine del mese o dopo 365 giorni di inattività. Contiene anche il numero della visita corrente. Questo plug-in imposta un altro cookie denominato "s_ivc" impostato su true e scade dopo 30 minuti di inattività.

Chiamate di esempio

Esempio n. 1

Per un visitatore che non è stato sul sito negli ultimi 365 giorni, il codice seguente imposta s.prop1 uguale al valore di 1:

s.prop1=s.getVisitNum();

Esempio n. 2

Per un visitatore che ritorna al sito entro 364 giorni dalla sua prima visita, il codice seguente imposta s.prop1 su 2:

s.prop1=s.getVisitNum(365);

Se il visitatore ritorna al sito entro 364 giorni dalla sua seconda visita, il codice seguente imposta s.prop1 su 3:

s.prop1=s.getVisitNum(365);

Esempio n. 2

Per un visitatore che ritorna al sito entro 179 giorni dalla sua prima visita, il codice seguente imposta s.prop1 su 2:

s.prop1=s.getVisitNum(180,false);

Tuttavia, se il visitatore ritorna al sito 1 o più giorni dopo la sua seconda visita, il codice seguente imposta s.prop1 su 1:

s.prop1=s.getVisitNum(180,false);

Quando il secondo argomento della chiamata è uguale a falso, la routine che determina quando il numero di visita deve essere "reimpostato" a 1 farà questo numero "x" di giorni - in questo esempio, 365 giorni - dopo la prima visita del visitatore al sito.

Quando il secondo argomento è uguale a vero (o non è impostato affatto), il plug-in reimposta il numero di visita a 1 solo dopo "x" numero di giorni - di nuovo, in questo esempio, 365 giorni - di inattività del visitatore.

Esempio n. 4

Per tutti i visitatori che accedono al sito per la prima volta durante la settimana corrente - a partire da domenica - il seguente codice imposta s.prop1 su 1:

s.prop1=s.getVisitNum("w");

Esempio n. 5

Per tutti i visitatori che accedono al sito per la prima volta nel mese in corso, a partire dal primo giorno di ogni mese, il codice seguente imposta s.prop1 su 1:

s.prop1=s.getVisitNum("m");

Tieni presente che il plug-in getVisitNum non considera i calendari basati sulla vendita al dettaglio (ad esempio 4-5-4, 4-4-5, ecc.)

Esempio n. 6

Per tutti i visitatori che accedono al sito per la prima volta durante l'anno in corso - a partire dal 1° gennaio - il seguente codice imposta s.prop1 su 1:

s.prop1=s.getVisitNum("y");

Esempio n. 7

Se desideri tenere traccia del numero di visita di un visitatore per la settimana, del numero di visita di un visitatore per il mese e del numero di visita di un visitatore per l’anno, il tutto all’interno di variabili Analytics diverse, utilizza un codice simile al seguente:

s.prop1=s.getVisitNum("w");
s.prop2=s.getVisitNum("m");
s.prop3=s.getVisitNum("y");

In questo caso, il plug-in creerà tre cookie diversi, uno per ciascuno dei diversi periodi di tempo, per tenere traccia del numero di visita individuale per ogni periodo di tempo.

Cronologia versioni

4.2 (19 marzo 2021)

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

4.11 (30 settembre 2019)

  • È stato risolto un problema a causa del quale l’argomento erp era impostato esplicitamente su false.

4.1 (21 maggio 2018)

  • Il plug-in endOfDatePeriod è stato aggiornato alla versione 1.1.

4.0 (17 aprile 2018)

  • Rilascio del punto (ricompilato, dimensioni del codice più piccole).
  • Sono stati rimossi gli argomenti dei cookie poiché il plug-in ora genera in modo dinamico i cookie in base all’argomento rp

3.0 (5 giugno 2016)

  • Revisione completa
  • Tutte le soluzioni precedenti disponibili in diverse versioni del plug-in getVisitNum sono state combinate.

In questa pagina