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.

Walkthrough Video​

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​

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

Transforms raw Google Ads Data Transfer tables into a more analysis-ready, efficient format. It joins metrics and dimensions from different raw Google Ads tables (BasicStats, ConversionStats, Lookup tables) and enables simplified reporting across ad entities.

Key features:

  • Easily consolidate data from multiple Google Ads accounts (not just under the same MCC account)
  • Maintain latest metadata for ad entities efficiently (campaigns, ads, ad groups, keywords, gclid)
  • Deduplicated, incremental GCLID table that can be joined to other data sources (such as GA4) in downstream queries
  • Flexible configuration for multiple conversion actions
  • Process only new data from certain raw Ads tables that can get costly in high volume accounts

Output Tables:

  • dim_gads_accounts, dim_gads_campaigns, dim_gads_ad_groups, dim_gads_ads, dim_gads_keywords, dim_gads_gclids - Dimension tables
  • Campaign, Ad Group, Ad, Keyword, and Paid/Organic metrics tables

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!