Show Menu
主题×

Adobe 插件:pt

此插件由 Adobe Consulting 团队提供,旨在帮助您从 Adobe Analytics 中获取更多的价值。Adobe 客户关怀团队不提供对此插件的支持,包括安装或疑难解答。如果您需要关于此插件的帮助,请与贵组织的帐户管理员联系。他们可以为您安排与顾问的答疑会,以便您向顾问寻求帮助。
pt 插件可对 Analytics 变量列表执行一个函数或方法。例如,您可以选择性地对多个变量运行 clearVars 方法,而无需每次手动调用该方法。有一些其他插件需要此插件代码才能正常运行。如果您不需要同时对多个 Analytics 变量运行特定函数,或者您未使用任何依赖此插件的相关插件,则无需使用此插件。

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

Adobe 提供了一个扩展,通过该扩展,您可以使用一些最常用的插件。
  1. 使用您的 Adobe ID 凭据登录 launch.adobe.com
  2. 单击所需的属性。
  3. 转到扩展选项卡,然后单击目录按钮
  4. 安装并发布常用 Analytics 插件扩展
  5. 如果还没有任何扩展,请使用以下配置创建一个标签为“初始化插件”的规则:
    • 条件:无
    • 事件:核心 - 已加载的库(页面顶部)
  6. 使用以下配置向上述规则添加操作:
    • 扩展:常用 Analytics 插件
    • 操作类型:初始化 pt
  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: pt v2.01 */
 s.pt=function(l,de,cf,fa){if(l&&this[cf]){l=l.split(de||",");de=l.length;for(var e,c=0;c<de;c++)if(e=this[cf](l[c],fa))return e}};
/******************************************** 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 = s.pt(fullQueryString, "&", "getParameterValue", parameterKey)

以上代码行是运行如下所示代码的快捷方法:
var returnValue = "",
  parameters = fullQueryString.split("&"),
  parametersLength = parameters.length;
for(var i = 0; i < parametersLength; i++)
{
  returnValue = s.getParameterValue(parameters[i], parameterKey);
  if(returnValue !== "") break;
}

版本历史记录

2.01(2019 年 9 月 24 日)

  • 对代码进行细微更改,以减小代码整体大小

2.0(2018 年 4 月 17 日)

  • 修正版本(重新编译,代码更小)。
  • 增加了对 H 代码和 AppMeasurement 的支持。

1.0(2013 年 9 月 23 日)

  • 第一版。