Personalizzazione del framework Adobe Analytics customizing-the-adobe-analytics-framework

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

Informazioni su JavaScript generato per i framework about-the-generated-javascript-for-frameworks

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

Il codice 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 questo 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 si utilizza un codice javascript personalizzato per personalizzare il framework, si modifica il contenuto di questo file.

Configurazione delle proprietà di Adobe Analytics configuring-adobe-analytics-properties

All’interno di Adobe Analytics sono disponibili una serie di variabili predefinite configurabili in un framework​ . ​ Il charset, cookieLifetime, currencyCode e trackInlineStats sono incluse nella variabile Impostazioni generali di Analytics per impostazione predefinita.

È possibile aggiungere all’elenco i nomi e i valori delle variabili. Queste variabili predefinite e tutte le variabili aggiunte vengono utilizzate per configurare le proprietà di s nel file analytics.sitecatalyst.js . L’esempio seguente mostra come è stato aggiunto prop10 proprietà del valore CONSTANT è rappresentato 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.

Aggiunta di JavaScript personalizzati a un framework Adobe Analytics adding-custom-javascript-to-an-adobe-analytics-framework

La casella javascript gratuita in Impostazioni generali di Analytics Area consente di aggiungere codice personalizzato a un framework Adobe Analytics.

Il codice che aggiungi viene aggiunto al file analytics.sitecatalyst.js . Pertanto, puoi accedere al s , che è un'istanza della variabile s_gi oggetto javascript definito in s_code.js. Ad esempio, l'aggiunta del codice seguente equivale all'aggiunta di una variabile denominata prop10 del valore CONSTANT, come illustrato nella sezione precedente:

s.prop10= 'CONSTANT';

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

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, integrarli in AEM.

L'esempio seguente concatena i dati acquisiti su una pagina in ordine gerarchico, utilizzando un separatore comune di "|".

Un framework Adobe Analytics dispone delle seguenti configurazioni:

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

Aggiunta di codice personalizzato globale per tutti i framework Adobe Analytics adding-global-custom-code-for-all-adobe-analytics-frameworks

Fornisci codice JavaScript personalizzato integrato in tutti i framework Adobe Analytics. Quando il framework Adobe Analytics di una pagina non contiene elementi personalizzati javascript in formato libero, il javascript generato dallo script /libs/cq/analytics/components/sitecatalyst/config.js.jsp viene aggiunto al analytics.sitecatalyst.js file. Per impostazione predefinita, lo script non ha alcun effetto in quanto è commentato. 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 seguente codice:

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

Pertanto, il tuo javascript dovrebbe impostare s.usePlugins a true in modo che qualsiasi codice nel s_doPlugins viene eseguita la funzione . Per personalizzare il codice, sovrapponi il file config.js.jsp con uno che utilizza il tuo javascript. Se il tuo JavaScript deve utilizzare i plug-in Adobe Analytics, integrarli in AEM.

Utilizzo dei plug-in di Adobe Analytics in AEM using-adobe-analytics-plugins-in-aem

Ottieni il codice javascript per i plug-in Adobe Analytics e integrali nel tuo framework Adobe Analytics in AEM. Aggiungi il codice a una cartella della libreria client della categoria sitecatalyst.plugins in modo che siano disponibili per il tuo codice javascript personalizzato.

Ad esempio, se si integra il getQueryParams plug-in, puoi chiamare il plug-in dal s_doPlugins funzione del tuo javascript personalizzato. Il codice di esempio seguente 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:

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

Per creare la cartella della libreria client per i plug-in, attenersi alla procedura descritta di seguito. È sufficiente eseguire questa procedura una sola volta. Per aggiungere un plug-in alla cartella della libreria client, utilizza la procedura seguente.

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