Skip to main content

Google Analytics 4 Events

This guide shows how to export Google Analytics 4 Events and give access to Maya to process them for further analysis.

Setup instructions​

Prerequisites​

To connect Google Analytics 4 Events to Maya, you need

  1. Access to a A Google Analytics 4 account.
  2. A Google Cloud Platform role with sufficient permissions to provision IAM roles for BigQuery access.

In your developers settings, make a note of the unique auto-generated email address at the bottom of the setup form ( i.e, [email protected]). You will need this email to configure your source system to sync with Maya.

note

The auto-generated email is unique and tied to your account.

Step 1 Configure BigQuery export for GA4Export​

Follow Google's step-by-step instructions to configure BigQuery export for Google Analytics 4 Export .

or proceed with the following steps:

  1. Log in to the Google APIs Console.

  2. Create a Google APIs Console project or select an existing project (write down this project_id because you will need it later) - i.e mayainsights.

  3. Navigate to the APIs table. Open the Navigation menu in the top-left corner, click APIs & Services, then click Library.

  4. Activate BigQuery. Under Google Cloud APIs, click BigQuery API. On the following page, click Enable. If prompted, review and agree to the Terms of Service.

  5. In Google Analytics, click Admin. Make sure you are in the correct account and property.

  6. In the Property column, under PRODUCT LINKS, click BigQuery Links. Click Link.

  7. Click Choose a BigQuery project to display a list of projects for which you have at least read permission.

  8. Finish the steps and click submit.

Step 2 Grant permissions to Maya.​

  1. Go to your Google Cloud Platform project IAM section.

  2. Click + Grant Access to add new user. The Add principals form appears.

  3. In the New principals field, enter the auto-generated email address you copied in Step 1 (i.e, [email protected]).

  4. Select the A.Bigquery Job User, B.BigQuery Data Viewer, C.Storage Object Admin.

    Maya must have these permissions to access Google Analytics 4 Export tables and create the jobs necessary to query the BigQuery tables. Use a separate project for datasets that you do not want Maya to be able to query.

Step 3 Give Access to Maya.​

After the first run of ga4 export to your big query project (by the next day), the dataset_id containing the analytics data will become available. Then in order to conclude the Maya integration you need to:

  1. Go to your Google Bigquery and select the project you configured in step 1.

  2. In Google Bigquery under mayainsights you will see a dataset (datasetid) with the following pattern "analytics\<number>" (i.e analytics_30456743). Write down this dataset_id along with project_id because you will need it in the next step.

  3. Login to Maya.

  4. Go to Sources.

  5. Add Google Analytics 4 Events.

  6. In the new screen enter the project_id and dataset_id created.

  7. Click Save.

General information​

Maya Dashboards​

Maya Database​

You can inspect database schema here.

Release notes​

VersionDescription
0.0.1GA4 BETA.

FAQ​

Questions?

We would be happy to answer any questions you may have! Send us an email at [email protected].