Skip to main content

Get Started

Welcome to GA4Dataform! This page will summarize everything you need to get started with GA4Dataform.

Requirements​

To use GA4Dataform, ensure you have:

  • A Google Cloud project with billing enabled.

  • GA4 Property with BigQuery Export

    • An active GA4 property with BigQuery export configured.
    • Check for the dataset analytics_<property_id> in BigQuery to confirm proper configuration.

  • A License Key

    • After purchasing GA4Dataform from the Superform Labs Store, you’ll receive a license key.
    • Note: The license key is linked to the email address used during the purchase and is valid for the duration of your plan. It can be reused unless explicitly disabled.

Installation Guide​

GA4Dataform offers two installation scenarios:

New Installation​

  • Follow the instructions provided during the installation process.
  • For detailed steps, visit our Installation Guide

Update​

  • Run the installer again to update the app.
  • Updates are non-destructive and create a new workspace while maintaining compatibility with previous versions.
  • No need for a full-refresh of your model after updates.

Access Management for Beginners​

Access Permissions

To set up GA4Dataform, the installer requires Google Cloud Project Owner permissions. After installation, these permissions can be revoked.
If strict policies prevent granting these permissions, consider using our open-source version. For more details, visit the Permissions page.

Using GA4Dataform After Installation​

  1. Releases and Scheduling

    • The installer configures a Release (triggered at 9 AM UTC) and a Workflow (triggered at 10 AM UTC) automatically.
    • These schedules can be modified in the [Dataform UI]. Adjusting the schedule won’t impact the functionality of your project.

  2. Git Integration

    • GA4Dataform does not include a direct Git connection yet.
    • Save and commit any customizations manually in your default Dataform repository.

  3. Custom Configuration

    • Modify specific parameters such as event, item, URL, and user properties using custom folders.
    • For a step-by-step guide, see Custom Configuration.

  4. Version Tracking

    • The version of the package you installed can be found in the package.json file.

Important Notes​

BigQuery Costs

Using GA4Dataform will incur BigQuery costs.
Keep track of your billing to avoid unexpected charges. For tips on managing costs, see BigQuery Cost Management.
Superform Labs is not responsible for any charges related to BigQuery usage.

Additional Resources​