自定义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.sitecatalyst.js文件中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设置 ​区域中的免费JavaScript框，您可以将自定义代码添加到Adobe Analytics框架中。

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

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

提供集成到所有JavaScript框架中的自定义Adobe Analytics代码。 当页面的Adobe Analytics框架不包含自定义自由格式的JavaScript时，/libs/cq/analytics/components/sitecatalyst/config.js.jsp脚本生成的JavaScript将附加到analytics.sitecatalyst.js文件中。 默认情况下，该脚本无效，因为它已被注释掉。 该代码还将s.usePlugins设置为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文件的内容)包含以下代码：

如果(s.usePlugins) s.doPlugins(s)

因此，您的JavaScript应将s.usePlugins设置为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插件，则可以从自定义JavaScript的s_doPlugins函数中调用该插件。 以下示例代码在触发Adobe Analytics调用时，以​ "pid" ​的形式从反向链接的URL发送查询字符串作为​ eVar1。

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存储库中，并将它添加到您的客户端库文件夹中。