Widget
Set up widget analytics

3min
ThroughLine analytics is only supported for direct requests to your custom subdomain (companyname.findahelpline.com), using Google Tag Manager (GTM). If no analytics are required, simply embed the widget.
To enable analytics, you will need to work with your development team to ensure that events being generated by the widget can be consumed by the containing page and sent to your measurement solution.
What events are available?
ThroughLine utilizes the Windows:postMessage method to share event data with the parent page. Below is an example of the event:
JS
windows.parent.postMessage(
  JSON.stringify({ event: 'widget-click-to-call' }), '*'
);
windows.parent.postMessage(
  JSON.stringify({ event: 'widget-click-to-call' }), '*'
);
﻿
The following event types are available:
Text
'widget-click-to-call'
'widget-click-to-emergency-services'
'widget-click-to-helpline-website'
'widget-click-to-online-chat'
'widget-click-to-sms'
'widget-click-to-whatsapp'
'widget-click-to-call'
'widget-click-to-emergency-services'
'widget-click-to-helpline-website'
'widget-click-to-online-chat'
'widget-click-to-sms'
'widget-click-to-whatsapp'
﻿
How do we capture the analytics events?
Add this JavaScript snippet to capture analytics events and push them to your measure solution.
JS
window.addEventListener(
  "message",
  (event) => {
     if (event.origin !== "https://acme.findahelpline.com") return;
     if (event.data.event === 'widget-click-to-call') {
        // Add your code…
     }
  },
  false
);
window.addEventListener(
  "message",
  (event) => {
     if (event.origin !== "https://acme.findahelpline.com") return;
     if (event.data.event === 'widget-click-to-call') {
        // Add your code…
     }
  },
  false
);
﻿
﻿
Updated 23 Feb 2024
Integrate the widget
Sandbox Terms and Conditions (Terms)