自定义Adobe Analytics框架

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

关于为框架生成的JavaScript

当页面与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属性

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";

请按下列步骤将变量添加到列表中：

1. 在Adobe Analytics框架页面上，展开 常规Analytics设置 区域。

2. 在变量列表下方，单击添加项目以向列表添加新变量。

3. 在左侧单元格中，输入变量的名称，例如 prop10.

4. 在右侧列中，输入变量的值，例如 CONSTANT.

5. 要删除变量，请单击变量旁边的(-)按钮。

将自定义JavaScript添加到Adobe Analytics框架

中的free-from JavaScript框 常规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 file)包含以下代码：

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

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

1. 将以下JavaScript代码添加到框中，以便 s.doPlugins 执行：

   s.usePlugins=true;
   function s_doPlugins(s) {
       //add your custom code here
   }
   s.doPlugins=s_doPlugins;
   

   注意

   如果您要在Adobe Analytics调用中发送已自定义的变量，而这些变量无法通过基本拖放界面或通过Adobe Analytics视图中的内联JavaScript完成，则需要此代码。

   如果自定义变量在s_doPlugins函数之外，它们将在Adobe Analytics调用中作为*undefined *发送

2. 将您的JavaScript代码添加到 s_doPlugins 函数。

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

Adobe Analytics框架具有以下配置：

• 此 prop2 Adobe Analytics变量已映射到 pagedata.sitesection 站点属性。

• 此 prop3 Adobe Analytics变量已映射到 pagedata.subsection 站点属性。

• 以下代码将添加到免费JavaScript框中：

  s.usePlugins=true;
   function s_doPlugins(s) {
   s.prop1 = s.prop2+'|'+s.prop3;
   }
   s.doPlugins=s_doPlugins;
  

• 当访问使用框架的网页时（或在编辑模式下重新加载或预览页面），将执行对Adobe Analytics的调用。

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

为所有Adobe Analytics框架添加全局自定义代码

提供集成到所有Adobe Analytics框架中的自定义JavaScript代码。 当页面的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。

1. 在CRXDE Lite中，创建/apps/cq/analytics/components文件夹结构：

   1. 右键单击/apps文件夹，然后单击“创建”>“创建文件夹”。
   2. 指定 cq 作为文件夹名称，然后单击“确定”。
   3. 同样，创建 analytics 和 components 文件夹。

2. 右键单击 components 之前创建的文件夹，然后单击“创建”>“创建组件”。 指定以下属性值：

   • 标签: sitecatalyst
   • 标题: sitecatalyst
   • 超级类型: /libs/cq/analytics/components/sitecatalyst
   • 组: hidden

3. 反复单击“Next（下一步）” ，直到启用“OK（确定）”按钮，然后单击“OK（确定）”。

   sitecatalyst组件包含自动创建的sitecatalyst.jsp文件。

4. 右键单击sitecatalyst.jsp文件，然后单击删除。

5. 右键单击sitecatalyst组件，然后单击“创建”>“创建文件”。 指定名称 config.js.jsp 然后单击“确定”。

   将自动打开config.js.jsp文件以进行编辑。

6. 将以下文本添加到文件中，然后单击“全部保存”：

   <%@page session="true"%>
   /* Plugin Config */
   s.usePlugins=true;
   function s_doPlugins(s) {
       //add your custom plugin code here
   }
   s.doPlugins=s_doPlugins;
   

   现在，对于使用Adobe Analytics框架的所有页面，/apps/cq/analytics/components/sitecatalyst/config.js.jsp脚本生成的JavaScript代码将插入analytics.sitecatalyst.js文件中。

7. 添加要在中执行的JavaScript代码 s_doPlugins 函数，然后单击“全部保存”。

在AEM中使用Adobe Analytics插件

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

例如，如果您将 getQueryParams 插件，则可以从以下位置调用该插件： s_doPlugins 自定义JavaScript函数。 以下示例代码在中发送查询字符串 "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插件，以便默认情况下可以使用它们：

• getQueryParam()
• getPreviousValue()
• split()

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

使用以下过程可为插件创建客户端库文件夹。 您只需执行该过程一次。 要向客户端库文件夹添加插件，请使用以下步骤。

1. 在Web浏览器中，打开CRXDE Lite。 (http://localhost:4502/crx/de)

2. 右键单击/apps/my-app/clientlibs文件夹，然后单击“创建”>“创建节点”。 输入以下属性值，然后单击“确定”：

   • 名称：客户端库文件夹的名称，如my-plugins

   • 类型：cq：ClientLibraryFolder

3. 选择您创建的客户端库文件夹，然后使用右下方的属性栏添加以下属性：

   • 名称：类别
   • 类型：字符串
   • 值： sitecatalyst.plugins
   • 多个：已选定

   在“编辑”窗口中单击“确定”以确认属性值。

4. 右键单击您创建的客户端库文件夹，然后单击“创建”>“创建文件”。 对于文件名，请键入js.txt ，然后单击“确定”。

5. 单击全部保存。

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

1. 登录 sc.omniture.com 使用您的Adobe Analytics帐户。

2. 在登陆页面上，转到“帮助”>“帮助主页”。

3. 在左侧的目录中，单击“Implementation Plug-ins（实施插件）”。

4. 单击要添加插件的链接，在打开页面时，找到插件的JavaScript源代码，然后选择该代码并复制它。

5. 右键单击您的客户端库文件夹，然后单击“创建”>“创建文件”。 对于文件名，键入要集成的插件的名称，后跟.js，然后单击“确定”。 例如，如果要集成getQueryParam插件，请将文件命名为getQueryParam.js。

   创建文件时，将打开文件以进行编辑。

6. 将插件JavaScript代码粘贴到文件中，单击“全部保存”，然后关闭该文件。

7. 从客户端库文件夹中打开js.txt文件。

8. 在新行中，添加包含插件的文件的名称，例如getQueryParam.js。 然后，单击“全部保存”并关闭文件。

Business.Adobe.com 资源

Automated Onboarding Personalized Experiences Content Intelligence Mobile Forms Version History Digital Asset Management