Adobe 插件：cleanStr

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 日）

• 第一版。