Fathom events

[carstenjaksch]

I have added an easy way to track Fathom events. Maybe this is something for you:

    {{ if seo:use_fathom }}
        <script src="https://cdn.usefathom.com/script.js" site="{{ seo:fathom }}" defer></script>

        {{ if seo:fathom_events }}
            <script>
                document.addEventListener('DOMContentLoaded', function() {
                    if (typeof fathom !== 'undefined') {
                        {{ seo:fathom_events }}
                    }
                });

                function trackEvent(name, selector, eventName = 'click', value = 0) {
                    const element = document.querySelector(selector);

                    element?.addEventListener(eventName, function(event) {
                        fathom.trackEvent(name, {
                            _value: value,
                        });
                    }, { once: true });
                }
            </script>
        {{ /if }}
    {{ /if }}

Additionally, a code field is added to the CP.

This is how the end result looks like:

Only thing missing is a hint about the trackEvent function.

[robdekort]

Hey thanks for sharing. This might be helpful for others who want (and trust) their marketers to be able to add events from the CP and not in the templates.

[carstenjaksch]

It is easier for developers too, if they have a "default" way of doing Fathom events in Peak.

They don't need to invest time into testing how the best approach for adding Fathom events would look like. And it adds a nice API, I think.

For marketers: That's where permissions come into play.

The actual "default" approach is surely discussable, but could be worth it.

[robdekort]

I’m sorry, but this is not something I’m interested in adding, maintaining and documenting. Folks are gonna want this for other analytics tools as well. Personally I add events like this to my templates under a retainer.

[carstenjaksch]

No worry, I will use this in my fork. 👍

[robdekort]

You could also create your own starter kit you can install post installing peak. Probably easier to maintain.

[carstenjaksch]

Yeah I had a look into the docs on creating a starter kit. Will tackle that if necessary. Thanks!