Booking Tools Free basic code Advanced version available

Acuity Scheduling GTM Event Listener

Acuity Scheduling GTM Event Listener
Free code

Free Acuity Scheduling GTM listener code

Copy this into a Custom HTML tag in Google Tag Manager. It pushes acuity_booking to the dataLayer when someone books through Acuity Scheduling.

GTM Custom HTML · Acuity Scheduling
<script>
/* Acuity Scheduling listener by MD Niamul - mdniamul.com
   Fires acuity_booking once per booking. Works with the scheduler
   embedded on your site (iframe) and with GTM added to Acuity's own
   page. Needs the small sender script in Acuity → Custom conversion
   tracking (see the setup steps). */
(function () {
  if (window.__mdnAcuityBasic) return; // tag fired twice: keep one copy
  window.__mdnAcuityBasic = true;

  var CURRENCY = 'USD'; // your Acuity currency (EUR, GBP, CAD, AUD...)
  var ACUITY = /^https://([a-z0-9-]+.)*(acuityscheduling.com|squarespacescheduling.com|as.me)$/i;

  window.dataLayer = window.dataLayer || [];
  var sent = {};

  function seen(id) {
    if (sent[id]) return true;
    sent[id] = true;
    try {
      if (localStorage.getItem('mdn_acuity_' + id)) return true;
      localStorage.setItem('mdn_acuity_' + id, '1');
    } catch (e) {}
    return false;
  }

  function push(b) {
    if (!b || typeof b !== 'object' || b.source !== 'mdn-acuity' || !b.id) return;
    if (seen(String(b.id))) return; // one push per booking, also after a reload
    var value = parseFloat(String(b.price || '0').replace(/[^0-9.-]/g, '')) || 0;
    window.dataLayer.push({
      event: 'acuity_booking',
      transaction_id: String(b.id),
      value: value,
      currency: CURRENCY,
      appointment_type: b.appointmentType || '',
      booking_type: value > 0 ? 'paid' : 'free',
      page_path: window.location.pathname
    });
  }

  // Did the message come from inside an Acuity iframe on this page?
  function fromAcuityFrame(src) {
    var frames = document.getElementsByTagName('iframe');
    for (var i = 0; i < frames.length; i++) {
      if (!ACUITY.test((frames[i].src || '').split('/').slice(0, 3).join('/'))) continue;
      var w = src;
      for (var d = 0; d < 4 && w; d++) {
        if (w === frames[i].contentWindow) return true;
        if (w === window || w === w.parent) break;
        w = w.parent;
      }
    }
    return false;
  }

  // 1) Scheduler embedded on your site
  window.addEventListener('message', function (e) {
    if (!e || typeof e.data !== 'string' || e.data.indexOf('mdn-acuity') === -1) return;
    if (!ACUITY.test(e.origin) && !fromAcuityFrame(e.source)) return;
    var b; try { b = JSON.parse(e.data); } catch (err) { return; }
    push(b);
  }, false);

  // 2) GTM added inside Acuity's custom conversion box (direct booking page)
  window.addEventListener('mdn-acuity-booking', function (e) { push(e && e.detail); }, false);
  if (window.__mdnAcuityBooking) push(window.__mdnAcuityBooking);
})();
</script>

This code is also on GitHub with a README and version history: github.com/mdniamul0/acuity-scheduling-gtm-listener

GTM triggerCustom EventEvent nameacuity_booking
Quick install in 3 steps
  1. In GTM, go to Tags → New → Custom HTML, click Copy code above and paste it in.
  2. Set the trigger to All Pages and save the tag.
  3. Create a Custom Event trigger named acuity_booking, use it on your GA4, Google Ads or Meta tag, then Preview and Publish.
See the full step-by-step guide
Example output

What you’ll see in GTM Preview

After you install the code and send a test entry, this is the data that shows up in GTM. You don’t need to paste it anywhere. Use it to check the listener works and to create Data Layer Variables such as form_id.

Example: dataLayer outputExample only. You don’t paste this anywhere.
{
  event: 'acuity_booking',
  transaction_id: '1512495506',
  value: 85,
  currency: 'USD',
  appointment_type: 'Puppy Training Session',
  booking_type: 'paid',
  page_path: '/book/'
}
Step by step

How to set up the Acuity Scheduling listener in GTM

How to install the free Acuity Scheduling listener

Acuity needs two small pieces: a sender inside Acuity and a listener in Google Tag Manager. Together they work when the scheduler is embedded on your website and when clients book on Acuity’s own page.

  1. Add the sender in Acuity. In Acuity click Integrations, find Custom conversion tracking, click Set up, paste the sender below into the HTML tracking code box and click Save settings. Remove any older tracking code in that box first.
  2. Add the listener to GTM. In Google Tag Manager go to Tags → New → Custom HTML, paste the free listener code from this page and set the trigger to All Pages. Change CURRENCY at the top if you don’t charge in USD.
  3. Booking on Acuity’s own page (not embedded)? Paste your normal GTM container snippet in the same Acuity box, above the sender, and add the listener tag to that container too. Embedded schedulers don’t need this step.
  4. Create the trigger. Go to Triggers → New → Custom Event and type acuity_booking. Add Data Layer Variables for transaction_id, value, currency, appointment_type and booking_type.
  5. Add your conversion tags. Paid bookings: a GA4 purchase event with transaction_id, value and currency, and a Google Ads conversion with the same value. Free bookings: a GA4 generate_lead event. Use booking_type (paid or free) to split them.
  6. Test and publish. Open GTM Preview, book a test appointment, check that acuity_booking shows up once with the right price, and publish your container. Cancel the test booking in Acuity.

Sender code for Acuity (Custom conversion tracking box)

<script type="text/plain" id="mdn-acuity-data">
id=%id%
price=%price%
type=%type%
appointmentType=%appointmentType%
</script>
<script>
/* Acuity booking sender (free version) by MD Niamul - mdniamul.com
   Paste in Acuity: Integrations → Custom conversion tracking → HTML tracking code.
   Acuity fills the %...% values above; quotes in names cannot break this code. */
(function () {
  var el = document.getElementById('mdn-acuity-data');
  if (!el) return;
  var b = { source: 'mdn-acuity', version: 1 };
  var tmp = document.createElement('textarea');
  var rows = el.textContent.split(/\r?\n/);
  for (var i = 0; i < rows.length; i++) {
    var at = rows[i].indexOf('=');
    if (at < 1) continue;
    tmp.innerHTML = rows[i].slice(at + 1);
    var val = tmp.value.trim();
    b[rows[i].slice(0, at).trim()] = /^%[A-Za-z]+%$/.test(val) ? '' : val;
  }
  if (!b.id) return; // placeholders not filled: not a real booking
  var msg = JSON.stringify(b);
  // 1) Embedded on your site: send it up to the page that holds the scheduler
  try { if (window.top !== window.self) window.top.postMessage(msg, '*'); } catch (e) {}
  // 2) Direct Acuity page with GTM pasted in this box: hand it to GTM here
  var top = '';
  try { var a = window.location.ancestorOrigins; top = a && a.length ? a[a.length - 1] : ''; } catch (e) {}
  if (!top || /(acuityscheduling|squarespacescheduling)\.com$|\.as\.me$/.test(top)) {
    window.__mdnAcuityBooking = b;
    try { window.dispatchEvent(new CustomEvent('mdn-acuity-booking', { detail: b })); } catch (e) {}
  }
})();
</script>

Want the full ad setup? Read my guide on Google Ads Enhanced Conversions for Acuity Scheduling. If you’d rather have it set up for you, see my Google Ads tracking specialist page and my server-side tracking service.

Compare

Basic vs advanced Acuity Scheduling listener

The free code tells GTM that a lead happened. The advanced code tells your ad platforms who the lead is and where they came from.

What you getBasic FreeAdvanced Paid
Fires only on a successful submit or bookingYesYes
Form or platform ID in the dataLayerYesYes
UTM source, medium, campaign, term and contentNoYes
Ad click IDs (gclid, wbraid, gbraid, fbclid, ttclid, msclkid)NoYes
SHA-256 hashed email, phone and nameNoYes
First-party cookies (_fbp, _fbc, _ga, _gcl_aw)NoYes
Device, browser and visitor locationNoYes
event_id for Pixel and CAPI deduplicationNoYes
Ready for Google Ads Enhanced Conversions and Meta CAPINoYes
Install help from MD NiamulNoYes
Advanced version

Get the advanced Acuity Scheduling listener

Built for agencies and brands that run paid ads. Every lead carries the data that Meta, Google Ads, TikTok and GA4 need to match the person and credit the right campaign.

Data it collects

  • Client email from the Acuity booking, plain and SHA-256 hashed, plus first name, last name and phone when your Acuity account fills them
  • Booking ID, price as a number, currency and paid or free, ready for GA4 purchase and Google Ads conversion value
  • A GA4 ecommerce object with the appointment as the item for paid bookings, packages and gift certificates
  • Appointment type, calendar (staff or location), appointment date and time, and appointment or order
  • Works with the scheduler embedded on your site and with GTM inside the Acuity box
  • One push per booking ID, also after a reload, and nothing from fake or unfilled messages
  • Traffic source, medium and campaign from UTM values, click IDs or the referrer
  • 17 ad click IDs: gclid, gbraid, wbraid, dclid, fbclid, ttclid, msclkid, li_fat_id and more
  • First-party cookies: _ga, _gid, _gcl_au, _fbp, _fbc, _uetsid, _uetvid and _ttp
  • Visitor IP, country, region, city and postal code, with two backup providers
  • A unique event_id so Pixel and Conversions API bookings count once
  • GA4 client_id, session_id and a stable external_id
  • Consent switch: click IDs, IP and location are only collected after consent

What it fixes

  • Higher Meta Event Match Quality. More matching keys (hashed email, phone, fbp, fbc, IP and browser) on every Lead event.
  • More Enhanced Conversions matches. Google Ads gets hashed user data with each conversion, not just a count.
  • Correct attribution. UTM values and click IDs are saved with each lead, so you know which ad and keyword brought it.
  • Server-side ready. One clean event with an event_id that works with Meta CAPI, TikTok Events API and server-side GTM.
Pricing

Pick how you want it

One-time price. Start with the code, or let me set everything up for you.

$0
Free basic codeFires the event when the form is sent or the call is booked. Copy it from any listener page or from GitHub.
Get the free code →

Advanced code

You install it yourself

$89$100one-time
  • Advanced listener code, licensed to you
  • PDF setup guide: variables, triggers and tags
  • GTM import file: tag, trigger and variables in one go
  • Step-by-step setup video in your client portal
  • Free updates when the platform changes
Most popular

Code + setup call

We set it up together

$179$200one-time
  • Everything in Advanced code
  • 30-minute setup help on WhatsApp or a booked call
  • I check your GTM Preview and fix what does not fire
  • GA4, Google Ads and Meta tags explained step by step

Done for you: GA4 + Google Ads

I install and test it

$299$350one-time
  • Everything in Advanced code
  • I install the listener in your GTM
  • GA4 key event with the lead or booking details
  • Google Ads conversion with Enhanced Conversions
  • Tested in GTM Preview, GA4 DebugView and Google Ads

Done for you: full server-side

Browser + server tracking

$449$500one-time
  • Everything in GA4 + Google Ads
  • Meta Pixel + Meta Conversions API with event_id deduplication
  • Server-side GTM on Stape.io
  • Consent Mode v2 check
  • Tested in Meta Test Events and GA4 DebugView

Stape.io plan paid separately

Need a different kind of tracking?The packages above are for GTM event listeners. I also set up ChatGPT Ads conversions, Meta CAPI, TikTok Events API, Microsoft and LinkedIn Ads, offline CRM conversions (HubSpot, GoHighLevel, Salesforce), Shopify and WooCommerce server-side tracking, and Looker Studio reports.

Server-side: Server-side tracking runs on Stape.io. The Stape plan is not included: you pay Stape directly (they have a free plan for small sites). I set it up on your account. Get Stape (global) · Stape EU server

One-time prices in USD. You pay me directly and get an invoice in your client portal.

Not sure which one fits? Message me and I will tell you what you need.

Already bought the advanced code? Get it in your client portal.

FAQ

Acuity Scheduling listener: common questions

Does it work when Acuity is embedded on my website?

Yes, that is the best setup. The sender in Acuity's Custom conversion tracking box sends the booking to your page, and the listener checks it came from the Acuity iframe before it fires.

What if clients book on Acuity's own page?

Paste your GTM container snippet in the same Acuity box and add the listener to it. The booking is tracked, but GA4 sees it as a new visit on Acuity's domain, so ad attribution is weaker. Embed the scheduler when you can.

Can I track paid bookings with revenue and free bookings as leads?

Yes. Every event has value, currency and booking_type (paid or free). Send paid ones as a GA4 purchase with transaction_id and value, and free ones as generate_lead.

How do I get the advanced version?

Message me on WhatsApp. After payment I add it to your client portal with the code, a setup video, a PDF guide and a GTM import file.

Is the Acuity Scheduling listener code really free?

Yes. The basic code on this page is free to copy and use on your own or your clients’ sites. It fires the acuity_booking event when the Acuity Scheduling form is sent.

What is the difference between the basic and advanced version?

The basic version only tells GTM that a lead happened. The advanced version also sends UTM values, ad click IDs, hashed email and phone, first-party cookies, device and location data and an event_id, so Meta CAPI, Google Ads Enhanced Conversions and GA4 get much better data.

How do I get the advanced version?

Message me on WhatsApp, book a call or use the contact form. It is a paid, one-time purchase, and I can install it for you if you like.

Do I need to change my form?

No. The listener runs inside Google Tag Manager and listens for the form’s own success signal. You don’t need to edit the form or your theme.

🚀 Need Help With Advanced Acuity Scheduling Tracking Setup?

💬 Want this implemented without mistakes?

I’ve completed 850+ projects for 600+ businesses and 15+ agencies, helping clients generate $11M+ in revenue with accurate client-side & server-side tracking and business automation.

⮏ My core services include:

⨭ GoHighLevel Automation — build CRM pipelines, WhatsApp automation, AI voice workflows & automated follow-ups end-to-end.
⨭ AI Agent Automation — deploy AI chatbots & agents for 24/7 lead qualification and support.
⨭ Paid Ads Management — Google Ads, Meta Ads.
⨭ Full Stack SEO/GEO/AEO Manager.
⨭ CRO-Focused Web Development — Landing Pages on WordPress, Shopify, Wix, Squarespace.
⨭ Google Tag Manager (GTM) — manage data layers & (Marketing platform Tag, Trigger & Variables).
⨭ Custom Code by GTM — HTML, CSS & JavaScript for advanced marketing platform tracking.
⨭ Server-Side Tracking — recover data lost to ITP & ad blockers (Official Stape Partner).
⨭ Google Analytics 4 (GA4) — visualize customer journeys.
⨭ Multi-Channel CAPI — Facebook, TikTok, Pinterest & Snapchat Conversion API & Klaviyo email marketing tools.
⨭ Third Party Checkout Conversion Tracking — Shopify, Stripe, GoKwik, Shiprocket, PayPal or more.
⨭ Google Consent Mode (GCM) — maintain GDPR compliance.
⨭ Marketing Automation — streamline workflows (Zapier/n8n/Make).
⨭ CRM Conversion Tracking — link offline sales to ads.
⨭ Tag Management — GTM & Third-Party Checkout Tracking.
⨭ Offline & CRM Tracking — HubSpot, Salesforce, Zoho, Pipedrive, Odoo, Webhook & Sheet.
⨭ Advanced Analytics — GA4, Google Looker Studio & BigQuery (SQL) for deep data visualization.

If you want your Acuity Scheduling Tracking done right the first time, message me.