← Back to Docs

Google Tag Manager

Install FrictaSolv via GTM — no code deploy needed. Takes under 5 minutes.

1. Get Your API Key

Log in to your FrictaSolv dashboard and copy your API key from the Settings page. It starts with frcta_.

Don't have an account yet? Create one free.

2. Create a Custom HTML Tag

  1. Open your GTM container
  2. Go to Tags → New
  3. Click Tag Configuration → Custom HTML
  4. Paste the code below
  5. Under Triggering, select All Pages
  6. Name the tag "FrictaSolv" and save
Custom HTML
<script>
(function(){
  var s = document.createElement('script');
  s.src = 'https://api.frictasolv.com/solv.js';
  s.setAttribute('data-api-key', 'YOUR_API_KEY');
  document.head.appendChild(s);
})();
</script>

Replace YOUR_API_KEY with your actual API key.

3. Publish

  1. Click Submit in the top right of GTM
  2. Add a version name like "Added FrictaSolv tracking"
  3. Click Publish

FrictaSolv will start capturing frustration events within seconds of publish.

4. Verify It's Working

  1. Use GTM's Preview mode to confirm the tag fires
  2. Visit your site and trigger a frustration event (e.g. rage-click a button rapidly)
  3. Check your FrictaSolv dashboard — the event should appear within 10 seconds
Advanced

Use a GTM Variable for the API Key

If you manage multiple environments (staging, production), store the API key as a GTM Constant variable so you can change it without editing the tag.

  1. Go to Variables → New → Constant
  2. Name it FrictaSolv API Key and set the value to your key
  3. Update the tag to reference the variable:
With GTM Variable
<script>
(function(){
  var s = document.createElement('script');
  s.src = 'https://api.frictasolv.com/solv.js';
  s.setAttribute('data-api-key', {{FrictaSolv API Key}});
  document.head.appendChild(s);
})();
</script>

Troubleshooting

Tag fires but no events in dashboard

Check the browser console for errors. Confirm your API key is correct and your organization is active. The SDK logs [FrictaSolv] messages to the console.

Tag doesn't fire

Make sure the trigger is set to "All Pages" and the tag is published (not just saved). Use GTM Preview mode to debug.

Content Security Policy (CSP) errors

If your site uses a strict CSP, add api.frictasolv.com to your script-src and connect-src directives.