Adobe 插件:manageVars

重要

此插件由 Adobe Consulting 团队提供,旨在帮助您从 Adobe Analytics 中获取更多的价值。Adobe 客户关怀团队不提供对此插件的支持,包括安装或疑难解答。如果您需要关于此插件的帮助,请与贵组织的帐户管理员联系。他们可以为您安排与顾问的答疑会,以便您向顾问寻求帮助。

manageVars 插件允许您同时处理多个 Analytics 变量的值。您还可以将值设置为小写,或一次性从多个变量值中删除不必要的字符。如果要一次清除多个变量的值,Adobe 建议您使用此插件。

使用Web SDK或Adobe Analytics扩展安装此插件

Adobe 提供了一个扩展,通过该扩展,您可以使用一些常用插件。

  1. 登录到 Adobe Experience Platform数据收集 使用您的Adobe ID凭据。
  2. 单击所需的标记属性。
  3. 转到扩展选项卡,然后单击目录按钮
  4. 安装并发布常用 Analytics 插件扩展
  5. 如果还没有任何扩展,请使用以下配置创建一个标签为“初始化插件”的规则:
    • 条件:无
    • 事件:核心 - 已加载的库(页面顶部)
  6. 使用以下配置向上述规则添加操作:
    • 扩展:常用 Analytics 插件
    • 操作类型:初始化 manageVar
  7. 保存并发布对上述规则所做的更改。

使用自定义代码编辑器安装此插件

如果您不想使用插件扩展,则可以使用自定义代码编辑器。

  1. 登录到 Adobe Experience Platform数据收集 使用您的Adobe ID凭据。
  2. 单击所需的属性。
  3. 转到扩展选项卡,然后单击 Adobe Analytics 扩展下的​配置​按钮。
  4. 展开使用自定义代码配置跟踪折叠面板,这会显示打开编辑器按钮。
  5. 打开自定义代码编辑器,并将下面提供的插件代码粘贴到编辑窗口中。
  6. 保存并发布对此 Analytics 扩展所做的更改。

使用 AppMeasurement 安装此插件

在实例化(使用 s_gi)Analytics 跟踪对象后,将以下代码复制并粘贴到 AppMeasurement 文件中的任意位置。在您的实施中保留代码的注释和版本号可帮助 Adobe 对任何潜在问题进行疑难解答。

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: manageVars v3.0 (Requires AppMeasurement) */
function manageVars(cb,l,il){var g=cb,c=l,d=il;if("-v"===g)return{plugin:"manageVars",version:"3.0"};var f=function(){if("undefined"!==typeof window.s_c_il)for(var a=0,b;a<window.s_c_il.length;a++)if(b=window.s_c_il[a],b._c&&"s_c"===b._c)return b}();if("undefined"!==typeof f){f.contextData.manageVars="3.0";f.blankVars=function(a){this[a]&&(0>a.indexOf("contextData")?this[a]="":(a=a.substring(a.indexOf(".")+1),this.contextData[a]&&(this.contextData[a]="")))};f.lowerCaseVars=function(a){this[a]&&("events"!==a&&-1===a.indexOf("contextData")?(this[a]=this[a].toString(),0!==this[a].indexOf("D=")&&(this[a]=this[a].toLowerCase())):-1<a.indexOf("contextData")&&(a=a.substring(a.indexOf(".")+1),this.contextData[a]&&(this.contextData[a]=this.contextData[a].toString().toLowerCase())))};f.cleanStr=function(a){function b(a){if("string"===typeof a){for(a=a.replace(/<\/?[^>]+(>|$)/g,"").trim().replace(/[\u2018\u2019\u201A]/g,"'").replace(/\t+/g,"").replace(/[\n\r]/g," ");-1<a.indexOf("  ");)a=a.replace(/\s\s/g," ");return a}return""}this[a]&&"function"===typeof b&&(0>a.indexOf("contextData")?this[a]=b(this[a]):(a=a.substring(a.indexOf(".")+1),this.contextData[a]&&(this.contextData[a]=b(this.contextData[a].toString()))))};f.pt=function(a,b,c,d){if(a&&this[c]){a=a.split(b||",");b=a.length;for(var e,f=0;f<b;f++)if(e=this[c](a[f],d))return e}};if(!f[g])return!1;c=c||"";d=d||!0;var b,e="pageName,purchaseID,channel,server,pageType,campaign,state,zip,events,products,transactionID";for(b=1;76>b;b++)e+=",prop"+b;for(b=1;251>b;b++)e+=",eVar"+b;for(b=1;6>b;b++)e+=",hier"+b;for(b=1;4>b;b++)e+=",list"+b;for(b in f.contextData)e+=",contextData."+b;if(c){if(1==d)e=c.replace("['",".").replace("']","");else if(0==d){c=c.split(",");d=e.split(",");e="";for(x in c)for(y in-1<c[x].indexOf("contextData")&&(c[x]="contextData."+c[x].split("'")[1]),d)c[x]===d[y]&&(d[y]="");for(y in d)e+=d[y]?","+d[y]:""}f.pt(e,",",g,0);return!0}return""===c&&d?(f.pt(e,",",g,0),!0):!1}};
/******************************************** END CODE TO DEPLOY ********************************************/

使用此插件

manageVars 函数使用以下参数:

  • cb(必需,字符串):插件用来处理 Analytics 变量的回调函数的名称。您可以使用 Adobe 函数(如 cleanStr)或者您自己自定义的函数。
  • l(可选,字符串):包含要处理的 Analytics 变量的逗号分隔列表。如果未设置,则将默认包含所有 Adobe Analytics 变量,包括:
    • pageName
    • purchaseID
    • channel
    • server
    • pageType
    • campaign
    • state
    • zip
    • events
    • products
    • transactionID
    • 所有 prop
    • 所有 eVar
    • 所有层级结构变量
    • 所有列表变量
    • 所有上下文数据变量
  • Il(可选,布尔):如果要​**“排除”l 参数中声明的变量列表,而不是要包含这些变量,则将此参数设置为 false。默认为 true

调用此函数将不会返回任何内容。相反,此方法会根据所需的回调函数更改 Analytics 变量的值。

示例调用

示例 1

以下代码…

manageVars("lowerCaseVars");

…会将上述所有变量的值更改为小写版本。但唯有 events 变量例外,因为某些 events 变量(如 scAdd、scCheckout 等)要区分大小写,因此不应将其更改为小写

示例 2

以下代码…

manageVars("lowerCaseVars", "events", false);

…产生的结果与第一个示例基本相同,因为 events 变量默认不用小写。

示例 3

以下代码…

manageVars("lowerCaseVars", "eVar1,eVar2,eVar3,list2");

…将仅更改(例如更改为小写)eVar1、eVar2、eVar3 和 list2 的值

示例 4

以下代码…

manageVars("lowerCaseVars", "eVar1,eVar2,eVar3,list2", false);

…将更改(例如更改为小写)除 eVar1、eVar2、eVar3 和 list2 之外上述所有其他变量的值

示例 5

以下代码…

manageVars("cleanStr");

…将更改上述所有变量的值,包括 events 变量。具体而言,cleanStr 回调函数将对每个变量的值进行如下处理:

  • 删除 HTML 编码
  • 删除值开始和结尾处的空格
  • 将左/右单引号(如 ’)替换为直单引号 (')
  • 将制表符、换行符和回车符替换为空格
  • 将双倍(或三倍及以上)行距均替换为单倍行距

版本历史记录

3.0(2021 年 3 月 19 日)

  • 以上下文数据形式添加了版本号。

2.1(2019 年 1 月 14 日)

  • 修复了 Internet Explorer 11 浏览器的错误。
  • s.cleanStr 进行了更改,现要使用常规 cleanStr 函数。

2.0(2018 年 5 月 7 日)

  • 修正版本(包括对插件的彻底再分析/重写)
  • 添加了 cleanStr 回调函数

在此页面上