[GA4] Understand data sources

A data source is a container that holds the data you upload to Analytics, and comprises the CSV file you upload and a mapping of existing Analytics fields to the fields in your CSV. Data sources control how uploaded data gets joined with existing data. You configure data sources at the property level.

To manage the data sources for a property, click Admin, then under Data collection and modification, click Data import.

Data-source types

A data-source type corresponds to the specific type of data you want to import. For example, there are data-source types for cost data, item data, user data,offline-event data, and custom event data. For each one, you have different options for the dimensions and metrics (the schema) you can upload data for.

Data-source schema

When you create a source, you define a schema, the structure that joins the data you upload with the existing Analytics event data. A simple schema consists of a join-key dimension (the "key") and the import dimension(s) or metric(s). To import data, Analytics looks for key values in event data that match key values in the uploaded data. When Analytics finds a match, it adds (or replaces if data was already collected) the additional dimension and metric values associated with that key to the existing event data. Some data-source types let you use multiple dimensions to define the key, and most can use multiple dimensions/metrics for the import fields.

The join key is composed of at least one Analytics dimension, and can be composed of up to three.

The key dimensions vary based on the type of data set you choose.

A list of available key dimensions is provided in the drop-down menu in the data-source schema builder.

You can upload data via the same data source multiple times as long as you are adding values to existing fields. Once you save a data source, you can't change the mapping of Analytics fields to the fields in your import. If you want to add fields to an existing data source, you need to delete the existing data source and then create a new one. Otherwise, you can import an additional data source with the new fields you would like to include. Learn more about limits per data import type.

When you re-import data into an existing data source, previously imported data will persist while appending new imported data. If the imported data has the same set of keys as previously imported data, the data will be overwritten.

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Google apps
Main menu
11192494931949012527
true
Search Help Center
true
true
true
true
true
69256
true
false