Skip to main content

Analytics setup (optional)

dbt-Workbench includes optional Google Analytics 4 tracking. The GA script is only injected when GA4_ID is defined at build time.

Add GA4_ID in GitHub Actions​

  1. Open your GitHub repository settings.
  2. Navigate to Secrets and variables → Actions.
  3. Add a new repository secret named GA4_ID.
  4. Set the value to your GA4 Measurement ID (e.g., G-XXXXXXXXXX).

Verify it works​

  • Trigger a new build by pushing to main.
  • Inspect the rendered HTML for the GA script.
  • Confirm real-time events in the GA4 console.

Funnel events to review​

Use the following funnel as the minimum monthly scorecard. The first four are available from the existing site and repository surfaces; the final event requires product analytics or a maintainer check until it is instrumented in the application.

Funnel stageSuggested measure
DiscoveryOrganic clicks to documentation and non-brand top-10 queries
EvaluationDocumentation-to-GitHub CTA click-through, tagged by utm_campaign
ActivationSuccessful Docker quickstart and first demo run
AdoptionNew issues, discussions, contributors, and repeat repository visitors
Production evaluationTeams completing the production readiness checklist

Set a baseline over 14 days before choosing targets. Do not treat impressions, followers, or GitHub stars as product adoption without activation evidence.

Optional: Search console verification tags​

You can inject verification meta tags at build time with GitHub Actions secrets:

  • GOOGLE_SITE_VERIFICATION → renders <meta name="google-site-verification" ...>
  • BING_SITE_VERIFICATION → renders <meta name="msvalidate.01" ...>

Add these in Settings → Secrets and variables → Actions to enable ownership verification in Google Search Console and Bing Webmaster Tools.