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.

  • License Key

    • After purchasing GA4Dataform from the Superform Labs Store, you’ll receive a license key. A valid license key is also provided with the free Core version.
    • 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​

To set up GA4Dataform, you need one of the following permission combinations:

  1. Viewer + Project IAM Admin + Service Usage Admin
  2. Editor + Project IAM Admin
  3. Owner

These permissions can be revoked after installation. If strict policies prevent granting these permissions, consider using GA4Dataform Community, the open-source version of Core. For more details, visit the Permissions page.

Once authorized, the installer will create a Dataform repository through a series of API calls using your account credentials.

Privacy Notice

We do not access your data during or after installation. We only check dataset sizes to estimate processing costs - this information is not stored on our servers.

Using GA4Dataform After Installation​

1. Initial Setup​

Before running the queries, we recommend customizing your configuration (events, items, URL parameters, etc.). See our Post Installation Guide for detailed instructions!

2. Default Schedule​

If scheduling was enabled during installation, the installer automatically creates:

  • A Release that runs at 9 AM UTC
  • A Workflow that runs at 10 AM UTC

You can modify these schedules in the Dataform UI without affecting project functionality.

3. Git Integration​

GA4Dataform does not include a direct Git connection yet. Connect to your own Git repo or save and commit any customizations manually in your default Dataform repository.

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​