Plug-in di Adobe: getTimeParting

IMPORTANT
Questo plug-in è fornito a titolo di cortesia da Adobe Consulting per aiutarti a ottenere più valore da Adobe Analytics. L’Assistenza clienti di Adobe non fornisce supporto per questo plug-in, per la sua installazione né per la risoluzione di problemi. Se hai bisogno di aiuto con questo plug-in, contatta il team dell’account Adobe della tua organizzazione. Il team può organizzare una riunione con un consulente per l’assistenza.

Il plug-in getTimeParting consente di acquisire i dettagli del momento in cui si verifica un'attività misurabile sul sito. Questo plug-in è utile quando desideri suddividere le metriche in base a qualsiasi divisione di tempo ripetibile in un determinato intervallo di date. Ad esempio, puoi confrontare i tassi di conversione tra due giorni diversi della settimana, ad esempio tutte le domeniche e tutti i giovedì. Puoi anche confrontare periodi della giornata, ad esempio tutte le mattine rispetto a tutte le sere.

Analysis Workspace fornisce dimensioni predefinite simili, formattate in modo leggermente diverso rispetto a questo plug-in. Per ulteriori informazioni, consulta dimensioni suddivise in base al tempo nella guida utente Analizza. Alcune organizzazioni ritengono che le dimensioni predefinite di Analysis Workspace siano sufficienti.

IMPORTANT
La versione 4.0+ di questo plug-in è significativamente diversa dalle versioni precedenti. L’Adobe consiglia vivamente di implementare questo plug-in "da zero". Il codice che fa riferimento al plug-in precedente alla versione 4.0 non è compatibile con la versione corrente del plug-in.

Installare il plug-in utilizzando l’estensione Web SDK

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

  1. Accedi a Raccolta dati di Adobe Experience Platform utilizzando le credenziali Adobe ID.

  2. Fare clic su Tags a sinistra, quindi fare clic sulla proprietà tag desiderata.

  3. Fai clic su Extensions a sinistra, quindi sulla scheda Catalog

  4. Individuare e installare l'estensione Common Web SDK Plugins.

  5. Fai clic su Data Elements a sinistra, quindi sull'elemento dati desiderato.

  6. Imposta il nome dell’elemento dati desiderato con la seguente configurazione:

    • Estensione: Common Web SDK Plugins
    • Elemento dati: getTimeParting
  7. Imposta il parametro Time Zone a destra.

  8. Salva e pubblica le modifiche apportate all’elemento dati.

Installare manualmente il plug-in implementando Web SDK

Questo plug-in non è ancora supportato per l’utilizzo in un’implementazione manuale 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 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 "Initialize Plug-ins" (Inizializza plug-in) con la seguente configurazione:

    • Condizione: nessuna
    • Evento: Core - Library Loaded (Page Top)
  6. Aggiungi un’azione alla regola precedente con la seguente configurazione:

    • Estensione: Common Analytics Plugins
    • Tipo azione: inizializzare getTimeParting
  7. Salva e pubblica le modifiche apportate 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 alla scheda Extensions, quindi fai clic sul pulsante Configure sotto l'estensione Adobe Analytics.
  4. Espandere il pannello a soffietto Configure tracking using custom code, che mostra il pulsante Open Editor.
  5. Apri l’editor di codice personalizzato e incolla il codice del plug-in fornito di seguito nella finestra di modifica.
  6. Salva e pubblica le modifiche nell’estensione Analytics.

Installare il plug-in utilizzando AppMeasurement

Copiare e incollare il codice seguente in qualsiasi punto del file di AppMeasurement dopo la creazione dell'istanza dell'oggetto di tracciamento di Analytics (utilizzando s_gi). Mantenere i commenti e i numeri di versione del codice nella tua implementazione aiuta ad Adobe nella risoluzione di eventuali problemi.

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getTimeParting v6.3 (No Prerequisites Needed) */
function getTimeParting(t){var c=t;if("-v"===t)return{plugin:"getTimeParting",version:"6.3"};a:{if("undefined"!==typeof window.s_c_il){var a=0;for(var b;a<window.s_c_il.length;a++)if(b=window.s_c_il[a],b._c&&"s_c"===b._c){a=b;break a}}a=void 0}"undefined"!==typeof a&&(a.contextData.getTimeParting="6.3");c=document.documentMode?void 0:c||"Etc/GMT";a=(new Date).toLocaleDateString("en-US",{timeZone:c,minute:"numeric",hour:"numeric",weekday:"long",day:"numeric",year:"numeric",month:"long"});a=/([a-zA-Z]+).*?([a-zA-Z]+).*?([0-9]+).*?([0-9]+)(.*?)([0-9])(.*)/.exec(a);return"year="+a[4]+" | month="+a[2]+" | date="+a[3]+" | day="+a[1]+" | time="+(a[6]+a[7])};
/******************************************** END CODE TO DEPLOY ********************************************/

Utilizzare il plug-in

La funzione getTimeParting utilizza l'argomento seguente:

t (facoltativo ma consigliato, stringa): nome del fuso orario in cui convertire l'ora locale del visitatore. Ora UTC/GMT predefinita. Per un elenco completo dei valori validi, vedere Elenco dei fusi orari del database TZ su Wikipedia.

I valori validi comuni includono:

  • "America/New_York" per Ora Est
  • "America/Chicago" per ora centrale
  • "America/Denver" per fuso occidentale
  • "America/Los_Angeles" per Ora Pacifico

La chiamata di questa funzione restituisce una stringa che contiene i seguenti elementi delimitati da una barra verticale (|):

  • L'anno corrente
  • Il mese corrente
  • Il giorno del mese
  • Il giorno della settimana
  • Ora corrente (AM/PM)

Esempi

// Use the following code if the visitor resides in Paris, France
s.eVar8 = getTimeParting("Europe/Paris");

// Use the following code if the visitor resides in San Jose, California
s.eVar17 = getTimeParting("America/Los_Angeles");

// Use the following code if the visitor resides in Ghana.
// Note that Ghana is in GMT time, the default time zone that the plug-in uses with no argument
s.eVar22 = getTimeParting();

// Internet Explorer only returns the visitor's local time. Use this conditional statement to accommodate IE visitors
if(!document.documentMode) s.eVar39 = getTimeParting("America/New_York");
else s.eVarX = "Internet Explorer Visitors";

// Given a visitor from Denver Colorado visits a site on August 31, 2020 at 9:15 AM
// Returns the string value "year=2020 | month=August | date=31 | day=Friday | time=6:15 PM"
s.eVar10 = getTimeParting("Europe/Athens");

// Returns the string value "year=2020 | month=August | date=31 | day=Friday | time=6:15 AM"
s.eVar11 = getTimeParting("America/Nome");

// Returns the string value "year=2020 | month=August | date=31 | day=Friday | time=8:45 PM"
s.eVar12 = getTimeParting("Asia/Calcutta");

// Returns the string value "year=2020 | month=September | date=1 | day=Saturday | time=1:15 AM"
s.eVar13 = getTimeParting("Australia/Sydney");

Cronologia versioni

6.3 (19 marzo 2021)

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

6.2 (5 novembre 2019)

  • Correzioni di piccoli bug
  • Dimensione totale del codice ridotta

6.1 (26 novembre 2018)

  • Correzione per i browser Internet Explorer. Possono restituire l’ora, ma solo nell’ora locale del visitatore.

6.0 (14 agosto 2018)

  • Riscrittura completa per soddisfare gli standard internazionali. Ora converte in modo appropriato l'ora legale e tutti i fusi orari.

5.0 (17 aprile 2018)

  • Versione punto (ricompilato, con codice di dimensioni inferiori)
  • È stata rimossa la necessità del parametro tpDST, poiché le date di inizio/fine dell'ora legale vengono rilevate automaticamente
CAUTION
Le versioni precedenti di questo plug-in non includevano tutti gli anni a venire. Se utilizzi una versione precedente di questo plug-in, Adobe consiglia vivamente di eseguire l’aggiornamento alla versione più recente per evitare errori JavaScript e perdite di dati. Se non è possibile aggiornare il plug-in, verificare che la variabile s._tpdst nel codice del plug-in contenga gli anni appropriati per il futuro.

4.0 (22 agosto 2016)

  • Fornisce una nuova soluzione e ora include informazioni su anno, mese e data.
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690