The goals migration tool allows you to quickly recreate eligible goals from your connected Universal Analytics property as conversion events in your Google Analytics 4 property.In this article:
To use the goals migration tool, you need the Editor role on your account.
- In the Property column, select the Google Analytics 4 property that currently collects data for your website.
- In the Property column, click Setup Assistant.
- Under Property settings, go to Set up conversions, and click the Actions icon .
- Click Import from Universal Analytics.
- In the Import existing goals from your connected property panel, select which goals you'd like to recreate as conversion events in your new Google Analytics 4 property.
Note: If you've already created an equivalent GA4 conversion event for a goal, then you shouldn't select it here.
- Click Import selected conversions in the top right.
A confirmation message will show in the bottom left of your screen when your selected goals have been successfully recreated as conversion events in your Google Analytics 4 property.
Goals vs. conversion events
Conversions are user activities that contribute to the success of your business. Examples of conversions include making a purchase, completing a game level, or submitting a contact information form.
How the tool works
For each eligible Universal Analytics goal you select, the goals migration tool automatically does the following in your connected Google Analytics 4 property:
- Creates a new Create event rule
- Marks the created event as a conversion
All conversions that the tool automatically creates use the Once per session counting method to more closely align with how Universal Analytics properties count goals.
Universal Analytics properties can have several different goal types. These 4 goal types can be migrated using the tool:
- Destination: When a user lands on a specific page, such as a "thank you" or "confirmation" page
- Duration: Sessions that lasts a specific amount of time or longer, such as 10 minutes or longer spent on a support site
- Pages/screens per session: When a user views a specific number of pages or screens
- Event: When a user triggers a specific event, such as social recommendation, video play, or ad click
Smart goals can't be automatically migrated and won't appear in the tool.
Note: When migrating goals that use regular expressions, make sure to review the best practices to avoid creating any malformed goals. Learn more
You can create up to 30 custom conversion events per standard Google Analytics 4 property. At the bottom of the goals migration tool, you can see how many conversion events you have left before you reach that limit.
Where to find your new conversion events
To view these new conversion events in your Google Analytics 4 property, go to Configure > Conversions and look in the Conversion Events table.
It may take up to 24 hours for new conversion events to appear in your reports.
Edit or update the rules for a new conversion event
If you want to edit or update the rules for one of your new conversion events, go to Configure > Events, then:
- Click Create event.
- If you have more than one web stream, choose the correct web stream.
- In the Custom events table, click the event name that you entered in the goals migration tool.
- Click the edit (pencil) icon in the top right.
- Make your changes, and click Add modification.
Delete the rules for a new conversion event
If you accidentally selected a goal you didn't mean to migrate, you should:
- Turn off Mark as conversion for that event
- Delete the rules for the new conversion event. To do this, go to Configure > Events, then:
- Click Create event.
- If you have more than one web stream, choose the correct web stream.
- Click the row that contains your custom event.
- In the top right, click the menu (3 dot icon), and select Delete.
- In the pop-up, click Delete.
You'll see a Configuration deleted confirmation message at the bottom. When you delete the rules for an event, new events will stop being collected. However, previously collected events might still show up in:
- reports for the period during which they were collected
- the list of all events under Configure > Events
After you've created conversion events with the goals migration tool, you can import these new conversion events into Google Ads and start bidding on them. Learn more
Notifications in the tool
You might see some of the following notifications in the tool.
- Event names: Your event names may have been automatically updated to follow Google Analytics 4 naming conventions.
Google Analytics 4 properties have different event naming conventions than Universal Analytics properties do, so the goals migration tool might provide suggestions.
- Currency: You selected a Universal Analytics view with currency that does not match the currency in your Google Analytics 4 property. Update your currency if this was unintended.
You selected different currencies for your Universal Analytics and Google Analytics 4 properties. Update your currencies to match if this is unintentional. No currency exchange will take place.
- Multiple web data streams: Your Google Analytics 4 property has multiple web streams, so some conversions will be added to each web stream.
If your Google Analytics 4 property has multiple web data streams, the tool recreates destination goals as conversion events in each web data stream.
The tool only recreates event goals as conversion events in web data streams that receive Universal Analytics events from a connected site tag. If you don't have a connected site tag at all, the tool defaults to recreating your event goals as conversion events in all web data streams.
- Filtered Universal Analytics properties: Your Universal Analytics view has filters that treat data, traffic, and events differently than Google Analytics 4 filters. This may result in different conversion measurements in Google Analytics 4.
In Universal Analytics, you can create filters on views that limit or change the data recorded by that view. Google Analytics 4 properties don't have views and have different filter features. If your Universal Analytics view is being filtered, it could be missing some traffic that is included in the corresponding Google Analytics 4 property.
Google Tag Manager and event goals
If you use Google Tag Manager on your site, you have 3 options for migrating event goals.
Option 1: Best practice
The best practice is to restructure your Universal Analytics events to follow Google Analytics 4's data collection model and set up Google Analytics 4 conversion events. If you do this, you won't need to use the goals migration tool.
Option 2: Create a new Google Analytics 4 Event tag in Tag Manager, then use goals migration tool
If you want to use the goals migration tool, you first need to make sure Google Analytics 4 receives events in the expected format. To do this, you'll need to create a new Google Analytics Event tag in Google Tag Manager. (If you haven't already, make sure you create a Google Analytics 4 Configuration tag before you create the Google Analytics 4 Event tag.)
- Create a new Google Analytics: GA4 Event tag in your Tag Manager container.
- Set the value of the Event Name field to your Universal Analytics Event action.
- In the Event Parameters section, click Add Row, and do the following:
- Set its name to event_category.
- Set its value to your Universal Analytics Category value.
- Add a second event parameter:
- Set its name to event_label.
- Set its value to your Universal Analytics Label value.
- Add a third event parameter:
- Set its name to value.
- Set its value to what your Universal Analytics Value is set to.
- Click Triggering, and select the same events that cause your equivalent Universal Analytics events to trigger.
- Save the tag configuration and publish your container.
Example screenshots of UA vs. GA4 equivalent
1. A Universal Analytics Event tag in Google Tag Manager
2. The equivalent Google Analytics 4 Event tag in Google Tag Manager
Option 3: Use goals migration tool now, restructure data collection later
You can also combine the previous two options to use the goals migration tool now, and then use Google Analytics 4's data collection model at a future date. To do this, follow the instructions in Option 2 to create an event with
value parameter names and values. You can also add any additional parameters that the event would need in order to follow your future Google Analytics 4 data collection model.
If you're not seeing your newly created conversion events in your Google Analytics 4 property, your data collection might be incomplete. To fix this, make sure your site is fully tagged.
- If your site is using
analytics.js, add the Google tag to the site sending traffic to your Google Analytics 4 property and enable the Collect Universal Analytics events setting
- If you're using the Google tag (
gtag.js) and only sending traffic to a Universal Analytics property, create a connected site tag
- If you're using a tag management system like Google Tag Manager, use that system to send traffic and events to your Google Analytics 4 property
- If you're using a legacy tag like
ga.js, upgrade your tag on your website to