brighter websites logoBrighter Websites Logo White

Custom Dimensions

Register SCOS GA4 custom dimensions — cluster, topic, intent, purpose, maturity, and post type parameters.

Analytics

Table Of Contents

Who is this for

Agency devs / future maintainers
Usage Guide

Summary

Every SCOS page view sends strategy metadata as GA4 event parameters — post type, content cluster, topic, intent, purpose, maturity, and more. You must register each parameter as a custom dimension in GA4 Admin → Custom Definitions before they appear in explorations. This page lists the parameter names, descriptions, and example values to copy into GA4.

Copy each parameter from the table into GA4 custom definitions — events already include these fields after Analytics is enabled.

Custom Dimensions Sent to GA4

Every page view automatically includes SCOS content strategy metadata as GA4 event parameters. Register these as Custom Dimensions in GA4 → Admin → Custom Definitions to use them in reports.

Parameter NameDescriptionExample Values
post_typeWordPress post typepage, post, project
content_clusterStrategic Content ClusterAI-First SEO, Conversion Optimisation
content_topicPrimary TopicContent Strategy, Technical SEO
content_intentUser search intentinformational, commercial, transactional
content_purposeContent role in strategypillar, service-page, supporting, conversion-hub
content_maturityContent Maturity Levellearner, practitioner, expert
pillar_pageParent pillar/service page titleTitle of linked pillar
service_pathwayService/Product pathway page titleTitle of linked service pathway
content_planContent workflow/optimisation statusapprove, testing, revise, archive
lead_tierLead Quality Tier (form-based)hot, warm, cold
lead_typeLead Type (form-based)quote_request, contact_form, newsletter
cta_labelCTA label before form submitText of CTA clicked
cta_locationCTA location sectionheader, footer, atf, mid_cta
cta_typeCTA typemain, micro, assist

Green rows = SCOS content strategy dimensions. Yellow rows = CTA/form context dimensions (only sent with form_submit and generate_lead events).

How It Works

The SCOS Content Architecture Record (CAR) is injected into every page head as window.scosCAR. The GA4 tracking script reads this and sends content strategy metadata with every page view event — cluster, topic, intent, purpose, maturity, pillar, and service pathway. This lets you analyse performance by strategy, not just traffic.

  1. Add your GA4 Measurement ID above and save.
  2. Register custom dimensions in GA4 → Admin → Custom Definitions (Event scope):
    content_clustercontent_topiccontent_maturitycontent_intentcontent_purpose
  3. Seed events so GA4 registers them immediately (important for low-traffic sites).
  4. Mark high-value events as conversions in GA4 → Admin → Events.
  5. Build funnels and attribution reports in GA4 Explorations.

Want to Contribute to SCOS?

SCOS is a Strategic Content Operating System - learn more or contact us on support@brighterwebsites.com.au.

Work with me

Hit submit and I’ll reach out by email or phone to help you get started. Your details stay private,  see the Privacy Policy.