Adobe 插件:cleanStr

重要

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

cleanStr 插件可删除或替换字符串中所有不必要的字符,包括 HTML 标记字符、额外的空格、制表符和换行符/回车符。它还会将左/右单引号()替换为直单引号 (')。如果您要从变量值中删除不必要的字符,并且Adobe Experience Platform中的“清理文本”功能无法满足您的实施需求,则Adobe建议使用此插件。 如果收集的数据不包含不必要的字符,或者数据收集UI中的“清理文本”功能足够,则无需使用此插件。

在Adobe Experience Platform中使用标记安装插件

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

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

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

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

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

使用 AppMeasurement 安装此插件

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

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: cleanStr v2.0 (No Prerequisites Required) */
function cleanStr(str){var a=str;if("-v"===a)return{plugin:"cleanStr",version:"2.0"};a:{if("undefined"!==typeof window.s_c_il){var b=0;for(var c;b<window.s_c_il.length;b++)if(c=window.s_c_il[b],c._c&&"s_c"===c._c){b=c;break a}}b=void 0}"undefined"!==typeof b&&(b.contextData.cleanStr="2.0");if("string"===typeof a){a=a.replace(/<\/?[^>]+(>|$)/g,"");a=a.trim();a=a.replace(/[\u2018\u2019\u201A]/g,"'");a=a.replace(/\t+/g,"");for(a=a.replace(/[\n\r]/g," ");-1<a.indexOf("  ");)a=a.replace(/\s\s/g," ");return a}return""}
/******************************************** END CODE TO DEPLOY ********************************************/

使用此插件

cleanStr 方法使用以下参数:

  • str(必需,字符串):用于清理 HTML 编码、额外空格、制表符或其他不必要字符的值。

该方法会返回 str 参数的值,并删除所有不必要的字符。

示例

示例 1

假设以下字符串(其中点代表空格,而箭头代表制表符)

s.eVar1 = "»∙∙this∙∙is∙a∙∙»∙messy»string∙∙∙∙"

运行以下代码时…

s.eVar1 = cleanStr(s.eVar1)

…eVar1 将被设置为等于“this is a messystring”(删除了所有额外空格和所有制表符)

示例 2

如果…

s.eVar1 = "»∙∙this∙∙is∙a∙∙»∙messy»string∙∙∙∙"

…并运行以下代码…

cleanStr(s.eVar1)

…s.eVar1 的最终值仍将为:

"»∙∙this∙∙is∙a∙∙»∙messy»string∙∙∙∙"

单独运行此插件(不将返回值指定给变量)实际上不会“重置”通过 str 参数传入的变量。

版本历史记录

2.0(2021 年 3 月 19 日)

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

1.0(2018 年 4 月 15 日)

  • 第一版。

在此页面上