Adobe 插件：getTimeToComplete

getTimeToComplete 插件可跟踪用户在网站上完成某个流程所需的时间。“时钟”在调用 start 操作时开始，并在调用 stop 操作时结束。如果网站上的某个工作流程需要花一些时间才能完成，并且您希望了解访客完成该工作流程所用的时间，Adobe 建议使用此插件。如果网站上的工作流程需要很短时间（少于 3 秒）即可完成，则无需使用此插件，因为可测量的最小时间粒度为 1 秒。

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

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

1. 使用您的 Adobe ID 凭据登录 launch.adobe.com。
2. 单击所需的属性。
3. 转到扩展选项卡，然后单击目录按钮
4. 安装并发布常用 Analytics 插件扩展
5. 如果还没有任何扩展，请使用以下配置创建一个标签为“初始化插件”的规则：
   • 条件：无
   • 事件：核心 - 已加载的库（页面顶部）
6. 使用以下配置向上述规则添加操作：
   • 扩展：常用 Analytics 插件
   • 操作类型：初始化 getTimeToComplete
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: getTimeToComplete v3.1 (Requires formatTime and inList plug-ins) */
s.getTimeToComplete=function(sos,cn,exp){sos=sos?sos.toLowerCase():"start";if("stop"===sos||"start"===sos){cn=cn?cn:"s_gttc";exp=exp?exp:0;var s=this,d=s.c_r(cn),e=new Date;if("start"===sos&&!d)s.c_w(cn,e.getTime(),exp?new Date(e.getTime()+864E5*exp):0);else if("stop"===sos&&d)return sos=Math.round((e.getTime()-d)/1E3),s.c_w(cn,"",0),s.formatTime(sos)}};

/* Adobe Consulting Plugin: formatTime v1.1 (Requires inList plug-in) */
s.formatTime=function(ns,tf,bml){var s=this;if(!("undefined"===typeof ns||isNaN(ns)||0>Number(ns))){if("string"===typeof tf&&"d"===tf||("string"!==typeof tf||!s.inList("h,m,s",tf))&&86400<=ns){tf=86400;var d="days";bml=isNaN(bml)?1:tf/(bml*tf)} else"string"===typeof tf&&"h"===tf||("string"!==typeof tf||!s.inList("m,s",tf))&&3600<=ns?(tf=3600,d="hours", bml=isNaN(bml)?4: tf/(bml*tf)):"string"===typeof tf&&"m"===tf||("string"!==typeof tf||!s.inList("s",tf))&&60<=ns?(tf=60,d="minutes",bml=isNaN(bml)?2: tf/(bml*tf)):(tf=1,d="seconds",bml=isNaN(bml)?.2:tf/bml);ns=Math.round(ns*bml/tf)/bml+" "+d;0===ns.indexOf("1 ")&&(ns=ns.substring(0,ns.length-1));return ns}};

/* Adobe Consulting Plugin: inList v2.1 */
s.inList=function(lv,vtc,d,cc){if("string"!==typeof vtc)return!1;if("string"===typeof lv)lv=lv.split(d||",");else if("object"!== typeof lv)return!1;d=0;for(var e=lv.length;d<e;d++)if(1==cc&&vtc===lv[d]||vtc.toLowerCase()===lv[d].toLowerCase())return!0;return!1};
/******************************************** END CODE TO DEPLOY ********************************************/

使用此插件

getTimeToComplete 方法使用以下参数：

• sos（可选，字符串）：要启动计时器时设置为 "start"。要停止计时器时设置为 "stop"。默认为 "start"。
• cn（可选，字符串）：用于存储开始时间的 Cookie 的名称。默认为 "s_gttc"。
• exp（可选，整数）：Cookie（和计时器）的过期时间（以天为单位）。默认值为 0，表示将在浏览器会话结束时过期。

调用此方法将返回一个字符串，其中包含从 "start" 操作到 "stop" 操作所用的时间（天数、小时数、分钟数和/或秒数）。

示例调用

示例 1

使用此类调用可确定从访客开始进入结帐流程到完成购买所用的时间。

访客开始结帐时启动计时器：

if(s.events.indexOf("scCheckout") > -1) s.getTimeToComplete("start");

当访客完成购买时停止计时器，并将 prop1 设置为停止时间与开始时间之间的时间差：

if(s.events.indexOf("purchase") > -1) s.prop1 = s.getTimeToComplete("stop");

s.prop1 将捕获完成购买流程所需的时间

示例 2

如果要同时运行多个定时器（以测量不同的进程），您需要手动设置 cn Cookie 参数。例如，如果要测量完成购买所需的时间，您应设置以下代码…

if(s.inList(s.events, "scCheckout")) s.getTimeToComplete("start", "gttcpurchase");
if(s.inList(s.events, "purchase")) s.prop1 = s.getTimeToComplete("start", "gttcpurchase");

…但是，如果您还想同时测量填写注册表单所需的时间，您还应运行以下代码：

if(s.inList(s.events, "event1")) s.getTimeToComplete("start", "gttcregister", 7);
if(s.inList(s.events, "event2")) s.prop2 = s.getTimeToComplete("stop", "gttcregister", 7);

在第二个示例中，event1 用于捕获注册流程（由于某些原因，可能需要长达 7 天时间才能完成）的开始，event2 用于捕获注册流程的结束。s.prop2 将捕获完成注册流程所需的时间

版本历史记录

3.1（2019 年 9 月 30 日）

• 添加了要求第一个参数中的值只能为“start”或“stop”的逻辑。传入的所有其他值都会阻止插件运行。
• 已将 inList 2.0 插件更新为 inList 2.1。

3.0（2018 年 8 月 23 日）

• 已将 formatTime v1.0 插件更新为 formatTime v1.1。

3.0（2018 年 4 月 17 日）

• 修正版本（重新编译，代码更小）。
• 若干小错误修复。

2.0（2016 年 6 月 21 日）

• 消除了对 p_fo 插件的依赖性。
• 增加了与 H 代码和 AppMeasurement 的兼容性。
• 添加了控制台日志记录。