Adobe 插件：cleanStr

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

使用 Adobe Experience Platform Launch 扩展安装此插件

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

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

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

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

1. 使用您的 Adobe ID 凭据登录 launch.adobe.com。
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,?lang=zh-Hans"");for(a=a.replace(/[\n\r]/g," ");-1<a.indexOf("  ");)a=a.replace(//s/s/g,?lang=zh-Hans" ");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 日）

• 第一版。