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.

Informazioni sul 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 oggetto s_gi 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 variabile s.

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. Per impostazione predefinita, le variabili charset, cookieLifetime, currencyCode e trackInlineStats sono incluse nell'elenco Impostazioni generali di Analytics.

Puoi aggiungere nomi e valori di variabili all’elenco. Queste variabili predefinite ed eventuali variabili aggiunte vengono utilizzate per configurare le proprietà dell'oggetto s nel file analytics.sitecatalyst.js. Nell'esempio seguente viene illustrato come la proprietà prop10 aggiunta del valore CONSTANT è 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, 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 nell'area General Analytics Settings (Impostazioni generali di Analytics) consente di aggiungere codice personalizzato a un framework Adobe Analytics.

Il codice aggiunto viene aggiunto al file analytics.sitecatalyst.js. È quindi possibile accedere alla variabile s, che è un'istanza dell'oggetto JavaScript s_gi definito in s_code.js. Ad esempio, l'aggiunta del codice seguente equivale all'aggiunta di una variabile denominata prop10 del valore CONSTANT, che è l'esempio della 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 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 di Adobe Analytics, integrali 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 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é è stato escluso. Il codice imposta anche s.usePlugins su 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 deve impostare s.usePlugins su true in modo che venga eseguito qualsiasi codice nella funzione s_doPlugins. 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 di Adobe Analytics, integrali 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 in AEM. Aggiungere il codice a una cartella della libreria client della categoria sitecatalyst.plugins in modo che sia disponibile per il codice JavaScript personalizzato.

Se ad esempio si integra il plug-in getQueryParams, è possibile chiamare il plug-in dalla funzione s_doPlugins del 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 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.