Google Analytics Extension

Google tag injection through a page head hook.

What It Provides

webifier.analytics.google uses a head hook to inject the Google tag when measurement_id is configured. It does not render a visible section.

Configuration YAML

config:
  webifier:
    extensions:
      analytics:
        uses: webifier.analytics.google
        measurement_id: G-XXXXXXX

The extension also accepts id as an alias for measurement_id.

Page Behavior

Analytics is global by default because its hook runs in the head of every page. If you need page-specific analytics behavior, write a custom extension hook that inspects the page argument passed to the hook and returns nothing for pages where analytics should be disabled.

Hook Shape

class GoogleAnalyticsExtension(Extension):
    id = "webifier.analytics.google"

    def register(self, ctx):
        super().register(ctx)
        ctx.add_hook("head", self.render_head)

    def render_head(self, builder, *, config=None, instance_name="analytics", **kwargs):
        measurement_id = config[instance_name]["measurement_id"]
        return google_tag_html(measurement_id)

Extending Analytics

Analytics-like extensions usually use head because they inject scripts or head tags into each page. A package can expose multiple provider-specific ids, such as my_org.analytics.plausible and my_org.analytics.google.