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/hubspot-forms.js

View on GitHub
/*! HubSpot Forms conversion detection (MIT)
 *  Detects: form submission. Pushes dataLayer event: hubspot_form_submitted
 *  From the conversion-tracking skill in Marketing Skills */
(function () {
  if (window.__ctDetectHubspotForms) return;
  window.__ctDetectHubspotForms = true;
  window.dataLayer = window.dataLayer || [];

  // Updated-editor conversions are keyed by HubSpot's documented conversion
  // ID. Legacy messages use event-object identity because their documented
  // callback payload has no conversion ID.
  var seenConversions = {};
  var seenLegacyEvents = typeof WeakSet === 'function' ? new WeakSet() : [];

  function fireConversion(formId, conversionId, acceptedContext) {
    var id = formId ? String(formId) : '';
    if (typeof conversionId !== 'string' || !conversionId) return false;
    var key = '$' + conversionId;
    if (seenConversions[key]) return false;
    seenConversions[key] = true;
    var handled = false;
    var adapter = window.__ctHubspotMethod2Handler;
    if (typeof adapter === 'function') {
      try {
        handled = adapter({
          formId: id,
          instanceId: acceptedContext && acceptedContext.instanceId || '',
          conversionId: conversionId,
          form: acceptedContext && acceptedContext.form || null
        }) === true;
      } catch (e) {
        handled = false;
      }
    }
    // The push is contained, and a conversion whose push failed is
    // forgotten, so a repeat of HubSpot's event can still count it.
    if (!handled) {
      try {
        window.dataLayer = window.dataLayer || [];
        window.dataLayer.push({ event: 'hubspot_form_submitted', form_id: id });
      } catch (e) {
        delete seenConversions[key];
        return false;
      }
    }
    return true;
  }

  function claimLegacyEvent(event) {
    if (!event || typeof event !== 'object') return false;
    if (seenLegacyEvents && typeof seenLegacyEvents.has === 'function') {
      if (seenLegacyEvents.has(event)) return false;
      seenLegacyEvents.add(event);
      return true;
    }
    if (seenLegacyEvents.indexOf(event) !== -1) return false;
    seenLegacyEvents.push(event);
    return true;
  }

  function releaseLegacyEvent(event) {
    try {
      if (typeof seenLegacyEvents.delete === 'function') { seenLegacyEvents.delete(event); return; }
      var i = seenLegacyEvents.indexOf(event);
      if (i !== -1) seenLegacyEvents.splice(i, 1);
    } catch (e) {}
  }

  // ------------------------------------------------------------
  // Path 1: current forms editor (live-verified)
  // ------------------------------------------------------------
  // HubSpot dispatches this on the .hs-form-frame container and lets it bubble
  // (or on document itself when it cannot find the container), with
  // detail = { formId, instanceId }. It only ever follows a submission
  // HubSpot's server accepted. Listening on document in the capture phase
  // catches both dispatch points and cannot be silenced by page code that
  // stops the event's propagation further down.
  function hubspotFormsApi() {
    return window.HubSpotFormsV4 || window.HubspotFormsV4 || null;
  }

  function handleSubmissionSuccess(event) {
    try {
      var detail = event && event.detail;
      if (!detail || typeof detail.formId !== 'string' || !detail.formId) return;
      if (typeof detail.instanceId !== 'string' || !detail.instanceId) return;
      // When HubSpot's forms API is on the page, the event must name a form
      // instance HubSpot actually rendered here. A stray or malformed event
      // with a made-up instance id is ignored.
      var api = hubspotFormsApi();
      if (!api || typeof api.getFormFromEvent !== 'function') return;
      var form = api.getFormFromEvent(event);
      if (!form || typeof form.getFormId !== 'function' ||
          typeof form.getInstanceId !== 'function' ||
          typeof form.getConversionId !== 'function') return;
      if (form.getFormId() !== detail.formId ||
          form.getInstanceId() !== detail.instanceId) return;
      // HubSpot documents getConversionId as valid after successful
      // submission. It is the stable key for event replay and repeated submits.
      fireConversion(detail.formId, form.getConversionId(), { form: form, instanceId: detail.instanceId });
    } catch (e) {
      // Never throw back into HubSpot's own event dispatch.
    }
  }

  // ------------------------------------------------------------
  // Path 2: legacy forms editor (ported from the production module)
  // ------------------------------------------------------------
  // Legacy forms announce each lifecycle step with a postMessage of
  // { type: 'hsFormCallback', eventName, id, data }. Only 'onFormSubmitted'
  // means the submission was accepted; 'onFormSubmit' also fires for
  // submissions that then fail validation, so it is ignored.
  //
  // The legacy callback payload documents its form ID but not a safe mapping
  // from a cross-origin source WindowProxy to that ID. Accept only the inline
  // same-window callback; cross-origin iframe messages fail closed until a
  // vendor-supported source/form binding can be verified.
  function isTrustedOrigin(event) {
    return !!(event && event.source === window &&
      event.origin === window.location.origin);
  }

  function handleMessage(event) {
    try {
      // Reject an unbound source before even reading its structured-clone data.
      if (!isTrustedOrigin(event)) return;
      var data = event && event.data;
      if (!data || typeof data !== 'object') return;
      if (data.type !== 'hsFormCallback') return;
      if (data.eventName !== 'onFormSubmitted') return;
      var formId = data.id;
      if (typeof formId !== 'string' || !/^[A-Za-z0-9_-]{1,128}$/.test(formId)) return;
      if (!claimLegacyEvent(event)) return;
      // The documented legacy callback runs after persistence, but has no
      // stable conversion ID. The local guard only recognizes replay of this
      // exact MessageEvent object; a distinct event object may be a replay or a
      // new conversion, so cross-event deduplication is not claimed.
      var handled = false;
      var adapter = window.__ctHubspotMethod2Handler;
      if (typeof adapter === 'function') {
        try {
          handled = adapter({ formId: formId, legacyEvent: event }) === true;
        } catch (e) { handled = false; }
      }
      if (!handled) {
        try {
          window.dataLayer = window.dataLayer || [];
          window.dataLayer.push({ event: 'hubspot_form_submitted', form_id: formId });
        } catch (e) {
          releaseLegacyEvent(event);
        }
      }
    } catch (e) {
      // Never throw back into the page's own message handling.
    }
  }

  document.addEventListener('hs-form-event:on-submission:success', handleSubmissionSuccess, true);
  window.addEventListener('message', handleMessage, false);
})();
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