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, puoi utilizzare JavaScript per aggiungere il tracciamento personalizzato, integrare i plug-in di Adobe Analytics e modificare le impostazioni generali nel framework utilizzato per il tracciamento.

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 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 di 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

In Adobe Analytics sono disponibili diverse variabili predefinite configurabili in un framework. Il charset, cookieLifetime, currencyCode, e trackInlineStats Le variabili sono incluse nel Impostazioni generali di Analytics per impostazione predefinita.

Puoi aggiungere nomi e valori di variabili all’elenco. Queste variabili predefinite ed eventuali variabili aggiunte vengono utilizzate per configurare le proprietà del 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, utilizza la procedura seguente:

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

La casella free-from JavaScript (Senza JavaScript) nella Impostazioni generali di Analytics area consente di aggiungere codice personalizzato a un framework Adobe Analytics.

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

s.prop10= 'CONSTANT';

Il codice in analytics.sitecatalyst.js (che include il contenuto dell’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 codice JavaScript deve utilizzare i plug-in di Adobe Analytics, integrarli nell’AEM.

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

Un framework Adobe Analytics presenta le seguenti configurazioni:

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

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

Fornisci un codice JavaScript personalizzato integrato in tutti i framework di Adobe Analytics. Quando il framework Adobe Analytics di una pagina non contiene 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 perché è stato escluso. 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 codice JavaScript deve essere impostato 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 codice JavaScript deve utilizzare i plug-in di Adobe Analytics, integrarli nell’AEM.

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

Ottieni il codice JavaScript per i plug-in di Adobe Analytics e integrali nel framework Adobe Analytics nell’AEM. Aggiungere il codice a una cartella di librerie client della categoria sitecatalyst.plugins in modo che siano disponibili per il codice JavaScript personalizzato.

Ad esempio, se integri getQueryParams plug-in, è possibile chiamare il plug-in da s_doPlugins del JavaScript personalizzato. Il codice di esempio seguente invia la stringa di query in "pid" dall’URL del referente come EVAR 1, 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 di 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.

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

Utilizza la procedura seguente per ottenere il codice del plug-in, archiviarlo nell’archivio AEM e aggiungerlo alla cartella della libreria client.