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 del JavaScript generado 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 generará 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 de 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 que se presentan en esta sección hacen varias referencias a esto 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;
*/
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. El charset, cookieLifetime, currencyCode, y trackInlineStats Las variables de se incluyen en Configuración general de Analytics lista 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 del s
en el archivo analytics.sitecatalyst.js. El siguiente ejemplo muestra cómo se agrega el elemento prop10
propiedad de valor 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:
-
En la página del marco de trabajo de Adobe Analytics, expanda Configuración general de Analytics área.
-
Debajo de la lista de variables, haga clic en Agregar elemento para agregar una nueva variable a la lista.
-
En la celda de la izquierda, introduzca un nombre para la variable, por ejemplo,
prop10
. -
En la columna derecha, introduzca un valor para la variable, por ejemplo,
CONSTANT
. -
Para quitar una variable, haga clic en el botón (-) junto a la variable.
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 Configuración general de Analytics permite añadir 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 acceder a las s
, que es una instancia de s_gi
Objeto JavaScript definido en s_code.js
. Por ejemplo, añadir el siguiente código equivale a añadir 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 JavaScript para personalizar el seguimiento de Adobe Analytics. Si JavaScript necesita utilizar complementos de Adobe Analytics, integrarlos AEM en el.
-
Agregue el siguiente código JavaScript al cuadro para que
s.doPlugins
se ejecuta:code language-none s.usePlugins=true; function s_doPlugins(s) { //add your custom code here } s.doPlugins=s_doPlugins;
note caution CAUTION Este código es necesario si desea enviar variables en una llamada de Adobe Analytics que se hayan personalizado de alguna manera que no se puedan realizar a través de la interfaz básica de arrastrar y soltar O a través de JavaScript en línea en la vista de Adobe Analytics. Si las variables personalizadas están fuera de la función s_doPlugins, se enviarán como *undefined *en la llamada de Adobe Analytics -
Añada su código JavaScript en la s_doPlugins función.
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:
-
El
prop2
La variable de Adobe Analytics está asignada apagedata.sitesection
propiedad del sitio. -
El
prop3
La variable de Adobe Analytics está asignada apagedata.subsection
propiedad del sitio. -
El siguiente código se agrega al cuadro de diálogo Código libre de JavaScript:
code language-none s.usePlugins=true; function s_doPlugins(s) { s.prop1 = s.prop2+'|'+s.prop3; } s.doPlugins=s_doPlugins;
-
Cuando se visita la página web que utiliza el módulo de (o, en el modo de edición, se vuelve a cargar la página o se obtiene una vista previa de ella), se realizan las llamadas a Adobe Analytics.
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 elementos personalizados 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 efecto porque está comentada. El código también establece s.usePlugins
hasta 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, JavaScript debe establecer s.usePlugins
hasta 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 JavaScript necesita utilizar complementos de Adobe Analytics, integrarlos AEM en el.
-
En CRXDE Lite, cree la estructura de carpetas /apps/cq/analytics/components:
- Haga clic con el botón derecho en la carpeta /apps y haga clic en Crear > Crear carpeta.
- Especificar
cq
como el nombre de la carpeta y haga clic en Aceptar. - Del mismo modo, cree el
analytics
ycomponents
carpetas.
-
Haga clic con el botón derecho en
components
que ha creado y haga clic en Crear > Crear componente. Especifique los siguientes valores de propiedad:- Etiqueta:
sitecatalyst
- Título:
sitecatalyst
- Supertipo:
/libs/cq/analytics/components/sitecatalyst
- Grupo:
hidden
- Etiqueta:
-
Haga clic repetidamente en Siguiente hasta que el botón Aceptar esté habilitado y, a continuación, haga clic en Aceptar.
El componente de SiteCatalyst contiene el archivo sitecatalyst.jsp creado automáticamente.
-
Haga clic con el botón derecho en el archivo sitecatalyst.jsp y haga clic en Eliminar.
-
Haga clic con el botón derecho en el componente SiteCatalyst y haga clic en Crear > Crear archivo. Especifique el nombre
config.js.jsp
y, a continuación, haga clic en Aceptar.El archivo config.js.jsp se abre automáticamente para su edición.
-
Agregue el siguiente texto al archivo y, a continuación, haga clic en Guardar todo:
code language-java <%@page session="true"%> /* Plugin Config */ s.usePlugins=true; function s_doPlugins(s) { //add your custom plugin code here } s.doPlugins=s_doPlugins;
El código JavaScript que genera el script /apps/cq/analytics/components/sitecatalyst/config.js.jsp ahora se inserta en el archivo analytics.sitecatalyst.js para todas las páginas que utilizan un marco de trabajo de Adobe Analytics.
-
Agregue el código JavaScript que desee ejecutar en la variable
s_doPlugins
y, a continuación, haga clic en Guardar todo.
Uso de complementos de Adobe Analytics AEM en la using-adobe-analytics-plugins-in-aem
Obtenga el código JavaScript para los complementos de Adobe Analytics e inclúyalos en su marco de trabajo de Adobe Analytics AEM en la versión de. Agregue el código a una carpeta de la biblioteca de cliente de la categoría sitecatalyst.plugins
para que estén disponibles en el código personalizado de JavaScript.
Por ejemplo, si integra la variable getQueryParams
, puede llamar al complemento desde el 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:
- getQueryParam()
- getPreviousValue()
- split()
La carpeta de biblioteca de cliente /libs/cq/analytics/clientlibs/sitecatalyst/plugins incluye estos complementos en la categoría sitecatalyst.plugins.
/libs/cq/analytics/clientlibs/sitecatalyst/plugins
carpeta. Esta práctica garantiza que su contribución a la sitecatalyst.plugins
AEM Las categorías de no se sobrescriben durante las tareas de reinstalación o actualización de la.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.
-
En un explorador web, abra el CRXDE Lite. (http://localhost:4502/crx/de)
-
Haga clic con el botón derecho en la carpeta /apps/my-app/clientlibs y haga clic en Crear > Crear nodo. Introduzca los siguientes valores de propiedad y haga clic en Aceptar:
-
Nombre: un nombre para la carpeta de la biblioteca de cliente, como my-plugins
-
Tipo: cq:ClientLibraryFolder
-
-
Seleccione la carpeta de biblioteca de cliente que ha creado y utilice la barra de propiedades inferior derecha para agregar la siguiente propiedad:
- Nombre: categories
- Tipo: cadena
- Valor: sitecatalyst.plugins
- Múltiple: seleccionado
Haga clic en OK en la ventana Edit para confirmar el valor de la propiedad.
-
Haga clic con el botón derecho en la carpeta de la biblioteca de cliente que ha creado y haga clic en Crear > Crear archivo. Para el nombre de archivo, escriba js.txt y haga clic en Aceptar.
-
Haga clic en Guardar todo.
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.
-
Iniciar sesión en sc.omniture.com con su cuenta de Adobe Analytics.
-
En la página de aterrizaje, vaya a Ayuda > Página principal de ayuda.
-
En la tabla de contenido de la izquierda, haga clic en Complementos de implementación.
-
Haga clic en el vínculo al complemento que desee añadir y, cuando se abra la página, busque el código fuente JavaScript para el complemento y, a continuación, seleccione el código y cópielo.
-
Haga clic con el botón derecho en la carpeta de la biblioteca de cliente y haga clic en Crear > Crear archivo. Para el nombre del archivo, escriba el nombre del complemento que está integrando seguido de .js y, a continuación, haga clic en Aceptar. Por ejemplo, si está integrando el complemento getQueryParam, asigne al archivo el nombre getQueryParam.js.
Cuando cree el archivo, se abrirá para editarlo.
-
Pegue el código JavaScript del complemento en el archivo, haga clic en Guardar todo y cierre el archivo.
-
Abra el archivo js.txt desde la carpeta de biblioteca de cliente.
-
En una línea nueva, añada el nombre del archivo que contiene el complemento, por ejemplo, getQueryParam.js. A continuación, haga clic en Guardar todo y cierre el archivo.