Plug-in Adobe: formatTime

Il formatTime plug-in consente di prendere un numero qualsiasi di secondi e presentarli in un formato fisso, arrotondati al valore di riferimento desiderato. Adobe consiglia di utilizzare questo plug-in per acquisire un valore temporale in secondi e convertirlo in un formato fisso (ad esempio, minuti, giorni o settimane). Questo plug-in non è necessario se non si desidera inserire valori basati sul secondo intervallo in un formato con arrotondamento temporale.

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 formatTime
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: 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 formatTime metodo utilizza i seguenti argomenti:

• ns (obbligatorio, numero intero): Il numero di secondi per la conversione o il formato
• tf (facoltativo, stringa): il tipo di formato per restituire i secondi in; impostazione predefinita: secondi
  • Imposta su "d" se si desidera l’ora in giorni (arrotondato al valore di riferimento di 1/4 più vicino per impostazione predefinita)
  • Imposta su "h" se desideri il tempo in ore (arrotondato al valore di riferimento di 1/4 ore più vicino per impostazione predefinita)
  • Imposta su "m" se desideri il tempo in minuti (arrotondato al valore di riferimento di 1/2 minuti più vicino per impostazione predefinita)
  • Imposta su "s" se si desidera ottenere il tempo in secondi (arrotondato per impostazione predefinita a 5 secondi più vicino)
• bml (facoltativo, numero): Lunghezza dei benchmark di arrotondamento. Impostazione predefinita dei parametri di riferimento elencati nell’ tf argomento

Il metodo restituisce il numero di secondi formattati utilizzando l'unità specificata nell' tf argomento. Se l' tf argomento non è impostato:

• Qualsiasi valore inferiore a un minuto viene arrotondato al valore di riferimento di 5 secondi più vicino
• Qualsiasi valore compreso tra un minuto e un'ora viene arrotondato al valore di riferimento più vicino di 1/2 minuti
• Qualsiasi valore compreso tra un'ora e un giorno viene arrotondato al valore di riferimento del trimestre più vicino
• Qualsiasi valore maggiore di un giorno viene arrotondato al valore di riferimento del giorno più vicino

Esempi

Esempio n. 1

Codice seguente…

s.eVar1 = s.formatTime(38242);

…imposta s.eVar1 su "10.5 hours"

L'argomento passato - 38242 secondi - è uguale a 10 ore, 37 minuti e 22 secondi. Poiché l'argomento tf non è impostato in questa chiamata e il numero di secondi trascorsi è compreso tra un'ora e un giorno, il plug-in restituirà il numero di secondi convertiti nel parametro di riferimento di trimestre più vicino.

Esempio n. 2

Codice seguente…

s.eVar1 = s.formatTime(38250);

…imposta s.eVar1 su "10.75 hours" L'argomento passato - 38250 secondi - è uguale a 10 ore, 37 minuti e 30 secondi. L'arrotondamento del numero di secondi passati al valore di riferimento di trimestre più vicino in questo caso imposterà il valore finale su 10,75 ore

Esempio n. 3

Codice seguente…

s.eVar1 = s.formatTime(38242, "m");

…imposta s.eVar1 su "637.5 minuti"

In questo caso, l'argomento "m" forza il plug-in a convertire i secondi al valore di riferimento di ½ minuto più vicino

Esempio n. 4

Codice seguente…

s.eVar1 = s.formatTime(38242, "m", 20);

…imposta s.eVar1 su "640 minuti"

Il valore dell'argomento tf ("m") forza il plug-in a convertire i secondi in minuti, ma anche il valore dell'argomento bml (20) forza il plug-in a arrotondare la conversione dei minuti al valore di riferimento di 20 minuti più vicino.

Esempio n. 5

Codice seguente…

s.eVar1 = s.formatTime(125, "s", 2);

…imposta s.eVar1 su "126 secondi", che è il valore di riferimento più vicino di 2 secondi a 125 secondi

Esempio n. 6

Codice seguente…

s.eVar1 = s.formatTime(125, "m", 3);

…imposta s.eVar1 su "3 Minutes", che è il valore di riferimento di 3 minuti più vicino a 125 secondi

Esempio n. 7

Codice seguente…

s.eVar1 = s.formatTime(145, "m", .4);

…imposta s.eVar1 su "2,4 minuti", corrispondente al valore di riferimento di 2/5 minuti più vicino (ad es. Da 0,4 = 2/5) a 145 secondi

Cronologia versioni

1.1 (21 maggio 2018)

• È stato aggiunto l’ bml argomento per consentire maggiore flessibilità nell’arrotondamento

1.0 (15 aprile 2018)

• Versione iniziale.