Plug-in Adobe: getTimeSinceLastVisit

Il getTimeSinceLastVisit plug-in consente di tenere traccia del tempo impiegato dal visitatore per tornare al sito dopo l’ultima visita.

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

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: nessuna
   • Evento: Core - Libreria caricata (Page Top)
6. Aggiungete un'azione alla regola precedente con la seguente configurazione:
   • Estensione: Plug-in Analytics comuni
   • Tipo azione: Initialize getTimeSinceLastVisit
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 nell’estensione Analytics .

Installare il plug-in utilizzando AppMeasurement

Copiate e incollate il seguente codice in qualsiasi punto del file AppMeasurement dopo che è stata creata un'istanza dell'oggetto di tracciamento Analytics (utilizzando 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: getTimeSinceLastVisit v1.0 (Requires formatTime and inList plug-ins) */
s.getTimeSinceLastVisit=function(){var s=this,a=new Date,b=a.getTime(),c=s.c_r("s_tslv")||0,d=Math.round((b-c)/1E3);a.setTime(b+63072E6);s.c_w("s_tslv",b,a);return c?1800<d&&s.formatTime?s.formatTime(d):"":"New Visitor"};

/* Adobe Consulting Plugin: formatTime v1.1 (Requires inList plug-in) */
s.formatTime=function(ns,tf,bml){var s=this;if(!("undefined"===typeof ns||isNaN(ns)||0>Number(ns))){if("string"===typeof tf&&"d"===tf||("string"!==typeof tf||!s.inList("h,m,s",tf))&&86400<=ns){tf=86400;var d="days";bml=isNaN(bml)?1:tf/(bml*tf)} else"string"===typeof tf&&"h"===tf||("string"!==typeof tf||!s.inList("m,s",tf))&&3600<=ns?(tf=3600,d="hours", bml=isNaN(bml)?4: tf/(bml*tf)):"string"===typeof tf&&"m"===tf||("string"!==typeof tf||!s.inList("s",tf))&&60<=ns?(tf=60,d="minutes",bml=isNaN(bml)?2: tf/(bml*tf)):(tf=1,d="seconds",bml=isNaN(bml)?.2:tf/bml);ns=Math.round(ns*bml/tf)/bml+" "+d;0===ns.indexOf("1 ")&&(ns=ns.substring(0, ns.length-1));return ns}};

/* Adobe Consulting Plugin: inList v2.1 */
s.inList=function(lv,vtc,d,cc){if("string"!==typeof vtc)return!1;if("string"===typeof lv)lv=lv.split(d||",");else if("object"!== typeof lv)return!1;d=0;for(var e=lv.length;d<e;d++)if(1==cc&&vtc===lv[d]||vtc.toLowerCase()===lv[d].toLowerCase())return!0;return!1};
 /******************************************** END CODE TO DEPLOY ********************************************/

Utilizzare il plug-in

Il getTimeSinceLastVisit metodo non utilizza argomenti. Restituisce il tempo trascorso dall’ultima volta che il visitatore è arrivato sul sito, creato nel seguente formato:

• Tempo compreso tra 30 minuti e un’ora dall’ultima visita è impostato sul valore di riferimento di mezzo minuto più vicino. Ad esempio, "30.5 minutes", "53 minutes"
• Il tempo compreso tra un’ora e un giorno viene arrotondato al valore di riferimento del trimestre più vicino. Ad esempio, "2.25 hours", "7.5 hours"
• Il tempo maggiore di un giorno è arrotondato al valore di riferimento del giorno più vicino. Ad esempio, "1 day", "3 days", "9 days", "372 days"
• Se un visitatore non ha visitato prima o il tempo trascorso è maggiore di due anni, il valore è impostato su "New Visitor".

Questo plug-in crea un cookie first-party denominato "s_tslv" set a una marca temporale Unix dell’ora corrente. Il cookie scade dopo due anni di inattività.

Chiamate di esempio

Esempio n. 1

Se un nuovo visitatore accede al sito e il codice seguente viene eseguito sulla prima pagina della visita …

s.prop1 = s.getTimeSinceLastVisit();
s.linkTrackVars = s.apl(s.linkTrackVars, "prop1") //ensures that prop1 will be included on the first hit of the visit

…il valore di s.prop1 sarà impostato su "Nuovo visitatore".

Se lo stesso codice viene eseguito sullo stesso dominio dopo 35 minuti di inattività, il valore di s.prop1 verrà impostato su "35 minuti".

Se lo stesso codice viene eseguito sullo stesso dominio dopo 4 giorni di ulteriore inattività, il valore di s.prop1 sarà impostato su "4 giorni".

Cronologia versioni

1.0 (16 aprile 2018)

• Rilascio punto (codice ricompilato e dimensioni ridotte).
• Codice derivato dal getDaysSinceLastVisit plug-in (ora obsoleto e rinominato).
• Ora vengono utilizzati formatTime e inList plug-in per il valore restituito.