Adobe plug-in: getTimeBetweenEvents

The getTimeBetweenEvents plug-in allows you to track the amount of time between any two Analytics events, including shopping cart and custom events. It is useful in tracking the amount of time it takes for a checkout process to complete, or any other process that you want to measure time. This plug-in is unnecessary if you don’t have any conversion processes that you want to measure how long they take.

Install the plug-in using the Adobe Experience Platform Launch extension

Adobe offers an extension that allows you to use most commonly-used plug-ins.

1. Log in to launch.adobe.com using your AdobeID credentials.
2. Click the desired property.
3. Go to the Extensions tab, then click on the Catalog button
4. Install and publish the Common Analytics Plugins extension
5. If you haven’t already, create a rule labeled “Initialize Plug-ins” with the following configuration:
   • Condition: None
   • Event: Core – Library Loaded (Page Top)
6. Add an action to the above rule with the following configuration:
   • Extension: Common Analytics Plugins
   • Action Type: Initialize getTimeBetweenEvents
7. Save and publish the changes to the rule.

Install the plug-in using Launch custom code editor

If you do not want to use the plug-in extension, you can use the custom code editor.

1. Log in to launch.adobe.com using your AdobeID credentials.
2. Click on the desired property.
3. Go to the Extensions tab, then click the Configure button under the Adobe Analytics extension.
4. Expand the Configure tracking using custom code accordion, which reveals the Open Editor button.
5. Open the custom code editor and paste the plug-in code provided below into the edit window.
6. Save and publish the changes to the Analytics extension.

Install the plug-in using AppMeasurement

Copy and paste the following code anywhere in the AppMeasurement file after the Analytics tracking object is instantiated (using s_gi). Preserving comments and version numbers of the code in your implementation helps Adobe with troubleshooting any potential issues.

/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: getTimeBetweenEvents v2.1 (Requires formatTime and inList plug-ins) */
s.getTimeBetweenEvents=function(ste,rt,stp,res,cn,etd,fmt,bml,rte){var s=this;if("string"===typeof ste&&"undefined"!==typeof rt&&"string"===typeof stp&&"undefined"!==typeof res){cn=cn?cn:"s_tbe";etd=isNaN(etd)?1:Number(etd);var f=!1,g=!1,n=!1, p=ste.split(","),q=stp.split(",");rte=rte?rte.split(","):[];for(var h=s.c_r(cn),k,v=new Date,r=v.getTime(),c=new Date,a=0; a<rte.length;++a)s.inList(s.events,rte[a])&&(n=!0);c.setTime(c.getTime()+864E5*etd);for(a=0;a<p.length&&!f&&(f=s.inList(s.events,p[a]),!0!==f);++a);for(a=0;a<q.length&&!g&&(g=s.inList(s.events,q[a]),!0!==g);++a);1===p.length&&1===q.length&&ste===stp&&f&&g?(h&&(k=(r-h)/1E3),s.c_w(cn,r,etd?c:0)):(!f||1!=rt&&h||s.c_w(cn,r,etd?c:0),g&&h&&(k=(v.getTime()-h)/1E3,!0===res&&(n=!0)));!0===n&&(c.setDate( c.getDate()-1),s.c_w(cn,"",c));return k?s.formatTime(k,fmt,bml):""}};

/* 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 ********************************************/

Use the plug-in

The getTimeBetweenEvents method uses the following arguments:

• ste (required, string): Start timer events. A comma-delimited string of Analytics events to “start the timer”.

• rt (required, boolean): Restart timer option. Set to true if you want to restart the timer every time the events variable contains a start timer event. Set to false if you don’t want the timer to restart when it sees a start timer event.

• stp (required, string): Stop timer events. A comma-delimited string of Analytics events that “stop the timer”.

• res (required, boolean): Reset timer option. Set to true if you want to record the time since the timer started AND reset the timer after it stops. Set to false if you want to record the time but not stop the timer. If set to false, the timer continues to run after the events variable records a stop event.

  TIP

  If you set this argument to false, setting the rte argument below is highly recommended.

• cn (optional, string): The cookie name where the time of the first event is stored. Defaults to "s_tbe".

• etd (optional, integer): The expiration time for the cookie in days. Set to 0 to expire at the end of the browser session. Defaults to 1 day when not set.

• fmt (optional, string): The format of the time that the number of seconds is returned in (defaults to nothing)

  • "s" for seconds
  • "m" for minutes
  • "h" for hours
  • "d" for days
  • When not set, the return value’s format is based on the following rules:
    • Anything less than a minute is rounded to the closest 5 second benchmark. For example, 10 seconds, 15 seconds
    • Anything between a minute and an hour is rounded to the closest 1/2-minute benchmark. For example, 30.5 minutes, 31 minutes
    • Anything between an hour and a day is rounded to the closest quarter-hour benchmark. For example, 2.25 hours, 3.5 hours
    • Anything greater than a day is rounded to the closest day benchmark. For example, 1 days, 3 days, 9 days

• bml (optional, number): The length of the rounding benchmark according to the format of the fmt argument. For example, if the fmt argument is "s" and this argument is 2, the return value is rounded to the closest 2-second benchmark. If fmt argument is "m" and this argument is 0.5, the return value is rounded to the closest half-minute benchmark.

• rte (optional, string): Comma-delimited string of Analytics events that remove or delete the timer. Defaults to nothing.

Calling this method returns an integer representing the amount of time between the start timer event and stop timer event in the desired format.

Example Calls

Example #1

The following code…

s.eVar1 = s.getTimeBetweenEvents("event1", true, "event2", true, "", 0, "s", 2, "event3");

…is configured to behave as follows:

• The timer will start when s.events contains event1.
• The timer will restart every time s.events contains event1
• The timer will stop when s.events contains event2
• The timer will reset (i.e. go to 0 seconds) every time s.events contains event2
• The timer will reset also when either s.events contains event3 OR if the visitor closes his/her browser
• When an actual time between event1 and event2 is recorded, the plug-in will set eVar1 equal to the number of seconds between the two events being set, rounded to the closest 2-second benchmark (e.g. 0 seconds, 2 seconds, 4 seconds, 10 seconds, 184 seconds, etc.)
• If s.events contains event2 before a timer has started, eVar1 won’t be set at all.

Example #2

The following code…

s.eVar1 = s.getTimeBetweenEvents("event1", false, "event2", false, "s_20", 20, "h", 1.5, "event3");

…is configured to behave as follows:

• The timer will start when s.events contains event1.
• The timer will NOT restart every time s.events contains event1, rather the original timer will still keep running
• The timer will NOT stop when s.events contains event2, but the plug-in will record the time since the original event1 setting was recorded
• The timer is stored in a cookie called “s_20”
• The timer will reset only when either s.events contains event3 OR if 20 days has passed since the timer started
• When a time between (the original) event1 and event2 is recorded, the plug-in will set eVar1 equal to the number of hours between the two events being set, rounded to the closest 1 1/2-hour benchmark (e.g. 0 hours, 1.5 hours, 3 hours, 7.5 hours, 478.5 hours, etc.)

Example #3

The following code…

s.eVar1 = s.getTimeBetweenEvents("event1", true, "event2", true);

…will produce similar results to the first example above; however, the value of eVar1 is returned in either seconds, minutes, hours, or days, depending on the final length of the timer. Also, the timer will expire 1 day after it was first set instead of at the time the visitor closes his/her browser.

Version History

2.1 (May 26, 2018)

• Accommodates changes made to the new version of the formatTime plug-in.

2.0 (April 6, 2018)

• Complete rewrite/reanalysis of plug-in.