Show Menu
ARGOMENTI×

Plug-in Adobe: getVisitNum

Questo plug-in è fornito da Adobe Consulting come cortesia per aiutarti a ottenere più valore da Adobe Analytics. L'Assistenza clienti Adobe non fornisce supporto per questo plug-in, inclusa l'installazione o la risoluzione dei problemi. Se avete bisogno di aiuto con questo plug-in, contattate l'Account Manager della vostra azienda. Possono organizzare una riunione con un consulente per assistenza.
Il getVisitNum plug-in restituisce il numero di visita per tutti i visitatori che arrivano sul sito entro il numero desiderato di giorni. Analysis Workspace offre una dimensione "Numero visita" con funzionalità simili. Adobe consiglia di utilizzare questo plug-in se desiderate maggiore controllo sulla modalità di incremento del numero di visita. Questo plug-in non è necessario se la dimensione "Visit Number" incorporata in Analysis Workspace è sufficiente per le esigenze di reporting.

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

Adobe offre un’estensione che consente di utilizzare la maggior parte dei plug-in usati comunemente.
  1. Accedete a launch.adobe.com utilizzando le credenziali AdobeID.
  2. Fate clic sulla proprietà desiderata.
  3. Vai alla Extensions scheda, quindi fai clic sul Catalog pulsante
  4. Installare e pubblicare l’ Common Analytics Plugins estensione
  5. Se non lo avete già fatto, create una regola con l'etichetta "Inizializza plug-in" con la seguente configurazione:
    • Condizione: None
    • Evento: Core - Libreria caricata (Page Top)
  6. Aggiungete un'azione alla regola precedente con la seguente configurazione:
    • Estensione: Plug-in comuni di Analytics
    • Tipo azione: Initialize getVisitNum
  7. Salvate e pubblicate le modifiche alla regola.

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

Se non desiderate utilizzare l'estensione del plug-in, potete utilizzare l'editor di codice personalizzato.
  1. Accedete a launch.adobe.com utilizzando le credenziali AdobeID.
  2. Fate clic sulla proprietà desiderata.
  3. Vai alla Extensions scheda, quindi fai clic sul Configure pulsante sotto l'estensione Adobe Analytics.
  4. Espandere la struttura Configure tracking using custom code a soffietto, che mostra il Open Editor pulsante.
  5. Aprite l’editor di codice personalizzato e incollate il codice plug-in fornito di seguito nella finestra di modifica.
  6. Salvate e pubblicate le modifiche all'estensione Analytics.

Installare il plug-in utilizzando AppMeasurement

Copiate e incollate il seguente codice in qualsiasi punto del file AppMeasurement dopo che è stata creata l'istanza dell'oggetto di tracciamento di Analytics (tramite s_gi ). La conservazione di commenti e numeri di versione del codice nell’implementazione consente ad Adobe di risolvere eventuali problemi.
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getVisitNum v4.11 (Requires endOfDatePeriod plug-in) */
s.getVisitNum=function(rp,erp){var s=this,c=function(rp){return isNaN(rp)?!1:(parseFloat(rp)|0)===parseFloat(rp)};rp=rp?rp:365;erp= "undefined"!==typeof erp?!!erp:c(rp)?!0:!1;var e=(new Date).getTime(),b=endOfDatePeriod(rp);if(s.c_r("s_vnc"+rp))var g=s.c_r("s_vnc"+rp).split("&vn="),d=g[1];if(s.c_r("s_ivc"))return d?(b.setTime(e+18E5),s.c_w("s_ivc",!0,b),d):"unknown visit number";if("undefined"!==typeof d)return d++,c=erp&&c(rp)?e+864E5*rp:g[0],b.setTime(c),s.c_w("s_vnc"+rp,c+"&vn="+d,b),b.setTime(e+ 18E5),s.c_w("s_ivc",!0,b),d;c=c(rp)?e+864E5*rp:endOfDatePeriod(rp).getTime();s.c_w("s_vnc"+rp,c+"&vn=1",b);b.setTime(e+18E5); s.c_w("s_ivc",!0,b);return"1"};

/* Adobe Consulting Plugin: endOfDatePeriod v1.1 */
var endOfDatePeriod=function(dp){var a=new Date,b=isNaN(dp)?0:Math.floor(dp);a.setHours(23);a.setMinutes(59);a.setSeconds(59); "w"===dp&&(b=6-a.getDay());if("m"===dp){b=a.getMonth()+1;var d=a.getFullYear();b=(new Date(d?d:1970,b?b:1,0)).getDate()-a.getDate()}a.setDate(a.getDate()+b);"y"===dp&&(a.setMonth(11),a.setDate(31));return a};
/******************************************** END CODE TO DEPLOY ********************************************/

Utilizzare il plug-in

Il getVisitNum metodo utilizza i seguenti argomenti:
  • rp (facoltativo, numero intero OR stringa): Il numero di giorni prima del ripristino del contatore del numero di visita. Il valore predefinito è 365 se non è impostato.
    • Quando questo argomento è "w" , il contatore si azzera alla fine della settimana (questo sabato alle 11:59)
    • Quando questo argomento è "m" impostato, il contatore viene ripristinato alla fine del mese (l'ultimo giorno del mese)
    • Quando questo argomento è "y" , il contatore reimposta 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 dei numeri di visita viene ripristinato. Il valore predefinito è true . Questo argomento non è valido quando l' rp argomento è una stringa.
Il numero della visita aumenta ogni volta che il visitatore ritorna al sito dopo 30 minuti di inattività. Richiamando questo metodo viene restituito un numero intero che rappresenta il numero di visita corrente del visitatore.
Questo plug-in imposta un cookie first-party denominato "s_vnc[LENGTH]" where [LENGTH] è il valore passato nell' rp argomento. Ad esempio "s_vncw" , "s_vncm" o "s_vnc365" . Il valore del cookie è una combinazione di una marca temporale Unix che rappresenta il momento in cui il contatore delle visite viene reimpostato, come fine settimana, fine mese o dopo 365 giorni di inattività. Contiene anche il numero della visita corrente. Questo plug-in imposta un altro cookie denominato "s_ivc" che viene 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 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 uguale a 2:
s.prop1=s.getVisitNum(365);

Se il visitatore torna sul sito entro 364 giorni dalla sua seconda visita, il codice seguente imposta s.prop1 uguale a 3:
s.prop1=s.getVisitNum(365);

Esempio n. 3

Per un visitatore che ritorna sul sito entro 179 giorni dalla sua prima visita, il codice seguente imposta s.prop1 uguale a 2:
s.prop1=s.getVisitNum(180,false);

Tuttavia, se il visitatore torna sul sito 1 o più giorni dopo la sua seconda visita, il codice seguente imposta s.prop1 uguale a 1:
s.prop1=s.getVisitNum(180,false);

Quando il secondo argomento della chiamata è uguale a falso, la routine che determina quando il numero della visita deve essere "reimpostato" su 1 farà così "x" numero di giorni - in questo esempio, 365 giorni - dopo la prima visita del visitatore al sito.
Quando il secondo argomento è uguale a true (o non è impostato affatto), il plug-in reimposta il numero della 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 arrivano sul sito per la prima volta durante la settimana corrente - a partire da domenica - il seguente codice imposta s.prop1 uguale a 1:
s.prop1=s.getVisitNum("w");

Esempio n. 5

Per tutti i visitatori che arrivano sul sito per la prima volta durante il mese corrente - a partire dal primo giorno di ogni mese - il codice seguente imposta s.prop1 uguale a 1:
s.prop1=s.getVisitNum("m");

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

Esempio n. 6

Per tutti i visitatori che arrivano sul sito per la prima volta durante l'anno corrente - a partire dal 1 gennaio - il codice seguente imposta s.prop1 uguale a 1:
s.prop1=s.getVisitNum("y");

Esempio n. 7

Se desideri tracciare il numero di visita di un visitatore per la settimana, il numero di visita di un visitatore per il mese e il numero di visita di un visitatore per l'anno, il tutto all'interno di variabili Analytics diverse, devi usare un codice che assomigli a quanto segue:
s.prop1=s.getVisitNum("w");
s.prop2=s.getVisitNum("m");
s.prop3=s.getVisitNum("y");

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

Cronologia versioni

4.11 (30 settembre 2019)

  • È stato risolto un problema per il quale l' erp argomento era impostato esplicitamente su false .

4.1 (21 maggio 2018)

  • È stato aggiornato il endOfDatePeriod plug-in alla versione 1.1.

4.0 (17 aprile 2018)

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

3.0 (5 giugno 2016)

  • Revisione completa
  • Combinate tutte le soluzioni precedenti disponibili in varie versioni del getVisitNum plug-in.