自定义Adobe Analytics框架 customizing-the-adobe-analytics-framework

Adobe Analytics框架可确定与Adobe Analytics一起跟踪的信息。 要自定义默认框架，您可以使用javascript添加自定义跟踪、集成Adobe Analytics插件，以及更改用于跟踪的框架中的常规设置。

关于为框架生成的Javascript about-the-generated-javascript-for-frameworks

当页面与Adobe Analytics框架关联，并且该页面包含 对Analytics模块的引用，则会自动为页面生成analytics.sitecatalyst.js文件。

页面中的Javascript将创建 s_gi对象(s_code.js Adobe Analytics库定义的对象)并为其属性分配值。 对象实例的名称为 s. 本节中介绍的代码示例对此进行了一些参考 s 变量。

以下示例代码与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;
*/

使用自定义Javascript代码自定义框架时，需更改此文件的内容。

配置Adobe Analytics属性 configuring-adobe-analytics-properties

Adobe Analytics中有许多预定义变量可以在框架上进行配置​ 。 ​ charset, cookieLifetime, currencyCode 和 trackInlineStats 变量包含在 常规Analytics设置 列表。

您可以向列表添加变量名称和值。 这些预定义变量和您添加的任何变量将用于配置 s 对象。 以下示例显示了如何 prop10 值属性 CONSTANT 在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";

请按照以下过程将变量添加到列表：

将自定义Javascript添加到Adobe Analytics框架 adding-custom-javascript-to-an-adobe-analytics-framework

在 常规Analytics设置 区域，可将自定义代码添加到Adobe Analytics框架。

您添加的代码会附加到analytics.sitecatalyst.js文件中。 因此，您可以访问 s 变量，这是的实例 s_gi 在中定义的javascript对象 s_code.js. 例如，添加以下代码等效于添加一个名为 prop10 值 CONSTANT，上一节中的示例如下：

s.prop10= 'CONSTANT';

中的代码 analytics.sitecatalyst.js 文件(包括Adobe Analytics的内容) s-code.js 文件)包含以下代码：

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

以下过程演示了如何使用javascript框自定义Adobe Analytics跟踪。 如果您的javascript需要使用Adobe Analytics插件， 集成 到AEM。

以下示例使用通用分隔符“|”按层级顺序连接页面上捕获的数据。

Adobe Analytics框架具有以下配置：

例如，以下值在Adobe Analytics中生成：

为所有Adobe Analytics框架添加全局自定义代码 adding-global-custom-code-for-all-adobe-analytics-frameworks

提供可集成到所有Adobe Analytics框架中的自定义Javascript代码。 页面的Adobe Analytics框架不包含自定义 自由格式javascript，则/libs/cq/analytics/components/sitecatalyst/config.js.jsp脚本生成的javascript将附加到 analytics.sitecatalyst.js 文件。 默认情况下，脚本不起作用，因为它被注释掉。 此代码还会设置 s.usePlugins to false:

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

analytics.sitecatalyst.js文件(包括Adobe Analytics s_code.js文件的内容)中的代码包含以下代码：

if(s.usePlugins)s.doPlugins

因此，您的Javascript应设置 s.usePlugins to true 以便 s_doPlugins 函数。 要自定义代码，请使用您自己的Javascript文件来叠加config.js.jsp文件。 如果您的javascript需要使用Adobe Analytics插件， 集成 到AEM。

在AEM中使用Adobe Analytics插件 using-adobe-analytics-plugins-in-aem

获取Adobe Analytics插件的javascript代码，并将它们集成到AEM的Adobe Analytics框架中。 将代码添加到类别的客户端库文件夹 sitecatalyst.plugins 以便它们可用于您的自定义javascript代码。

例如，如果您将 getQueryParams 插件中，您可以从 s_doPlugins 函数。 以下示例代码在 "pid" 从反向链接的URL作为 eVar1，时触发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会安装以下Adobe Analytics插件，以便默认提供这些插件：

/libs/cq/analytics/clientlibs/sitecatalyst/plugins客户端库文件夹的sitecatalyst.plugins类别中包含这些插件。

请按照以下过程为插件创建客户端库文件夹。 您只需执行一次此过程。 要将插件添加到客户端库文件夹，请使用后续过程。

请按照以下过程获取插件代码，将代码存储在AEM存储库中，并将代码添加到您的客户端库文件夹。