Tracking events for ad conversions

A custom JavaScript event is fired every time a form submission is sent and when a customer adds a product to cart. You can use these events to track Google Ads and Facebook conversions, send data to your CRM, or trigger any custom scripts on your storefront.

List of events

• Add-to-cart events use signCustomiserProductAddedToCart

• Custom design form submission events use signCustomiserFormSubmitted

• Quote form submission events use signCustomiserQuoteSubmitted

How to listen to these events

Add this JavaScript snippet to your storefront theme:

document.addEventListener("signCustomiserProductAddedToCart", function(e) {  console.log(e.detail);}, false);

Add-to-cart event detail

{  customiserId: "25",  cart: [ ... ],  domain: "your-store.myshopify.com",  adClickIds: {    gclid: "CjwKCAjw7p6aBhAoBhAAEiwA..."  }}

Form submission event detail

{  customiserId: "25",  formId: 1241,  data: [    {      fieldId: "abc123",      label: "First name",      value: "Jane"    }  ],  domain: "your-store.myshopify.com",  adClickIds: {    gclid: "CjwKCAjw7p6aBhAoBhAAEiwA..."  }}

The formId identifies which form was submitted. Each item in the data array includes a fieldId that you can use to map fields to your CRM instead of matching by label text.

Google Ads click ID tracking

All three events now include an adClickIds object when a customer arrived via a Google Ad. This object can contain:

• gclid — the standard Google Ads click identifier

• gbraid — used in mobile and privacy-restricted scenarios

• wbraid — used for cross-device and cookie-less attribution

The field will be null If the customer did not arrive via a Google Ad.

Here is an example of how you can capture the click ID and use it for conversion tracking:

document.addEventListener("signCustomiserProductAddedToCart", function(e) {  var gclid = e.detail.adClickIds && e.detail.adClickIds.gclid;  if (gclid) {    // Example: send to Google Ads as a conversion    gtag("event", "conversion", {      send_to: "AW-XXXXXXXXX/XXXXXXX",      transaction_id: gclid    });  }}, false);

If you want to send click IDs to your CRM for offline conversion tracking, see our Send Google Ads click IDs to your CRM guide for the full webhook-based workflow.