[UA] About Campaign Data

Learn how to import and enhance your custom marketing campaign data.

Importing campaign data into Analytics enables a more customized analysis of ad campaign performance. It allows you to include data such as new campaign classifications and variations in addition to the standard Analytics campaign tracking parameters.

It also simplifies and reduces the amount of campaign data you need to send in the tracking code. A single campaign ID sent to Analytics at collection time can be joined with your imported campaign data to populate campaign and custom dimensions and metrics in your reports. This means you can reuse your existing campaign codes and import data for them.

In this article:

How Campaign Data import works

Campaign Data import works by setting a Campaign ID for your URLs. You can then use the Campaign ID to join these hits with your imported data. You can upload traditional campaign data, such as Source and Medium. You can also upload data to custom dimensions to suit your purpose. For example, you might upload to a Campaign Group custom dimension to track related sets of campaigns.

There are 3 options for setting campaign data for your users:

Option 1: Use custom campaign tagging

Tag campaign destination URLs with the utm_id parameter. Analytics will then associate this campaign ID with users who follow this URL. For example:


Learn more about custom campaigns.

Option 2: Set campaign data directly

If you have a custom implementation and campaign information is available then you can set the campaign data directly by modifying your tracking code. Refer to the Analytics Developers Guide for details.

Option 3 (analytics.js): Plugin with custom campaign tracking

If you tag URLs using non-Analytics campaign tracking parameters you can use an analytics.js plugin to map your campaign values to those recognized by Analytics. Refer to the Analytics Developers Guide for details.

Analyze and take action

Use the Acquisition reports to analyze your imported Campaign Data. The standard campaign parameters (e.g., Source, Medium, Content, Term, etc.) are available by default, and you can add any custom dimensions as a secondary dimension to that report.

Google Developers may create custom reports or automate your analysis by using the Core Reporting API.

Imported Campaign Data custom dimensions can also be applied as a segment throughout Analytics.

Data Set details

The Data Set is the container that will hold your imported data. Expand the section below to see the Data Set details.

Data Set details


  • Scope—the scope determines which hits will be associated with the import dimension values. There are four levels of scope: hit, session, user and product. Learn more about scope.
  • Schema Key—lists the key dimensions or metrics. The key is used to join the data you upload with the existing data in your hits for this Data Set type.
  • Imported Data—lists the dimensions and metrics available for the data you upload to Google Analytics.
The dimensions and metrics listed here for the schema key and imported data are for reference only and may not be complete; the actual dimensions and metrics available will appear in the user interface when you create the Data Set.
Scope Session
Schema Key

Campaign Code (required)

Imported Data At least one of the following:
  • Ad Content
  • Ad Group
  • Campaign
  • Keyword
  • Medium
  • Referral Path
  • Source
  • Custom dimension (session scope)

Was this helpful?

How can we improve it?
Choose your own learning path

Check out google.com/analytics/learn, a new resource to help you get the most out of Google Analytics 4. The new website includes videos, articles, and guided flows, and provides links to the Google Analytics Discord, Blog, YouTube channel, and GitHub repository.

Start learning today!

Clear search
Close search
Google apps
Main menu