Personalización del marco de trabajo de Adobe Analytics customizing-the-adobe-analytics-framework

El marco de Adobe Analytics determina la información que se rastrea con Adobe Analytics. Para personalizar el marco predeterminado, utilice javascript para agregar seguimiento personalizado, integrar complementos de Adobe Analytics y cambiar la configuración general dentro del marco utilizado para el seguimiento.

Acerca del javascript generado para módulos about-the-generated-javascript-for-frameworks

Cuando una página está asociada a un marco de Adobe Analytics, y la página incluye referencias al módulo Analytics, se genera automáticamente un archivo analytics.sitecatalyst.js para la página.

El javascript de la página crea un s_gi(que define la biblioteca s_code.js de Adobe Analytics) y asigna valores a sus propiedades. El nombre de la instancia del objeto es s. Los ejemplos de código que se presentan en esta sección hacen varias referencias a esta s variable.

El siguiente código de ejemplo es similar al código de un archivo 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;
*/

Al utilizar código personalizado de javascript para personalizar el marco, se modifica el contenido de este archivo.

Configuración de las propiedades de Adobe Analytics configuring-adobe-analytics-properties

Hay varias variables predefinidas dentro de Adobe Analytics que se pueden configurar en un marco​ . ​ El charset, cookieLifetime, currencyCode y trackInlineStats se incluyen en la variable Configuración general de análisis de forma predeterminada.

Puede agregar nombres y valores de variables a la lista. Estas variables predefinidas y cualquier variable que agregue se utilizan para configurar las propiedades de la variable s en el archivo analytics.sitecatalyst.js. El siguiente ejemplo muestra cómo se ha añadido la variable prop10 propiedad de value CONSTANT se representa en el código 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";

Utilice el siguiente procedimiento para añadir variables a la lista:

Adición de javascript personalizado a un Adobe Analytics Framework adding-custom-javascript-to-an-adobe-analytics-framework

El cuadro de javascript libre de la variable Configuración general de análisis area permite agregar código personalizado a un marco de Adobe Analytics.

El código que agregue se añadirá al archivo analytics.sitecatalyst.js . Por lo tanto, puede acceder al s , que es una instancia de la variable s_gi objeto de javascript definido en s_code.js. Por ejemplo, agregar el siguiente código equivale a agregar una variable denominada prop10 de valor CONSTANT, que es el ejemplo de la sección anterior:

s.prop10= 'CONSTANT';

El código de la variable analytics.sitecatalyst.js (que incluye el contenido de Adobe Analytics) s-code.js ) contiene el siguiente código:

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

El siguiente procedimiento muestra cómo utilizar el cuadro de javascript para personalizar el seguimiento de Adobe Analytics. Si su javascript necesita utilizar complementos de Adobe Analytics, integrarlos en AEM.

En el siguiente ejemplo se concatenan los datos capturados en una página en orden jerárquico, utilizando un separador común de "|".

Un marco de Adobe Analytics tiene las siguientes configuraciones:

Por ejemplo, en Adobe Analytics se generan los siguientes valores:

Adición de código personalizado global para todos los marcos de Adobe Analytics adding-global-custom-code-for-all-adobe-analytics-frameworks

Proporcione código javascript personalizado que esté integrado en todos los marcos de Adobe Analytics. Cuando el marco de Adobe Analytics de una página no contiene ninguna variable personalizada javascript de forma libre, el javascript que genera el script /libs/cq/analytics/components/sitecatalyst/config.js.jsp se anexa al analytics.sitecatalyst.js archivo. De forma predeterminada, la secuencia de comandos no tiene ningún efecto porque está comentada. El código también establece s.usePlugins a false:

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

El código del archivo analytics.sitecatalyst.js (que incluye el contenido del archivo s_code.js de Adobe Analytics) contiene el siguiente código:

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

Por lo tanto, su javascript debe establecer s.usePlugins a true para que cualquier código de la variable s_doPlugins se ejecuta. Para personalizar el código, superponga el archivo config.js.jsp con uno que utilice su propio javascript. Si su javascript necesita utilizar complementos de Adobe Analytics, integrarlos en AEM.

Uso de complementos de Adobe Analytics en AEM using-adobe-analytics-plugins-in-aem

Obtenga el código de javascript para los complementos de Adobe Analytics e inclúyalos en la infraestructura de Adobe Analytics en AEM. Añadir el código a una carpeta de biblioteca de cliente de la categoría sitecatalyst.plugins para que estén disponibles para su código personalizado de javascript.

Por ejemplo, si integra la variable getQueryParams complemento, puede llamar al complemento desde el complemento s_doPlugins de su javascript personalizado. El siguiente código de ejemplo envía la cadena de consulta en "pid" de la dirección URL del referente como eVar1, cuando se activa una llamada de 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 instala los siguientes complementos de Adobe Analytics, de modo que estén disponibles de forma predeterminada:

La carpeta de biblioteca de cliente /libs/cq/analytics/clientlibs/sitecatalyst/plugins incluye estos complementos en la categoría sitecatalyst.plugins .

Utilice el siguiente procedimiento para crear la carpeta de la biblioteca del cliente para sus complementos. Solo debe realizar este procedimiento una vez. Para agregar un complemento a la carpeta de la biblioteca del cliente, utilice el procedimiento siguiente.

Utilice el siguiente procedimiento para obtener el código del complemento, almacenar el código en el repositorio de AEM y agregar el código a la carpeta de la biblioteca del cliente.