ConversionRuler Coding Best Practices - Revision history

Admin at 17:01, 27 April 2026

2026-04-27T17:01:06Z

Admin at 16:57, 27 April 2026

2026-04-27T16:57:11Z

Admin at 16:56, 27 April 2026

2026-04-27T16:56:47Z

Admin at 16:54, 27 April 2026

2026-04-27T16:54:59Z

Admin at 16:54, 27 April 2026

2026-04-27T16:54:20Z

Admin at 21:47, 4 February 2026

2026-02-04T21:47:30Z

Admin at 22:56, 30 January 2021

2021-01-30T22:56:55Z

Admin at 22:56, 30 January 2021

2021-01-30T22:56:10Z

Admin at 22:53, 30 January 2021

2021-01-30T22:53:15Z

Admin at 22:50, 30 January 2021

2021-01-30T22:50:18Z

@@ Line 58: / Line 58: @@
   <script>
-  (function (w) {
+  (function (w, q) {
-      w._crq = w._crq || [];
+      (w[q] = w[q] || []).push(function (cr) {
           var timeout = 10; // seconds
           cr.jquery(function ($) {
@@ Line 81: / Line 80: @@
           });
       });
-  }(window));
+  }(window, '_crq'));
   </script>
@@ Line 96: / Line 95: @@
 From a control perspective; issues with tracking forms have issues with false positives - a form submitted but not received by the server due to validation issues:
 * Form submitted, but validation failed in the browser
 * Form submitted, but validation failed on the server
 * Form submitted, validation succeeded on the server
@@ Line 111: / Line 110: @@
 In both cases, the server may do one of three things as a result of the form submission:
 * Return an error (form was NOT submitted)
 * Redirect to another page
 * Display or return success content on the existing page
@@ Line 142: / Line 141: @@
   <script>
-  (function (w) {
+  (function (w, q) {
-      w._crq = w._crq || [];
+      (w[q] = w[q] || []).push(function (cr) {
           cr.data("thank-you-action", "contact");
       });
-  }(window));
+  }(window, '_crq'));
   </script>
-−
 On form page for "newsletter":
   <script>
-  (function (w) {
+  (function (w, q) {
-      w._crq = w._crq || [];
+      (w[q] = w[q] || []).push(function (cr) {
           cr.data("thank-you-action", "newsletter");
       });
-  }(window));
+  }(window, '_crq'));
   </script>
-−
 On thank you page:
   <script>
-  (function (w) {
+  (function (w, q) {
-      w._crq = w._crq || [];
+      (w[q] = w[q] || []).push(function (cr) {
           cr.track(cr.data("thank-you-action") || "no-action", null, cr.data("email"));
       });
-  }(window));
+  }(window, '_crq'));
   </script>
@@ Line 178: / Line 174: @@
 Tracking across domain names has many issues, and is not covered here. In most cases this scenarios occurs where the different domain name will not permit ConversionRuler to be installed.
 The recommendation to handle these types of actions is to record the action on form submit on the parent domain and accept possible false positive forms.
 === Watcher for an element to appear ===
@@ Line 185: / Line 181: @@
   <script>
-  (function (w) {
+  (function (w, q) {
-      w._crq = w._crq || [];
+      (w[q] = w[q] || []).push(function (cr) {
           cr.jquery(function ($) {
               if (cr.URL().path.indexOf("/contact-us/") === 0) {
@@ Line 199: / Line 194: @@
           });
       });
-  }(window));
+  }(window, '_crq'));
   </script>
@@ Line 207: / Line 202: @@
   <script>
-  (function (w) {
+  (function (w, q) {
-      w._crq = w._crq || [];
+      (w[q] = w[q] || []).push(function (cr) {
           cr.watch.push(function () {
               if (cr.URL().path.indexOf("/thank-you-contact/") === 0) {
@@ Line 217: / Line 211: @@
           });
       });
-  }(window));
+  }(window, '_crq'));
   </script>

@@ Line 6: / Line 6: @@
   <script>
-  (function (w, e) {
+  (function (w, q) {
-      w[e] = w[e] || [];
+      w[q] = w[q] || [];
-      w[e].push(function (cr) {
+      w[q].push(function (cr) {
           // ConversionRuler instrumentation goes here
       });

@@ Line 47: / Line 47: @@
 == Watcher patterns ==
-A watcher pattern can use the built-in JavaScript function <code>[https://developer.mozilla.org/en-US/docs/Web/API/Window/setInterval window.setInterval]</code> or use the built-in execution tool for ConversionRuler [[__CR.watchers]]
+A watcher pattern can use the built-in JavaScript function <code>[https://developer.mozilla.org/en-US/docs/Web/API/Window/setInterval window.setInterval]</code> or use the built-in execution tool for ConversionRuler [[__CR.watch]]
 The basic pattern is:
@@ Line 64: / Line 64: @@
           cr.jquery(function ($) {
               var start = 1 * new Date();
-              cr.watchers.push(function () {
+              cr.watch.push(function () {
                   var now = 1 * new Date(),
                       selector = "button[type=submit]";
@@ Line 190: / Line 190: @@
           cr.jquery(function ($) {
               if (cr.URL().path.indexOf("/contact-us/") === 0) {
-                  cr.watchers.push(function () {
+                  cr.watch.push(function () {
                       if ($('#thank-you-message:visible').length) {
                           cr.track("contact", null, cr.data("email"));
@@ Line 210: / Line 210: @@
       w._crq = w._crq || [];
       w._crq.push(function (cr) {
-          cr.watchers.push(function () {
+          cr.watch.push(function () {
               if (cr.URL().path.indexOf("/thank-you-contact/") === 0) {
                   cr.track("contact", null, cr.data("email"));

@@ Line 226: / Line 226: @@
 * [[__CR.URL]]
 * [[__CR.data]]
-* [[__CR.watchers]]
+* [[__CR.watch]]
 * [[_crq]]

@@ Line 47: / Line 47: @@
 == Watcher patterns ==
-A watcher pattern can use the built-in JavaScript function [[window.setInterval]] or use the built-in execution tool for ConversionRuler [[__CR.watchers]]
+A watcher pattern can use the built-in JavaScript function <code>[https://developer.mozilla.org/en-US/docs/Web/API/Window/setInterval window.setInterval]</code> or use the built-in execution tool for ConversionRuler [[__CR.watchers]]
 The basic pattern is:

@@ Line 33: / Line 33: @@
 == When forms are actually loaded ==
-With modern web marketing services, many sites use 3rd-party form collection and analytics tools such as [[HubSpot]], [[Salesforce]], [[ActOn]], [[Gravity Forms]] and related tools.
+With modern web marketing services, many sites use 3rd-party form collection and analytics tools such as [[HubSpot]], [[Salesforce]], [[Gravity Forms]] and related tools.
 rd party tools such as these often have the following types of issues:

@@ Line 27: / Line 27: @@
 # This code is run immediately once ConversionRuler loads (use [[__CR.ready]] and other calls to defer instrumentation as needed)
 # This code will not run if ConversionRuler is not loaded (due to an error on the page or any other issue) as the code is run by ConversionRuler's [[_crq]] functionality.
-# Code is run in isolation from the browser state (although `window` global is always available in the browser)
+# Code is run in isolation from the browser state (although <code>window</code> global is always available in the browser)
 = Instrumentation Tips =

@@ Line 31: / Line 31: @@
 = Instrumentation Tips =
-== When forms are actually located ==
+== When forms are actually loaded ==
 With modern web marketing services, many sites use 3rd-party form collection and analytics tools such as [[HubSpot]], [[Salesforce]], [[ActOn]], [[Gravity Forms]] and related tools.
@@ Line 86: / Line 86: @@
 The above code breaks down as follows:
-# Scan the page for an item of type selector
+# Scan the page for an item of type <code>selector</code>
-# When found, attach a submit handler to any form on the page
+# When found, attach a submit handler to any <code>form</code> on the page
 # Time out after 10 seconds and log a message