Plug-in di Adobe: formatTime

La formatTime Il plug-in consente di prendere qualsiasi numero di secondi e presentarli in un formato a blocchi, arrotondati al valore di riferimento desiderato. Adobe consiglia di utilizzare questo plug-in se desideri acquisire un valore di tempo in secondi e convertirlo in un formato di bucket (ad esempio minuti, giorni o settimane). Questo plug-in non è necessario se non desideri eseguire il bucket di valori basati su secondi in un formato arrotondato al tempo.

Installare il plug-in utilizzando l’SDK per web o l’estensione SDK per web

Questo plug-in non è ancora supportato per l'utilizzo all'interno 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 a Extensions , quindi fai clic sul Catalog pulsante
4. Installa e pubblica il Common Analytics Plugins estensione
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 formatTime
7. Salva e pubblica le modifiche 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 a Extensions , quindi fai clic sul pulsante Configure sotto l'estensione Adobe Analytics.
4. Espandi la Configure tracking using custom code fisarmonica, che rivela Open Editor pulsante .
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: formatTime v2.0 */
function formatTime(ns,tf,bml){var f=ns,d=tf,e=bml;function h(b,d,c,e){if("string"!==typeof d)return!1;if("string"===typeof b)b=b.split(c||",");else if("object"!==typeof b)return!1;c=0;for(a=b.length;c<a;c++)if(1==e&&d===b[c]||d.toLowerCase()===b[c].toLowerCase())return!0;return!1}if(arguments&&"-v"===arguments[0])return{plugin:"formatTime",version:"2.0"};var b=function(){if("undefined"!==typeof window.s_c_il)for(var b=0,c;b<window.s_c_il.length;b++)if(c=window.s_c_il[b],c._c&&"s_c"===c._c)return c}();"undefined"!==typeof b&&(b.contextData.formatTime="2.0");if(!("undefined"===typeof f||isNaN(f)||0>Number(f))){b="";if("string"===typeof d&&"d"===d||("string"!==typeof d||!h("h,m,s",d))&&86400<=f){var c=86400;var g="days";b=isNaN(e)?1:c/(e*c)}else"string"===typeof d&&"h"===d||("string"!==typeof d||!h("m,s",d))&&3600<=f?(c=3600,g="hours",b=isNaN(e)?4:c/(e*c)):"string"===typeof d&&"m"===d||("string"!==typeof d||!h("s",d))&&60<=f?(c=60,g="minutes",b=isNaN(e)?2:c/(e*c)):(c=1,g="seconds",b=isNaN(e)?.2:c/e);b=Math.round(f*b/c)/b+" "+g;0===b.indexOf("1 ")&&(b=b.substring(0,b.length-1));return b}};
/******************************************** END CODE TO DEPLOY ********************************************/

Usa il plug-in

La formatTime La funzione utilizza i seguenti argomenti:

• ns (obbligatorio, numero intero): Il numero di secondi di conversione o di formattazione
• tf (facoltativo, stringa): il tipo di formato in cui restituire i secondi in; impostazioni predefinite in secondi
  • Imposta su "d" se si desidera l’ora in giorni (arrotondata per impostazione predefinita al valore di riferimento di 1/4 giorni più vicino)
  • 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 il tempo in secondi (arrotondato al valore di riferimento di 5 secondi più vicino per impostazione predefinita)
• bml (facoltativo, numero): Lunghezza dei parametri di arrotondamento. Valori predefiniti dei parametri di riferimento elencati nel tf argomento

La funzione restituisce il numero di secondi formattati utilizzando l'unità specificata nel tf argomento. Se la tf argomento non impostato:

• Qualsiasi valore inferiore a un minuto viene arrotondato al valore di riferimento più vicino di 5 secondi
• 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 di trimestre più vicino
• Qualsiasi valore maggiore di un giorno viene arrotondato al valore di riferimento del giorno più vicino

Esempi

// Sets eVar1 to "10.5 hours".
// 38242 seconds equals 10 hours, 37 minutes, and 22 seconds. Since the tf argument is not set, the value returned is the number of seconds converted to the nearest quarter-hour benchmark.
s.eVar1 = formatTime(38242);

// Sets eVar4 to "10.75 hours".
// 38250 seconds equals 10 hours, 37 minutes, and 30 seconds. This value rounds up to the nearest quarter hour.
s.eVar4 = formatTime(38250);

// Sets eVar9 to "637.5 minutes".
s.eVar9 = formatTime(38242, "m");

// Sets eVar14 to "640 minutes".
// The tf argument forces the returned value to minutes, while the bml argument forces the value to the nearest 20-minute increment.
s.eVar14 = formatTime(38242, "m", 20);

// Sets eVar2 to "126 seconds", the closest 2-second benchmark to 125 seconds.
s.eVar2 = formatTime(125, "s", 2);

// Sets eVar7 to "3 minutes", the closest 3-minute benchmark to 125 seconds.
s.eVar7 = formatTime(125, "m", 3);

// Sets eVar55 to "2.4 minutes, the closest 2/5-minute benchmark to 145 seconds.
s.eVar55 = formatTime(145, "m", .4);

Cronologia versioni

2.0 (19 marzo 2021)

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

1.1 (21 maggio 2018)

• È stato aggiunto il bml argomento per consentire una maggiore flessibilità nell'arrotondamento

1.0 (15 aprile 2018)

• Versione iniziale.