Personalizzazione di Adobe Analytics Framework

Il framework Adobe Analytics determina le informazioni tracciate con Adobe Analytics. Per personalizzare il framework predefinito, utilizzate javascript per aggiungere il tracciamento personalizzato, integrare plug-in Adobe Analytics e modificare le impostazioni generali nel framework utilizzato per il tracciamento.

Informazioni su JavaScript generato per Framework

Quando una pagina è associata a un framework Adobe Analytics e include riferimenti al moduloAnalytics, per la pagina viene generato automaticamente un file analytics.sitecatalyst.js.

Il javascript nella pagina crea un s_gioggetto (definito dalla libreria Adobe Analytics s_code.js) e assegna valori alle relative proprietà. Il nome dell'istanza dell'oggetto è s. Gli esempi di codice presentati in questa sezione fanno diversi riferimenti a questa s variabile.

Il codice di esempio seguente è simile al codice presente in un file analytics.sitecatalyst.js:

var s_account = "my_sitecatalyst_account";
var s = s_gi(s_account);
s.fpCookieDomainPeriods = "3";
s.currencyCode= 'USD';
s.trackInlineStats= true;
s.linkTrackVars= 'None';
s.charSet= 'UTF-8';
s.linkLeaveQueryString= false;
s.linkExternalFilters= '';
s.linkTrackEvents= 'None';
s.trackExternalLinks= true;
s.linkDownloadFileTypes= 'exe,zip,wav,mp3,mov,mpg,avi,wmv,doc,pdf,xls';
s.linkInternalFilters= 'javascript:,'+window.location.hostname;
s.trackDownloadLinks= true;
        
s.visitorNamespace = "mynamespace";
s.trackingServer = "xxxxxxx.net";
s.trackingServerSecure = "xxxxxxx.net";

/* Plugin Config */
/*
s.usePlugins=false;
function s_doPlugins(s) {
    //add your custom plugin code here
}
s.doPlugins=s_doPlugins;
*/

Quando utilizzate codice JavaScript personalizzato per personalizzare il framework, modificate il contenuto di questo file.

Configurazione proprietà Adobe Analytics

All'interno Adobe Analytics sono presenti numerose variabili predefinite configurabili in un framework​. Per impostazione predefinita, le variabili charset, cookieLifetime, currencyCode e trackInlineStats sono incluse nell'elenco General Analytics Settings (Impostazionigenerali di Analytics).

aa-22

È possibile aggiungere i nomi e i valori delle variabili all'elenco. Queste variabili predefinite e tutte le variabili aggiunte vengono utilizzate per configurare le proprietà dell' s oggetto nel file analytics.sitecatalyst.js. L'esempio seguente mostra come la prop10 proprietà aggiunta di value CONSTANT sia rappresentata nel codice javascript:

var s_account = "my_sitecatalyst_account";
var s = s_gi(s_account);
s.fpCookieDomainPeriods = "3";
s.currencyCode= 'USD';
s.trackInlineStats= true;
s.linkTrackVars= 'None';
s.charSet= 'UTF-8';
s.linkLeaveQueryString= false;
s.linkExternalFilters= '';
s.linkTrackEvents= 'None';
s.trackExternalLinks= true;
s.linkDownloadFileTypes= 'exe,zip,wav,mp3,mov,mpg,avi,wmv,doc,pdf,xls';
s.prop10= 'CONSTANT';
s.linkInternalFilters= 'javascript:,'+window.location.hostname;
s.trackDownloadLinks= true;
        
s.visitorNamespace = "mynamespace";
s.trackingServer = "xxxxxxx.net";
s.trackingServerSecure = "xxxxxxx.net";

Per aggiungere variabili all'elenco, attenersi alla procedura descritta di seguito.

  1. Nella pagina framework Adobe Analytics, espandete l'area Impostazioni ​generali di Analytics.

  2. Sotto l’elenco delle variabili, fate clic su Aggiungi elemento per aggiungere una nuova variabile all’elenco.

  3. Nella cella a sinistra, immettete un nome per la variabile, ad esempio prop10.

  4. Nella colonna di destra, immettete un valore per la variabile, ad esempio CONSTANT.

  5. Per rimuovere una variabile, fare clic sul pulsante (-) accanto alla variabile.

Nota

Quando immetti variabili e valori, accertati che siano formattate e digitate correttamente oppure che le chiamate non vengano inviate con la coppia di valori/variabili corretta. Le variabili e i valori errati possono anche impedire l’esecuzione di chiamate.

Per verificare che queste variabili siano impostate correttamente, rivolgetevi al rappresentante Adobe Analytics .

ATTENZIONE

Alcune delle variabili di questo elenco sono obbligatorie per consentire il corretto funzionamento chiamate Adobe Analytics (ad esempio currencyCode, charSet)

Quindi, anche se vengono rimossi dal framework stesso, saranno comunque associati con un valore predefinito quando viene effettuata la chiamata Adobe Analytics .

Aggiunta di JavaScript personalizzati a un Adobe Analytics Framework

La casella javascript gratuita nell'area Impostazioni ​generali di Analytics consente di aggiungere codice personalizzato a un framework Adobe Analytics .

a-21

Il codice aggiunto viene aggiunto al file analytics.sitecatalyst.js. Pertanto, è possibile accedere alla s variabile, che è un'istanza dell'oggetto s_gi javascript definito in s_code.js. Ad esempio, aggiungere il codice seguente equivale ad aggiungere una variabile denominata prop10 of value CONSTANT, come illustrato nella sezione precedente:

s.prop10= 'CONSTANT';

Il codice nel file analytics.sitecatalyst.js (che include il contenuto del file Adobe Analytics s-code.js ) contiene il codice seguente:

if (s.usePlugins) s.doPlugins(s)

La procedura seguente illustra come utilizzare la casella javascript per personalizzare tracciamento Adobe Analytics. Se il vostro javascript ha bisogno di utilizzare plugin Adobe Analytics, integrarli in AEM.

  1. Aggiungete il seguente codice JavaScript alla casella in modo che s.doPlugins venga eseguito:

    s.usePlugins=true;
    function s_doPlugins(s) {
        //add your custom code here
    }
    s.doPlugins=s_doPlugins;
    
    ATTENZIONE

    Questo codice è necessario se desiderate inviare variabili in una chiamata Adobe Analytics che sono state personalizzate in un modo che non può essere fatto tramite l’interfaccia di trascinamento di base OPPURE attraverso JavaScript in linea in vista Adobe Analytics.

    Se le variabili personalizzate non rientrano nella funzione s_doPlugins, verranno inviate come *undefined *nella chiamata Adobe Analytics

  2. Aggiungete il codice javascript nella funzione s_doPlugins .

Nell'esempio seguente vengono concatenati i dati acquisiti in una pagina in ordine gerarchico, utilizzando un separatore comune di "|".

Un framework Adobe Analytics dispone delle seguenti configurazioni:

  • La variabile prop2 Adobe Analytics è mappata alla proprietà pagedata.sitesection site.

  • La variabile prop3 Adobe Analytics è mappata alla proprietà pagedata.subsection site.

  • Il codice seguente è aggiunto alla casella javascript gratuita:

    s.usePlugins=true; 
     function s_doPlugins(s) { 
     s.prop1 = s.prop2+'|'+s.prop3; 
     } 
     s.doPlugins=s_doPlugins;
    
  • Quando viene visualizzata la pagina Web che utilizza il framework (o, in modalità di modifica, la pagina viene ricaricata o visualizzata in anteprima), vengono eseguite le chiamate a Adobe Analytics.

Ad esempio, in Adobe Analytics vengono generati i seguenti valori:

aa-20

Aggiunta di codice personalizzato globale per tutti i Adobe Analytics Framework

Fornite codice JavaScript personalizzato integrato in tutti i framework Adobe Analytics . Quando il framework Adobe Analytics pagina non contiene JavaScript personalizzato in formalibera, il javascript generato dallo script /libs/cq/analytics/components/sitecatalyst/config.js.jsp viene aggiunto al file analytics.sitecatalyst.js . Per impostazione predefinita, lo script non ha alcun effetto perché è impostato come commento. Il codice imposta anche s.usePlugins a false:

/* Plugin Config */
/*
s.usePlugins=false;
function s_doPlugins(s) {
    //add your custom plugin code here
}
s.doPlugins=s_doPlugins;
*/

Il codice nel file analytics.sitecatalyst.js (che include il contenuto del file Adobe Analytics s_code.js) contiene il codice seguente:

if (s.usePlugins) s.doPlugins(s)

Pertanto, il codice javascript deve essere impostato s.usePlugins su true in modo che venga eseguito qualsiasi codice nella s_doPlugins funzione. Per personalizzare il codice, sovrapponete il file config.js.jsp con uno che utilizza il vostro javascript. Se il vostro javascript ha bisogno di utilizzare plugin Adobe Analytics, integrarli in AEM.

Nota

Non modificate il file /libs/cq/analytics/components/sitecatalyst/config.js.jsp. Alcune AEM attività di aggiornamento o manutenzione possono reinstallare il file originale, rimuovendo le modifiche.

  1. In CRXDE Lite , create la struttura di cartelle /apps/cq/analytics/components:

    1. Fate clic con il pulsante destro del mouse sulla cartella /apps e fate clic su Crea > Crea cartella.
    2. Specificate cq il nome della cartella e fate clic su OK.
    3. Analogamente, create le cartelle analytics e components .
  2. Fare clic con il pulsante destro del mouse sulla components cartella appena creata e scegliere Crea > Crea componente. Specificate i seguenti valori di proprietà:

    • Etichetta: sitecatalyst
    • Titolo: sitecatalyst
    • Super Type: /libs/cq/analytics/components/sitecatalyst
    • Gruppo: hidden
  3. Fare clic più volte su Avanti finché il pulsante OK non è attivato, quindi fare clic su OK.

    Il componente sitecatalyst contiene il file sitecatalyst.jsp creato automaticamente.

  4. Fate clic con il pulsante destro del mouse sul file sitecatalyst.jsp e fate clic su Elimina.

  5. Fate clic con il pulsante destro del mouse sul componente SiteCatalyst e fate clic su Crea > Crea file. Specificate il nome config.js.jsp e fate clic su OK.

    Il file config.js.jsp si apre automaticamente per la modifica.

  6. Aggiungete il testo seguente al file, quindi fate clic su Salva tutto:

    <%@page session="true"%>
    /* Plugin Config */
    s.usePlugins=true;
    function s_doPlugins(s) {
        //add your custom plugin code here
    }
    s.doPlugins=s_doPlugins;
    

    Il codice JavaScript generato dallo script /apps/cq/analytics/components/sitecatalyst/config.js.jsp ora viene inserito nel file analytics.sitecatalyst.js per tutte le pagine che utilizzano un framework Adobe Analytics .

  7. Aggiungete il codice JavaScript da eseguire nella s_doPlugins funzione, quindi fate clic su Salva tutto.

ATTENZIONE

Se un testo è presente nello javascript a forma libera del framework di una pagina (anche solo spazi bianchi), config.js.jsp viene ignorato.

Utilizzo plug-in Adobe Analytics in AEM

Ottenete il codice javascript per i plug-in Adobe Analytics e integrateli nel framework Adobe Analytics in AEM. Aggiungete il codice a una cartella libreria client della categoria sitecatalyst.plugins in modo che sia disponibile per il codice JavaScript personalizzato.

Ad esempio, se integrate il getQueryParams plug-in, potete chiamarlo dalla s_doPlugins funzione del javascript personalizzato. Il seguente codice di esempio invia la stringa di query in "pid" dall'URL del referente come eVar1, quando viene attivata una chiamata Adobe Analytics .

s.usePlugins=true;
function s_doPlugins(s) {
   // take the query string from the referrer
   s.eVar1=s.getQueryParam('pid','',document.referrer); 
}
s.doPlugins=s_doPlugins;

AEM i seguenti plug-in Adobe Analytics, in modo che siano disponibili per impostazione predefinita:

  • getQueryParam()
  • getPreviousValue()
  • split()

La cartella della libreria client /libs/cq/analytics/clientlibs/sitecatalyst/plugins include questi plug-in nella categoria sitecatalyst.plugins.

Nota

Create una nuova cartella libreria client per i plug-in. Non aggiungete plug-in alla /libs/cq/analytics/clientlibs/sitecatalyst/plugins cartella. In questo modo il contributo alla sitecatalyst.plugins categoria non verrà sovrascritto durante AEM reinstallazione o le attività di aggiornamento.

Utilizzate la procedura seguente per creare la cartella della libreria client per i plug-in. È necessario eseguire questa procedura solo una volta. Per aggiungere un plug-in alla cartella della libreria client, utilizzate la procedura seguente.

  1. In un browser Web, aprite CRXDE Lite. (http://localhost:4502/crx/de)

  2. Fate clic con il pulsante destro del mouse sulla cartella /apps/my-app/clientlibs e scegliete Crea > Crea nodo. Immettete i seguenti valori di proprietà e fate clic su OK:

    • Nome: Un nome per la cartella della libreria client, ad esempio i miei plug-in

    • Tipo: cq:ClientLibraryFolder

  3. Selezionate la cartella della libreria client appena creata e utilizzate la barra delle proprietà in basso a destra per aggiungere la seguente proprietà:

    • Nome: category
    • Tipo: Stringa
    • Valore: sitecatalyst.plugins
    • Multi: selected

    Fare clic su OK nella finestra Modifica per confermare il valore della proprietà.

  4. Fate clic con il pulsante destro del mouse sulla cartella della libreria client appena creata e fate clic su Crea > Crea file. Per il nome del file digitare js.txt, quindi fare clic su OK.

  5. Fate clic su Salva tutto.

Utilizzate la procedura seguente per ottenere il codice plug-in, memorizzare il codice nell'archivio AEM e aggiungere il codice alla cartella della libreria client.

  1. Accedete a sc.omniture.com utilizzando il vostro account Adobe Analytics .

  2. Nella pagina di destinazione, accedete a Aiuto > Home dell’Aiuto.

  3. Nel sommario a sinistra, fate clic su Plug-in di implementazione.

  4. Fate clic sul collegamento al plug-in che desiderate aggiungere e quando la pagina si apre, individuate il codice sorgente javascript per il plug-in, quindi selezionate il codice e copiatelo.

  5. Fate clic con il pulsante destro del mouse sulla cartella della libreria client e fate clic su Crea > Crea file. Per il nome del file, digitate il nome del plug-in che state integrando seguito da .js, quindi fate clic su OK. Ad esempio, se state integrando il plug-in getQueryParam, assegnate al file il nome getQueryParam.js.

    Quando create il file, questo viene aperto per la modifica.

  6. Incollate il codice JavaScript del plug-in nel file, fate clic su Salva tutto, quindi chiudete il file.

  7. Aprite il file js.txt dalla cartella della libreria client.

  8. In una nuova riga, aggiungete il nome del file che contiene il plug-in, ad esempio getQueryParam.js. Quindi, fate clic su Salva tutto e chiudete il file.

Nota

Quando si utilizzano i plug-in, assicurarsi di integrare anche eventuali plugin di supporto, altrimenti il plugin javascript non riconoscerà le chiamate che effettua alle funzioni nel plugin di supporto. Ad esempio, il plug-in getPreviousValue() richiede che il plug-in split() funzioni correttamente.

Il nome del plug-in di supporto deve essere aggiunto anche a js.txt .

In questa pagina