Adobe 插件:pt
创建对象:
- 管理员
- 开发人员
pt
插件可对 Analytics 变量列表执行一个函数或方法。例如,您可以选择性地对多个变量运行 clearVars
函数,而无需每次手动调用该函数。有一些其他插件需要此插件代码才能正常运行。如果您不需要同时对多个 Analytics 变量运行特定函数,或者您未使用任何依赖此插件的相关插件,则无需使用此插件。
使用Web SDK或Web SDK扩展安装此插件
尚不支持使用此插件在Web SDK中使用。
使用Adobe Analytics扩展安装此插件
Adobe提供了一个扩展,通过该扩展,您可以将最常用的插件与Adobe Analytics结合使用。
-
使用您的 Adobe ID 凭据登录 Adobe Experience Platform 数据收集。
-
单击所需的标记属性。
-
转到扩展选项卡,然后单击目录按钮
-
安装并发布常用 Analytics 插件扩展
-
如果还没有任何扩展,请使用以下配置创建一个标签为“初始化插件”的规则:
- 条件:无
- 事件:核心 - 已加载的库(页面顶部)
-
使用以下配置向上述规则添加操作:
- 扩展:常用 Analytics 插件
- 操作类型:初始化 pt
-
保存并发布对上述规则所做的更改。
使用自定义代码编辑器安装此插件
如果您不想使用“常用Analytics插件”插件扩展,则可以使用自定义代码编辑器。
- 使用您的 Adobe ID 凭据登录 Adobe Experience Platform 数据收集。
- 单击所需的属性。
- 转到扩展选项卡,然后单击 Adobe Analytics 扩展下的 配置 按钮。
- 展开使用自定义代码配置跟踪折叠面板,这会显示打开编辑器按钮。
- 打开自定义代码编辑器,并将下面提供的插件代码粘贴到编辑窗口中。
- 保存并发布对此 Analytics 扩展所做的更改。
使用 AppMeasurement 安装此插件
在实例化(使用 s_gi
)Analytics 跟踪对象后,将以下代码复制并粘贴到 AppMeasurement 文件中的任意位置。在您的实施中保留代码的注释和版本号可帮助 Adobe 对任何潜在问题进行疑难解答。
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: pt v3.0 */
function pt(l,de,cf,fa){var b=l,d=de,f=cf,g=fa;if("-v"===b)return{plugin:"pt",version:"3.0"};a:{if("undefined"!==typeof window.s_c_il){var a=0;for(var c;a<window.s_c_il.length;a++)if(c=window.s_c_il[a],c._c&&"s_c"===c._c){a=c;break a}}a=void 0}if("undefined"!==typeof a&&(a.contextData.pt="3.0",b&&a[f])){b=b.split(d||",");d=b.length;for(var e=0;e<d;e++)if(c=a[f](b[e],g))return c}};
/******************************************** END CODE TO DEPLOY ********************************************/
使用此插件
pt
函数使用以下参数:
l
(必需,字符串):可对其执行cf
参数中包含的函数的变量列表。de
(可选,字符串):用于分隔l
参数中变量列表的分隔符。默认使用逗号 (,
)。cf
(必需,字符串):包含在 AppMeasurement 对象中且要针对l
参数中所含每个变量而调用的回调函数的名称。fa
(可选,字符串):如果cf
参数中的函数在运行时需要使用其他参数,请在此处包含这些参数。默认为undefined
。
如果回调函数(在 cf
参数中)返回一个值,则调用此函数也将返回一个值。
示例调用
示例 1
以下代码是 getQueryParam 插件的一部分。该代码会针对 URL querystring (fullQueryString) 中包含的每个键值对运行 getParameterValue 帮助程序函数。为了提取每个键值对,必须使用与号“&”拆分 fullQueryString。parameterKey 是指插件尝试从查询字符串中提取的特定查询字符串参数
returnValue = pt(fullQueryString, "&", "getParameterValue", parameterKey)
以上代码行是运行如下所示代码的快捷方法:
var returnValue = "",
parameters = fullQueryString.split("&"),
parametersLength = parameters.length;
for(var i = 0; i < parametersLength; i++)
{
returnValue = getParameterValue(parameters[i], parameterKey);
if(returnValue !== "") break;
}
版本历史记录
3.0(2021 年 3 月 19 日)
- 以上下文数据形式添加了版本号。
2.01(2019 年 9 月 24 日)
- 对代码进行细微更改,以减小代码整体大小。
2.0(2018 年 4 月 17 日)
- 修正版本(重新编译,代码更小)。
- 增加了对 H 代码和 AppMeasurement 的支持。
1.0(2013 年 9 月 23 日)
- 第一版。