Show Menu
ARGOMENTI×

Personalizzazione di Adobe Analytics Framework

Il framework di Adobe Analytics determina le informazioni tracciate con Adobe Analytics. Per personalizzare il framework predefinito, utilizzate javascript per aggiungere il tracciamento personalizzato, integrare i plug-in di 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 modulo Analytics, per la pagina viene generato automaticamente un file analytics.sitecatalyst.js.
Il javascript nella pagina crea un s_gi oggetto (definito dalla libreria di 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 delle proprietà di Adobe Analytics

All'interno di 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 Impostazioni generali di Analytics.
È possibile aggiungere all'elenco nomi e valori di variabili. 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 del framework di 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.
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.
Consultate il rappresentante Adobe Analytics per verificare che queste variabili siano impostate correttamente.
Alcune delle variabili in questo elenco sono obbligatorie per il corretto funzionamento delle chiamate Adobe Analytics (ad esempio currencyCode , charSet )
Quindi, anche se vengono rimossi dal framework stesso, saranno comunque associati con un valore predefinito al momento della chiamata ad Adobe Analytics.

Aggiunta di JavaScript personalizzato a un framework di Adobe Analytics

La casella javascript gratuita nell'area Impostazioni generali di Analytics consente di aggiungere codice personalizzato a un framework Adobe Analytics.
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 s-code.js file Adobe Analytics) contiene il codice seguente:
if (s.usePlugins) s.doPlugins(s)
La procedura seguente illustra come utilizzare la casella javascript per personalizzare il tracciamento di Adobe Analytics. Se il tuo javascript deve utilizzare i plug-in Adobe Analytics, integrali 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;
    
    
    Questo codice è necessario se vuoi 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 tramite JavaScript in linea in Adobe Analytics View.
    Se le variabili personalizzate non rientrano nella funzione s_doPlugins, verranno inviate come *undefined *nella chiamata di 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 viene mappata sulla proprietà pagedata.sitesection site.
  • La variabile prop3 Adobe Analytics viene mappata sulla 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 ad Adobe Analytics.
Ad esempio, in Adobe Analytics vengono generati i seguenti valori:

Aggiunta di codice personalizzato globale per tutti i framework di Adobe Analytics

Fornite codice JavaScript personalizzato, integrato in tutti i framework Adobe Analytics. Quando il framework Adobe Analytics di una pagina non contiene JavaScript Integrazione con Adobe Analytics gratuito personalizzato, 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 s_code.js di Adobe Analytics) contiene il codice seguente:
if (s.usePlugins) s.doPlugins(s)
Pertanto, il codice javascript deve essere impostato s.usePlugins su true in modo da eseguire 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 tuo javascript deve utilizzare i plug-in Adobe Analytics, integrali in AEM.
Non modificate il file /libs/cq/analytics/components/sitecatalyst/config.js.jsp. Alcune attività di aggiornamento o manutenzione di AEM 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.
Se un testo è presente nello javascript a forma libera del framework di una pagina (anche solo spazi bianchi), config.js.jsp viene ignorato.

Utilizzo dei plug-in di Adobe Analytics in AEM

Ottenete il codice javascript per i plug-in Adobe Analytics e integratelo 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 installa 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.
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 le attività di reinstallazione o aggiornamento di AEM.
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.
Per ottenere il codice plug-in, memorizzarlo nell’archivio AEM e aggiungere il codice alla cartella della libreria client, effettuate le seguenti operazioni.
  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.
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 .