Skip to content

coreyhaines31/marketingskills / skills/conversion-tracking

conversion-tracking

Verified

When the user wants to set up, audit, or fix conversion tracking to Google Ads, Meta, GA4, LinkedIn, and TikTok, or asks why conversions are missing or doubled: GTM, pixels, CAPI, Enhanced Conversions, offline imports. Fire on confirmed success, not the submit click; verify a test conversion arrives; diagnose before changing; offer free paths and disclose partner tools. For tracking plans, see analytics. For attribution, see attribution. For bidding, see ads.

FileKindSize
SKILL.mdskill md29.8 KB
assets/gtm-recipes/README.mdmarkdown6.3 KB
assets/gtm-recipes/detect/detect-acuity-scheduling.jsonconfig7.0 KB
assets/gtm-recipes/detect/detect-cal-com.jsonconfig8.8 KB
assets/gtm-recipes/detect/detect-calendly.jsonconfig7.7 KB
assets/gtm-recipes/detect/detect-contact-form-7.jsonconfig6.3 KB
assets/gtm-recipes/detect/detect-divi-forms.jsonconfig5.0 KB
assets/gtm-recipes/detect/detect-elementor-forms.jsonconfig4.4 KB
assets/gtm-recipes/detect/detect-file-download.jsonconfig5.0 KB
assets/gtm-recipes/detect/detect-fluent-forms.jsonconfig6.8 KB
assets/gtm-recipes/detect/detect-formidable-forms.jsonconfig10.8 KB
assets/gtm-recipes/detect/detect-forminator.jsonconfig5.5 KB
assets/gtm-recipes/detect/detect-framer-forms.jsonconfig6.3 KB
assets/gtm-recipes/detect/detect-generic-ajax-form.jsonconfig7.8 KB
assets/gtm-recipes/detect/detect-gravity-forms.jsonconfig15.4 KB
assets/gtm-recipes/detect/detect-hubspot-forms.jsonconfig9.3 KB
assets/gtm-recipes/detect/detect-jotform.jsonconfig3.8 KB
assets/gtm-recipes/detect/detect-ninja-forms.jsonconfig8.4 KB
assets/gtm-recipes/detect/detect-phone-click.jsonconfig4.6 KB
assets/gtm-recipes/detect/detect-squarespace-forms.jsonconfig18.5 KB
assets/gtm-recipes/detect/detect-tally.jsonconfig10.4 KB
assets/gtm-recipes/detect/detect-thank-you-page.jsonconfig6.2 KB
assets/gtm-recipes/detect/detect-typeform.jsonconfig7.9 KB
assets/gtm-recipes/detect/detect-webflow-forms.jsonconfig5.6 KB
assets/gtm-recipes/detect/detect-wix-forms.jsonconfig9.5 KB
assets/gtm-recipes/detect/detect-wix-scheduling.jsonconfig5.1 KB
assets/gtm-recipes/detect/detect-wpforms.jsonconfig11.1 KB
assets/gtm-recipes/detect/detect-ws-form.jsonconfig4.7 KB
assets/gtm-recipes/event-map.jsonconfig3.1 KB
assets/gtm-recipes/send/ga4.jsonconfig1.8 KB
assets/gtm-recipes/send/google-ads.jsonconfig2.7 KB
assets/gtm-recipes/send/linkedin.jsonconfig3.8 KB
assets/gtm-recipes/send/meta.jsonconfig4.1 KB
assets/gtm-recipes/send/microsoft.jsonconfig4.0 KB
assets/gtm-recipes/send/tiktok.jsonconfig4.4 KB
assets/snippets/README.mdmarkdown17.3 KB
assets/snippets/acuity-scheduling-field.htmlother1.3 KB
assets/snippets/acuity-scheduling.jsscript3.3 KB
assets/snippets/cal-com.jsscript5.5 KB
assets/snippets/calendly.jsscript4.8 KB
assets/snippets/contact-form-7.jsscript3.9 KB
assets/snippets/divi-forms.jsscript2.6 KB
assets/snippets/elementor-forms.jsscript2.0 KB
assets/snippets/file-download.jsscript3.2 KB
assets/snippets/fluent-forms.jsscript4.3 KB
assets/snippets/formidable-forms.jsscript8.2 KB
assets/snippets/forminator.jsscript3.1 KB
assets/snippets/framer-forms.jsscript3.9 KB
assets/snippets/generic-ajax-form.jsscript5.9 KB
assets/snippets/gravity-forms.jsscript12.8 KB
assets/snippets/hubspot-forms.jsscript6.8 KB
assets/snippets/jotform.jsscript1.4 KB
assets/snippets/ninja-forms.jsscript5.9 KB
assets/snippets/phone-click.jsscript2.8 KB
assets/snippets/squarespace-forms.jsscript15.3 KB
assets/snippets/tally.jsscript7.5 KB
assets/snippets/thank-you-page.jsscript4.3 KB
assets/snippets/typeform.jsscript5.0 KB
assets/snippets/webflow-forms.jsscript3.2 KB
assets/snippets/wix-forms.jsscript7.0 KB
assets/snippets/wix-scheduling.jsscript2.7 KB
assets/snippets/wpforms.jsscript8.6 KB
assets/snippets/ws-form.jsscript2.3 KB
evals/evals.jsonconfig21.0 KB
references/audit-playbook.mdmarkdown12.6 KB
references/browser-side.mdmarkdown22.5 KB
references/conversion-moments.mdmarkdown31.3 KB
references/discrepancies.mdmarkdown13.4 KB
references/ecommerce-platforms.mdmarkdown9.9 KB
references/google-ads.mdmarkdown29.6 KB
references/meta.mdmarkdown17.8 KB
references/other-platforms.mdmarkdown19.5 KB
references/server-side.mdmarkdown31.2 KB
scripts/build_recipe.pyscript10.8 KB
scripts/check_recipes.pyexecutablescript3.2 KB

assets/snippets/squarespace-forms.js

View on GitHub
/*! Squarespace Forms conversion detection (MIT)
 *  Detects: form submission. Pushes dataLayer event: squarespace_form_submitted
 *  From the conversion-tracking skill in Marketing Skills */
(function () {
  'use strict';
  // Install once, even if GTM injects this tag more than once on the page.
  if (window.__ctDetectSquarespaceForms) return;
  window.__ctDetectSquarespaceForms = true;
  window.dataLayer = window.dataLayer || [];

  // Ported from a production module (cdn/v1/modules/
  // squarespace-forms.js, measured against a live Squarespace 7.1 site in
  // October 2026). Event only: it never reads what the visitor typed.
  //
  // What Squarespace does:
  // - The Form block renders a React form in the page (no iframe):
  //   .sqs-block-form ... form.react-form-contents[novalidate]. It mounts
  //   after DOMContentLoaded, so submits are caught on document.
  // - There is no check in the browser. Every submit posts
  //   /api/form/FormSubmissionKey then /api/form/SaveFormSubmission, and the
  //   server decides: 204 on success, 400 for a field error, 401 for a failed
  //   reCAPTCHA. A submit is never a conversion on its own.
  // - On success it marks the form (react-form-contents--submitted), shows a
  //   .form-submission-text message and gives the button the class
  //   "success". A form set to redirect leaves for its page about 1.3
  //   seconds after the 204, before that message renders in Chromium.
  // - The Newsletter block posts to the same SaveFormSubmission address, and
  //   that request carries no form identity, so a save only counts for a
  //   form that provably owns it.
  //
  // It fires once per form, on the first confirmed success for an attempt:
  //   1. a success marker that was not there when the attempt started, or
  //   2. the SaveFormSubmission request answering 2xx (read from the
  //      browser's resource timing, where it exposes responseStatus), when
  //      no other form's submit could own that save, or
  //   3. as the page leaves (a redirect form), either of the above.
  // It never fires on a 400 or 401, on a filled anti-spam field, or when it
  // cannot tell which form a save belongs to.

  var EVENT_NAME = 'squarespace_form_submitted';
  var BLOCK_SELECTOR = '.sqs-block-form, [data-sqsp-block="form"], [data-definition-name="website.components.form"]';
  var SAVE_PATH = '/api/form/SaveFormSubmission';
  // Long enough for a visitor to solve a reCAPTCHA picture challenge.
  var WATCH_MS = 180000;

  function now() {
    try {
      if (window.performance && typeof window.performance.now === 'function') return window.performance.now();
    } catch (e) {}
    return 0;
  }

  function hasToken(el, token) {
    if (!el || !el.getAttribute) return false;
    var cls = el.getAttribute('class') || '';
    return (' ' + cls + ' ').indexOf(' ' + token + ' ') !== -1;
  }

  function isConnected(el) {
    try {
      if (typeof el.isConnected === 'boolean') return el.isConnected;
      return !!(el.ownerDocument && el.ownerDocument.documentElement.contains(el));
    } catch (e) {
      return false;
    }
  }

  // ---- Which forms are Squarespace forms ----

  function blockFor(formEl) {
    try {
      return (formEl && formEl.closest) ? formEl.closest(BLOCK_SELECTOR) : null;
    } catch (e) {
      return null;
    }
  }

  function isSquarespaceForm(formEl) {
    if (!formEl || (formEl.tagName || '').toLowerCase() !== 'form') return false;
    return !!blockFor(formEl);
  }

  // The block's own form definition (the site owner's settings, not the
  // visitor's answers): { formId, formName, ... }.
  function formIdentity(block) {
    var id = { formId: '', formName: '' };
    try {
      var script = block && block.querySelector('script.sqs-form-block-context');
      if (!script) return id;
      var parsed = JSON.parse(script.textContent || '{}');
      if (parsed && typeof parsed.formId === 'string') id.formId = parsed.formId;
      if (parsed && typeof parsed.formName === 'string') id.formName = parsed.formName;
    } catch (e) {}
    return id;
  }

  // The honeypot is a text input visitors cannot see or reach (measured id
  // "message-field", inside an aria-hidden wrapper). Squarespace answers a
  // filled one with a 204 and its thank-you message, so a filled honeypot
  // means a bot. Only whether it is empty is checked.
  function honeypotFilled(formEl) {
    try {
      var hp = formEl.querySelector('#message-field');
      if (!hp) return false;
      var wrap = hp.closest && hp.closest('[aria-hidden="true"]');
      if (!wrap || !formEl.contains(wrap)) return false;
      return hp.value !== '';
    } catch (e) {
      return false;
    }
  }

  function submitButtonOf(formEl) {
    try { return formEl.querySelector('button[type="submit"]'); } catch (e) { return null; }
  }

  // ---- Which form a save request belongs to ----

  var seenSaves = [];   // SaveFormSubmission resource entries seen so far
  var claimed = [];     // entries already credited to a form
  var submitLog = [];   // every form submit on the page, with its time

  function pageOrigin() {
    try {
      var l = window.location;
      return l.origin || (l.protocol + '//' + l.host);
    } catch (e) {
      return '';
    }
  }

  // The save request's address is checked for its origin and path only.
  function isSaveEntry(e) {
    var n = (e && e.name) || '';
    var origin = pageOrigin();
    if (!origin || n.indexOf(origin + '/') !== 0) return false;
    return n.slice(origin.length).split(/[?#]/)[0] === SAVE_PATH;
  }

  function prune() {
    // An attempt is watched for WATCH_MS, and submits up to WATCH_MS before
    // it still count when deciding who owns a save.
    var cutoff = now() - 2 * WATCH_MS;
    var i;
    for (i = submitLog.length - 1; i >= 0; i--) if (submitLog[i].at < cutoff) submitLog.splice(i, 1);
    for (i = seenSaves.length - 1; i >= 0; i--) if (seenSaves[i].startTime < cutoff) seenSaves.splice(i, 1);
    if (seenSaves.length > 100) seenSaves.splice(0, seenSaves.length - 100);
    if (claimed.length > 100) claimed.splice(0, claimed.length - 100);
  }

  function allSaveEntries() {
    var all = seenSaves.slice();
    try {
      if (window.performance && typeof window.performance.getEntriesByType === 'function') {
        var buffered = window.performance.getEntriesByType('resource');
        for (var b = 0; b < buffered.length; b++) if (all.indexOf(buffered[b]) === -1) all.push(buffered[b]);
      }
    } catch (err) {}
    var out = [];
    for (var i = 0; i < all.length; i++) if (isSaveEntry(all[i])) out.push(all[i]);
    return out;
  }

  function saveEntriesSince(since) {
    var all = allSaveEntries();
    var out = [];
    for (var i = 0; i < all.length; i++) {
      if (all[i].startTime >= since && claimed.indexOf(all[i]) === -1) out.push(all[i]);
    }
    out.sort(function (x, y) { return x.startTime - y.startTime; });
    return out;
  }

  // A save's owner is ambiguous when another form (a Newsletter block
  // included) was submitted during this attempt. It is also ambiguous when
  // another form was submitted earlier in the watch window and may still be
  // waiting for its save, because a slow reCAPTCHA can hold that save back
  // until after this attempt starts. Each submit gets at most one save, so
  // fewer saves than submits before this attempt means one is outstanding.
  function saveOwnershipAmbiguous(formEl, since, until) {
    var other = false;
    var first = null;
    var submits = 0;
    for (var i = 0; i < submitLog.length; i++) {
      var s = submitLog[i];
      if (s.at > until || s.at < since - WATCH_MS) continue;
      if (s.at >= since) {
        if (s.form !== formEl) return true;
        continue;
      }
      if (s.form !== formEl) other = true;
      submits++;
      if (first === null || s.at < first) first = s.at;
    }
    if (!other) return false;
    var saves = allSaveEntries();
    var answered = 0;
    for (var j = 0; j < saves.length; j++) {
      if (saves[j].startTime >= first && saves[j].startTime < since) answered++;
    }
    return answered < submits;
  }

  function statusOf(entry) {
    var s = entry && entry.responseStatus;
    return (typeof s === 'number' && s > 0) ? s : null;
  }

  // ---- One watcher per form ----

  var watchers = [];
  var firedForms = [];

  function findWatcher(formEl) {
    for (var i = 0; i < watchers.length; i++) if (watchers[i].form === formEl) return watchers[i];
    return null;
  }

  function removeWatcher(w) {
    for (var i = 0; i < watchers.length; i++) if (watchers[i] === w) { watchers.splice(i, 1); return; }
  }

  function dropStaleWatchers(formEl, block) {
    for (var i = watchers.length - 1; i >= 0; i--) {
      var w = watchers[i];
      if (w.form === formEl) continue;
      if (!isConnected(w.form) || (block && w.block === block)) w.cleanup();
    }
  }

  function createWatcher(formEl, block) {
    var scope = (formEl.closest && formEl.closest('.form-wrapper')) || block;
    function markers() {
      var text = false;
      try { text = !!(scope && scope.querySelector('.form-submission-text')); } catch (e) {}
      return {
        submitted: hasToken(formEl, 'react-form-contents--submitted'),
        button: hasToken(submitButtonOf(formEl), 'success'),
        text: text
      };
    }
    var w = {
      form: formEl,
      block: block,
      identity: formIdentity(block),
      armed: false,
      submitAt: 0,
      answered: true,
      done: false,
      timer: null,
      observer: null,
      pagehideArmed: false,
      staleError: false,
      had: markers()
    };

    function redirectConfigured() {
      try { return !!(formEl.getAttribute && formEl.getAttribute('data-success-redirect')); } catch (e) { return false; }
    }

    function cleanup() {
      w.done = true;
      if (w.timer) { try { clearTimeout(w.timer); } catch (e) {} w.timer = null; }
      if (w.observer) { try { w.observer.disconnect(); } catch (e) {} w.observer = null; }
      if (w.pagehideArmed) {
        try { window.removeEventListener('pagehide', onPageHide, true); } catch (e) {}
        w.pagehideArmed = false;
      }
      removeWatcher(w);
    }

    // The push comes first. The form is marked done only once the push went
    // through, so a dataLayer that throws (a broken wrapper) loses nothing,
    // and the next confirmation tries again.
    function fire() {
      if (w.done) return false;
      var payload = { event: EVENT_NAME, form_id: w.identity.formId };
      if (w.identity.formName) payload.form_name = w.identity.formName;
      try {
        window.dataLayer = window.dataLayer || [];
        window.dataLayer.push(payload);
      } catch (e) {
        return false;
      }
      cleanup();
      firedForms.push(formEl);
      return true;
    }

    function domConfirmsSuccess() {
      var m = markers();
      return (m.submitted && !w.had.submitted) || (m.button && !w.had.button) || (m.text && !w.had.text);
    }

    function check() {
      if (w.done || !w.armed) return;
      if (!isConnected(formEl)) { cleanup(); return; }
      if (domConfirmsSuccess()) { fire(); return; }
      if (w.answered) return;
      // A fresh error state on the button is Squarespace refusing this
      // attempt; one left over from an earlier attempt is not.
      var errorShowing = hasToken(submitButtonOf(formEl), 'error');
      if (!errorShowing) w.staleError = false;
      else if (!w.staleError) w.answered = true;
    }

    // A failure in any callback stays inside this listener and never
    // reaches Squarespace's page.
    function onPageHide() {
      try { pageHideCheck(); } catch (e) {}
    }

    function pageHideCheck() {
      if (w.done || !w.armed) return;
      if (!isConnected(formEl)) { cleanup(); return; }
      if (domConfirmsSuccess()) { fire(); return; }
      if (saveOwnershipAmbiguous(formEl, w.submitAt, now())) { cleanup(); return; }
      var entries = saveEntriesSince(w.submitAt);
      var last = entries[entries.length - 1];
      var status = statusOf(last);
      if (status !== null && status >= 200 && status < 300) {
        if (fire()) claimed.push(last);
        else cleanup();
        return;
      }
      cleanup();
    }

    w.refresh = function (submitAt) {
      // A new attempt replaces the old one once the old one was answered
      // (or its save has been seen); a double submit keeps the first.
      if (!w.armed || w.answered || saveEntriesSince(w.submitAt).length > 0) {
        w.submitAt = submitAt;
        w.answered = false;
        w.staleError = hasToken(submitButtonOf(formEl), 'error');
      }
      w.armed = true;
      if (w.timer) { try { clearTimeout(w.timer); } catch (e) {} }
      try { w.timer = setTimeout(cleanup, WATCH_MS); } catch (e) {}
      if (!w.pagehideArmed && redirectConfigured()) {
        try {
          window.addEventListener('pagehide', onPageHide, true);
          w.pagehideArmed = true;
        } catch (e) {}
      }
    };
    w.check = check;
    w.fire = fire;
    w.cleanup = cleanup;
    w.alive = function () { return isConnected(formEl); };
    w.markAnswered = function () { w.answered = true; };

    try {
      if (typeof MutationObserver !== 'undefined' && block) {
        w.observer = new MutationObserver(function () {
          try { check(); } catch (e) {}
        });
        w.observer.observe(block, { childList: true, subtree: true, attributes: true, attributeFilter: ['class'] });
      }
    } catch (e) {}
    watchers.push(w);
    return w;
  }

  // ---- The save request's verdict, from resource timing ----

  function onResourceEntries(list) {
    var entries;
    try { entries = list.getEntries(); } catch (e) { return; }
    for (var i = 0; i < entries.length; i++) {
      var e = entries[i];
      if (!e || !isSaveEntry(e)) continue;
      if (seenSaves.indexOf(e) === -1) { seenSaves.push(e); prune(); }
      var status = statusOf(e);
      if (status === null || claimed.indexOf(e) !== -1) continue;
      var candidates = [];
      for (var j = 0; j < watchers.length; j++) {
        var w = watchers[j];
        if (!w.done && w.armed && !w.answered && w.alive() && e.startTime >= w.submitAt) candidates.push(w);
      }
      if (candidates.length !== 1) continue;
      var c = candidates[0];
      if (saveOwnershipAmbiguous(c.form, c.submitAt, e.startTime)) continue;
      if (status >= 200 && status < 300) {
        if (c.fire()) claimed.push(e);
      } else {
        c.markAnswered();
      }
    }
  }

  // ---- Submits ----

  function handleSubmit(event) {
    try {
      var formEl = event.target;
      if (!formEl || (formEl.tagName || '').toLowerCase() !== 'form') return;
      submitLog.push({ form: formEl, at: now() });
      prune();
      if (!isSquarespaceForm(formEl)) return;
      var block = blockFor(formEl);
      dropStaleWatchers(formEl, block);
      // Squarespace allows one success per page view.
      if (firedForms.indexOf(formEl) !== -1) return;
      if (hasToken(formEl, 'react-form-contents--submitted')) return;
      if (honeypotFilled(formEl)) {
        var old = findWatcher(formEl);
        if (old) old.cleanup();
        return;
      }
      var w = findWatcher(formEl) || createWatcher(formEl, block);
      w.refresh(now());
    } catch (e) {
      // Never throw back into Squarespace's own form handling.
    }
  }

  document.addEventListener('submit', handleSubmit, true);
  try {
    if (typeof PerformanceObserver !== 'undefined') {
      new PerformanceObserver(function (list) {
        try { onResourceEntries(list); } catch (e) {}
      }).observe({ type: 'resource' });
    }
  } catch (e) {}
})();
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall