Personalizar Adobe Analytics Framework customizing-the-adobe-analytics-framework

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

Acerca de la JavaScript generada para módulos about-the-generated-javascript-for-frameworks

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

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

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;
*/

Cuando se utiliza código JavaScript personalizado para personalizar el marco de trabajo, se modifica el contenido de este archivo.

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

Hay varias variables predefinidas en Adobe Analytics que se pueden configurar en un marco de trabajo. Las variables charset, cookieLifetime, currencyCode y trackInlineStats se incluyen en la lista Configuración general de Analytics de forma predeterminada.

Puede agregar nombres y valores de variables a la lista. Estas variables predefinidas y cualquier variable que agregue se utilizarán para configurar las propiedades del objeto s en el archivo analytics.sitecatalyst.js. El siguiente ejemplo muestra cómo se representa la propiedad prop10 del valor CONSTANT agregada 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:

Agregar JavaScript personalizado a un marco de trabajo de Adobe Analytics adding-custom-javascript-to-an-adobe-analytics-framework

El cuadro de diálogo libre de JavaScript en el área Configuración general de Analytics le permite agregar código personalizado a un marco de trabajo de Adobe Analytics.

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

s.prop10= 'CONSTANT';

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

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

En el siguiente procedimiento se muestra cómo utilizar el cuadro JavaScript para personalizar el seguimiento de Adobe Analytics. Si tu JavaScript necesita usar complementos de Adobe Analytics AEM, inclúyalos en el sistema de administración de etiquetas de la red de.

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 trabajo de Adobe Analytics tiene las siguientes configuraciones:

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

Añadir 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 trabajo de Adobe Analytics. Cuando el marco de trabajo de Adobe Analytics de una página no contiene JavaScript de forma libre, el JavaScript generado por el script /libs/cq/analytics/components/sitecatalyst/config.js.jsp se anexa al archivo analytics.sitecatalyst.js. De forma predeterminada, la secuencia de comandos no tiene efecto porque está comentada. El código también establece s.usePlugins en 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 Adobe Analytics s_code.js) contiene el siguiente código:

if (s.usePlugins) s.doPlugins

Por lo tanto, su JavaScript debe establecer s.usePlugins en true para que se ejecute cualquier código de la función s_doPlugins. Para personalizar el código, superponga el archivo config.js.jsp con uno que utilice su propio JavaScript. Si tu JavaScript necesita usar complementos de Adobe Analytics AEM, inclúyalos en el sistema de administración de etiquetas de la red de.

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

Obtenga el código de JavaScript para los complementos de Adobe Analytics e integre estos complementos en el marco de trabajo de Adobe Analytics AEM en la. Agregue el código a una carpeta de la biblioteca de cliente de la categoría sitecatalyst.plugins para que esté disponible para el código personalizado de JavaScript.

Por ejemplo, si integra el complemento getQueryParams, puede llamar al complemento desde la función s_doPlugins de su JavaScript personalizado. El siguiente código de ejemplo envía la cadena de consulta en "pid" desde la dirección URL del referente como eVar 1, 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 de cliente para sus complementos. Solo debe realizar este procedimiento una vez. Para añadir un complemento a la carpeta de biblioteca del cliente, utilice el procedimiento siguiente.

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