Skip to main content

Modules

Modules in GA4Dataform offer advanced functionality beyond the Core models, providing specialized analytics capabilities and reporting features. Currently there are only Premium 💎 modules, but we reserve the option to release modules for Core as well in the future.

How does it work?​

Modules are separated from the core GA4Dataform models to their own folder structure:

  • SQLX Models: All the SQLX models are defined in definitions/core/modules/[module_name]/
  • Configuration: Module configurations are stored in includes/custom/modules/[module_name]/config.json

Each module can be independently enabled or disabled through its configuration file, giving you full control over which features are deployed in Dataform.

Module Configuration​

Each module has a separate YAML or JSON configuration file that controls the variables affecting the output of that module. These files are located in the includes/custom/modules/ directory and allow you to:

  • Enable or disable the entire module
  • Configure specific parameters and filters
  • Set lookback periods and date ranges
  • Define custom dimensions and drilldowns
  • Control cost parameters and exchange rates

The configuration format varies by module but always includes an enabled flag and a version number for tracking changes.

Looker Studio Template​

tip

We created a free-to-use Looker Studio template that was specifically designed to work with the GA4Dataform modules. Feel free to copy it and adapt it to your needs! You can find it here.

Available Modules​

Items Funnel Report​

Configuration: includes/custom/modules/items_funnel_report/config.json

Provides detailed funnel analysis for e-commerce items, tracking item interactions throughout the customer journey.

Key features:

  • Comprehensive item dimension breakdowns (ID, name, brand, variant, categories)
  • Channel and device segmentation options
  • Custom item parameters support
  • Session-level dimensional analysis
  • Three aggregation levels: events, sessions, and users
  • Revenue and quantity tracking

Output Tables:

  • report_items_funnel - Item funnel metrics and analysis
  • ga4_items_sessions - Session-level item data

GA4 Parameter Detection​

Configuration: includes/custom/modules/parameter_detection/config.yaml

Automatically discovers and tracks user properties, custom event parameters, and item parameters in your GA4 raw export. This module helps you identify and explore which parameters are being collected in your implementation.

Key features:

  • Tracks both configured and discovered parameters
  • Provides filtering options (include/exclude parameters, categories)
  • Provides sample values for analysis
  • Configurable lookback periods
  • Provides a formatted config.js suggestion for the discovered parameters

Output Tables:

  • ga4_parameter_detection_daily - Daily parameter tracking
  • ga4_parameter_detection_agg - Aggregated parameter insights
  • ga4_parameter_detection_config_suggestions - Configuration suggestions for discovered parameters

BigQuery Cost Monitoring​

Configuration: includes/custom/modules/bq_cost_monitoring/config.json

Monitors and reports on BigQuery costs associated with your GA4Dataform implementation, including processing, storage, and query costs.

Key features:

  • Processing cost tracking ($5 per TB default)
  • Storage cost monitoring ($0.02 per GB per month default)
  • Exchange rate multiplier support
  • Historical cost analysis from configurable start date

Output Tables:

  • bq_cost_overview - Consolidated cost summary
  • bq_cost_processing - Query processing costs
  • bq_cost_storage - Data storage costs
  • bq_cost_reporting - Detailed cost reports
  • info_schema_jobs_queries - Query execution details
  • info_schema_jobs_scripts - Script execution tracking

Conversion Rate per Event​

Configuration: includes/custom/modules/cvr_per_event/config.json

Analyzes session-level conversion rates for specific events, providing detailed funnel analysis capabilities.

Key features:

  • Configurable conversion events (default: "purchase")
  • Event exclusion filters (user_engagement, first_visit, session_start)
  • Multiple dimensional breakdowns (channel grouping, device, campaign data)
  • Custom session dimensions support

Output Tables:

  • report_cvr_per_event - Main conversion rate reporting table

What should we build next?​

Building with modules creates a whole world of possibilities as we can explore features beyond the core models. Let us know if you have any feedback regarding the existing modules or what we should build next at support@superformlabs.eu!