All Collections
General information
Migrating from GA Universal Analytics to GA4 in Oncrawl
Migrating from GA Universal Analytics to GA4 in Oncrawl

Are you replacing your GA-UA account with GA4? Here's everything you need to do to update your data sources in Oncrawl.

Updated over a week ago

Google Analytics - Universal Analytics will stop collecting data on July 1st, 2023.

Google Analytics 360 properties will benefit from a non-renewable 1-year extension, until July 1st, 2023.

Because Oncrawl relies on a snapshot of the past few days (45 by default) of analytics data at the time of a crawl, data from Google Analytics is or will soon be out of date, depending on when your account stopped processing data.

If you are planning to replace your Universal Analytics account with GA4, or if you have already done so, here's everything you need in order to update your Oncrawl setup.

Here's what we're going to do:

  1. Check that your GA4 account is set up

  2. Migrate to the new connector support, if necessary

  3. Add a connection to your GA account and create a GA4 data source

  4. Find old UA usage and replace it with new GA4 data

  5. Run a crawl

  6. Update other Oncrawl resources

Prerequisites: set up your GA4 account

A GA4 account

You must have a GA4 account for your website.

45 days of data (by default)

Because Oncrawl will be looking for the past 45 days of data (by default), the earlier the better! If you have fewer than 45 days of data, that's okay. However, your reports will show numbers that look low. This is because there aren't enough days of data to show the values you might be used to seeing.

A web data stream

Oncrawl will draw data from GA4 about your website. In GA4, you can monitor traffic on a website, but you can also use it to track an app, in iOS and Android. Each version of your app or site is assigned a data stream.

Because Oncrawl analyzes websites, Oncrawl requires a "web" data stream in GA4.

This is the default setting, but you can go to Admin > Data Streams (under "Property") in your Analytics account to check or change that.

Migrate your interface if you already have a GA Universal Analytics account

Skip this step if you don't have any crawls with GA (UA) data.

Go to the crawl settings of a crawl profile with data from the GA (UA) connector. You can tell a crawl has GA data if the icon below is darkened in the list of past analyses on your project page. If you hover over it, you'll will see the dates of data drawn from Google Analytics.

In the crawl settings for this profile ("weekly full crawl" in the example above), go to Analyses > SEO Impact report > Google Analytics.

Click the "Migrate" button if one exists. This updates your account to use the new connected app format. This process is immediate.

Add a connection to your GA account and create a GA4 data source

Click on the button "Add a new data source" and follow the instructions.

Save this profile (and run a crawl if you'd like).

Find all crawl profiles using a GA Universal Analytics data source

From the project home page, go to "Add data source" > "Google Analytics".

In the "Version" column, you can see that some data sources are listed as "UA" and others as "GA4".

Click on "Show usage" for any UA data sources you have.

If a crawl profile is listed, clicking on it will take you to its settings in a new tab.

Under Analyses > SEO Impact report > Google Analytics, you can choose the GA4 data source you created in the previous step.

Run a crawl with GA4 data

If you didn't run a crawl with GA4 data earlier, you will need to do so before the next steps.

Update other Oncrawl resources

You must have at least one completed crawl to be able to update these resources.

The following resources might depend on GA Universal Analytics data. They can easily be updated to use GA4 data instead:

  • Alerts: Update old alerts from GA-UA to GA4 by changing the OQL expression. Replace the GA-UA metric with a GA4 one.

  • Own filters: Update any saved filters in the Data Explorer by switching from a GA-UA metric to a GA4 one in the OQL. In some cases, you may prefer to make the change a save the result as a separate, new filter.

  • Segmentations:

    • Update segmentations that are based on GA-UA data by changing the GA-UA metric to a GA4 one.

    • If you need to move fast, use the GA4 segmentation template to automatically create page groups based on the number of SEO-related sessions

Did this answer your question?