Skip to content

Releases: 0xDarkMatter/ga4-cli

v0.3.0 — BigQuery Integration

25 Mar 12:18
@0xDarkMatter 0xDarkMatter
v0.3.0
f943d6a

Choose a tag to compare

View all tags
v0.3.0 — BigQuery Integration Latest
Latest

What's New

BigQuery Export Management (ga4 bq)

10 new commands for managing GA4 BigQuery exports — things the official bq CLI can't do because it doesn't understand GA4 properties, export links, or the nested event schema.

Command What it does
bq status Show BQ export link config (project, export types, excluded events)
bq link Create BQ export links via Admin API
bq freshness Check data lag on export tables
bq audit Scan all properties for BQ link gaps
bq query Run pre-built or custom SQL against GA4 exports
bq cost Dry-run cost estimation before querying
bq tables List tables in GA4 export dataset
bq schema Show table schema
bq datasets List datasets in a GCP project
bq templates List available query templates

Query Templates

5 pre-built SQL templates for common GA4 analysis:

  • ai-traffic — Sessions from AI platforms (ChatGPT, Claude, Gemini, etc.)
  • sessions — Daily session counts
  • top-pages — Most viewed pages
  • events — Event frequency breakdown
  • channels — Traffic by source/medium

Quality

  • 36 automated tests (up from 20)
  • BQ REST API client using existing OAuth tokens (no extra dependencies)
  • Auto-detects GCP project from BQ link
  • All commands support --json, --fields, --quiet

Full Changelog: v0.2.0...v0.3.0

Assets 2
Loading

v0.2.0

25 Mar 11:36
@0xDarkMatter 0xDarkMatter
v0.2.0
b6d8f84

Choose a tag to compare

View all tags
v0.2.0

What's New

Channel Groups

  • Full CRUD CLI for custom channel groups (list, get, create, update, export, delete)
  • AI Traffic template — creates channel group with AI Traffic above Referral
  • Channel groups integrated into schema export/deploy with idempotent dedup
  • Channel groups health check (#25 of 25)

Account-Level User Management

  • All user commands support --account/-a for account-level access bindings
  • Account-level access cascades to all properties under the account
  • Batch create/delete for account-level bindings

Clique Protocol Compliance

  • --fields global flag for JSON field selection
  • --quiet/-q global flag to suppress non-essential stderr
  • --limit/-n on all list commands
  • validate_id() for agent safety (rejects suspicious characters in IDs)
  • Agent Rules section in AGENTS.md
  • 20 automated tests

Schema

  • Channel groups included in schema export/deploy
  • Idempotent deploy with skip tracking
  • analytics.edit OAuth scope for write operations

Full Changelog: https://github.com/0xDarkMatter/ga4-cli/commits/v0.2.0

Loading