Skip to main content

Google Analytics 4 Boilerplate

plan support

Only in Essential Plan and above

Get started with your Google Analytics (GA4) data in Wren AI by using our boilerplate. This template provides a structured framework for importing and analyzing your Google Analytics data, saving you time and effort.

Prerequisites

  • GCP Account
  • GCP Project Id
    • GCP Dataset with Google Analytics data
    • GCP rights to provide principal permissions
  • Google Analytics Account

Importing Google Analytics Data into GCP

note

Your GCP account must have the Editor or Administrator roles. You may also insure in additional billing costs in GCP for BigQuery compute and storage pricing. It is recommended to have some level of experience with GCP for this section.

Prerequisites

  • GCP Project Editor or Administrator roles
  • Google Analytics Account Editor or Administrator roles for the properties & apps

You can also refer to Google’s Official documentation on how to export Google Analytics Data to GCP.

GCP Developer Console

In your Google Cloud Console, create a new project or select an existing project to use for your Google Analytics Data. Within this selected project, go to the API &Services section, then choose Library. Next, you will need to activate the BigQuery service for this project. In the Google Cloud APIs, click BigQuery and enable it.

Wren AI Cloud supports if your project is using BigQuery Sandbox.

Google Analytics Console

In your Google Analytics Project, go to the Admin Section, find the Product link tab, and select BigQuery Links. Click the Link button and choose the BigQuery Project previously created.

w_ai_ga4_bq_1.png

You can select which data streams to include in BigQuery by going to Data streams and events. You have the flexibility to exclude certain events from being synced to Bigquery to filter anything which is not useful or may be sensitive data. To exclude this you must use see on the predefined list of existing events to exclude and you can specify event by name in the Exclude Events section by adding them.

Steps to use Google Analytics Boilerplate

note

Before continuing, please make sure you've successfully imported your data into GCP.

Click the Google Analytics option in the Start with a Data Boilerplate section to add a Google Analytics Boilerplate.

w_ai_ga4.png

Ensure you have imported your Google Analytics data into Bigquery for this step. It is recommended that you do this step in a separate browser tab.

You will be asked to provide Bigquery Data Viewer permissions to the Wren AI service account. To do this, you must go into your GCP project, select the three dots on the resource containing your imported Google Analytics data, and select manage permissions.

w_ai_gcp3.png

Select the Add Principal button to grant new access. Paste the Wren AI Service Account Principal Address generated on your Wren AI Cloud Project page. In the assign roles section, please select BigQuery Data Viewer and save.

info

The Viewer Role permission is read-only access to Bigquery data and metadata. This allows Wren AI Cloud to see your tables and explore schema to generate the queries in Wren AI Cloud Console. We can will not modify or delete any of your GCP resources.

w_ai_gcp4.png

w_ai_gcp5.png

Once the Wren AI Service account has been added to your GCP project, please input your project ID. This can be found on the GCP Developer Console; click on the GCP project, and at the top, it will tell you the project ID.

w_ai_ga4_bp.png

Next, add your dataset ID. Access the BigQuery dataset ID in the GCP Developer Console and inside the desired project. In the resources section, find the dataset, click on the 3 dots next to the dataset name, and select copy ID.

When done, click continue.

Review Pre-filled Fields

The project modeling page displays all fields and their sub-values from the Google Analytics Boilerplate. These fields include events, orders, pages, traffic sources, and device browsing information. We've added a visual marker to indicate the boilerplate's origin, making it easier to differentiate between views and models.

Learn more about views

Ask Questions

To start your analysis, ask questions about your synced Google Analytics data. We offer a range of pre-defined questions to help you explore engagement, acquisition, and monetization.

What does user_pseudo_id mean in the boilerplate?

user_pseudo_id in GA4 is a unique identifier that Google assigns to a user to track their interactions across different devices and platforms. It's designed to provide a more comprehensive view of user behavior without revealing personally identifiable information (PII).

You can customize the user_pseudo_id using your own implementation to align with your specific tracking needs.

Add additional data sources to your boilerplate