[UA] Custom dimensions & metrics [Legacy]

Include non-standard data in your reports.
You are viewing a legacy article about Universal Analytics. Learn more about Google Analytics 4 replacing Universal Analytics.
This article is about custom dimensions and metrics in Universal Analytics. For information about custom dimensions and metrics in Google Analytics 4, go to [GA4] Custom dimensions and metrics.

Custom dimensions and custom metrics are like default dimensions and metrics in your Analytics account, except you create them yourself. You can use them to collect and analyze data that Analytics doesn't automatically track.

In this article:

Overview

Custom dimensions and metrics allow you to combine Analytics data with non-Analytics data, e.g. CRM data. For example:

  • If you store the gender of signed-in users in a CRM system, you could combine this information with your Analytics data to see Pageviews by gender.
  • If you're a game developer, metrics like "level completions" or "high score" may be more relevant to you than pre-defined metrics like Screenviews. By tracking this data with custom metrics, you can track progress against your most important metrics in flexible and easy-to-read custom reports.

Custom dimensions can appear as primary dimensions in Custom Reports. You can also use them as Segments and secondary dimensions in standard reports.

Prerequisites

Custom dimensions and metrics are only available for properties that have either been enabled for Universal Analytics or contain at least one app reporting view. Custom dimensions and metrics are supported by the Google Analytics SDKs for Android and iOS v2.x or higher, analytics.js, and the Measurement Protocol.

Custom dimensions and metrics require additional setup in your Analytics account and in your tracking code. Once you complete both steps of the setup, you can use them in your reports.

Limits and caveats

There are 20 indices available for different custom dimensions and 20 indices for custom metrics in each property. 360 accounts have 200 indices available for custom dimensions and 200 for custom metrics.

Custom dimensions cannot be deleted, but you can disable them. You should avoid trying to reuse custom dimensions. When you edit the name, scope, and value of a custom dimension, both the old and the new values can be paired with either the old or the new dimension name. This conflates data in your reports in a way that cannot be accurately separated with a filter.

Certain custom dimensions are not available in reporting when combined with demographic information. You may experience thresholding or incompatibility constraints in reporting or with the API when requesting custom dimensions with demographic data.

Lifecycle of custom dimensions and metrics

The lifecycle of a custom dimension or metric has four stages:

  • Configuration – you define your custom dimensions and metrics with an index, a name, and other properties like scope.
  • Collection – you send custom dimension and metric values to Analytics from your implementation.
  • Processing – your data is processed using your custom dimension and metric definitions and any reporting view filters.
  • Reporting – you build new reports using your custom dimensions and metrics in the Analytics user interface.

Configuration

Before you can send custom dimension and metric values to Analytics, they must first be defined in an Analytics property. Each Analytics property has 20 available indices for custom dimensions, and another 20 indices available for custom metrics.

When you define a custom dimension or metric, you specify its name and other configuration values, and Analytics assigns an index number that you use later to reference the dimension or metric. Custom Dimensions have the following configuration values:

  • Name – the name of the custom dimension as it will appear in your reports.
  • Scope – specifies to which data the custom dimension or metric will be applied. Learn more about Scope.
  • Active – whether the custom dimension or metric value will be processed. Inactive custom dimensions may still appear in reporting, but their values will not be processed.

Custom metrics have the following configuration values:

  • Name – the name of the custom metric as it will appear in your reports.
  • Type – determines how the custom metric value will be displayed in reports.
  • Minimum / Maximum Value – the minimum and maximum values that will be processed and displayed in your reports.
  • Active – whether the custom metric value will be processed. Inactive custom metrics may still appear in reporting, but their values will not be processed.

Custom dimensions and metrics can be defined in the Analytics user interface.

Once you define a custom dimension or metric, avoid editing the name or scope when possible. See Implementation Considerations to learn more about how changes to these values can affect your reporting.

Collection

Custom dimension and metric values are sent to Analytics at collection time as a pair of index and value parameters. The index parameter corresponds to the index number of the custom dimension or metric that Analytics assigns in the Configuration phase.

Unlike other types of data, custom dimensions and metrics are sent to Analytics as parameters attached to other hits, like pageviews, events, or ecommerce transactions. As such, custom dimension or metric values need to be set before a tracking call is made in order for that value to be sent to Analytics.

For example, to set a custom dimension value, your code might look like this:

ga('create', 'UA-XXXX-Y', 'auto');

// Set value for custom dimension at index 1.
ga('set', 'cd1', 'Level 1');

// Send the custom dimension value with a pageview hit.
ga('send', 'pageview');

Custom Metric Types

Custom metrics with a type of Integer or Time should be sent using integers, while custom metrics with a type of Currency may be sent as fixed decimal values appropriate to the local currency.

Processing

When custom dimensions are processed, scope determines to which hits a particular custom dimension value will be applied, while view filters determine which hits and their associated values are ultimately included in Reporting.

Scope and Precedence

Scope determines which hits will be associated with a particular custom-dimension value. There are four levels of scope: product, hit, session, and user:

  • Product – value is applied to the product for which it has been set (Enhanced Ecommerce only).
  • Hit – value is applied to the single hit for which it has been set.
  • Session – value is applied to all hits in a single session.
  • User – value is applied to all hits in current and future sessions, until value changes or custom dimension is made inactive.
Product-level scope

When a custom dimension has product-level scope, the value is applied only to the product with which the value is set. Because multiple products can be sent in a single hit, multiple product-level scoped custom dimensions can be sent in a single hit.

Hit-level scope

When a custom dimension has hit-level scope, the value is applied only to the hit with which the value was set. This is demonstrated in Figure A, Figure B, and Figure C below:

Figure A: User sends two hits (H1, H2). H2 has a CD1 value of A. That value is only applied to H2.
 
Figure B: User sends a third hit (H3). H3 has no CD value.
 
Figure C: User sends a fourth hit (H4). H4 has a CD1 value of B. That value is only applied to H4.


Session-level scope

When two values with session scope are set at the same index in a session, the last value set gets precedence and is applied to all hits in that session. In Figure D below, the latest value set overwrites any previous values for that index:

Figure A: User sends a hit (H1) with no CD value.
 
Figure B: In the same session, user sends a second hit (H2) with CD1 value set to A. Session scope causes value A to also be applied to H1.
 
Figure C: User sends a third hit (H3). Although no CD1 value is sent with H3, session scope causes value A to be automatically applied to H3.
 
Figure D: User sends a fourth hit (H4) with a new CD1 value B. Session-scope applies value B to all the hits in the session, overwriting value A in the previous hits.


User-level scope

Lastly, if two user-scoped custom dimension values are set within the same session, the last value set gets precedence for the current session, and is applied to future sessions for that user.

In Figure B below, CD value A is applied to all hits in session 2, just like a session-level CD. However in Figure C, unlike with session-level scope, the CD value A continues to be applied to hits in the third session due to CD1 having user-level scope:

Figure A: User has a session with three hits (H1, H2, H3). No CD values are set.
 
Figure B: The same user returns and has another session, with three more hits. CD1 value is set to A on H3. CD1 value is then applied to all hits in session.
 
Figure C: User returns for a third session with three more hits. CD1's user-level scope causes value A to be applied to all hits in session 3.

Filters

View filters can interact with custom dimensions and metrics in several ways.

Custom dimension and metric values are each associated with the hit with which they were received, regardless of their scope. If that hit is filtered by a view filter, the custom dimension or metric may also be filtered, depending on its scope:

  1. Hit-scope: Both custom dimensions with hit scope and all custom metrics will be filtered if the hit they are associated with was also filtered.
  2. Session or User-scope: User or session-scoped custom dimensions will not be filtered even if the hit they were attached to is filtered. Their values will still be applied to all hits in the current session, as well as future sessions if the dimension has user scope.

Custom dimensions can also be used to construct view filters. This will cause hits to be filtered according to the scope of the custom dimension. For example, filtering on a user-scoped custom dimension value would filter current and future sessions from the set of users associated with that value.

Reporting

After the collection, configuration, and other processing stages of the pipeline are complete, custom dimensions and metrics become available via the user reporting interface.

Custom dimensions and metrics are available in custom reports and available for use with advanced segments. Custom dimensions can also be used as secondary dimensions in standard reports.

Examples

The following examples show how custom dimensions and metrics can be used by a game developer to learn about player behavior.

A game developer has recently released a new game.

The current Analytics implementation tracks a screen view each time a user plays a level. The developer already knows how many times each level is played. Now they want to answer these more advanced questions:

  1. How many times are easy levels played versus medium or hard levels?
  2. How many levels are played for each day in a 3-day free trial?
  3. How many levels are played by users in the trial versus users who have paid for the game?

To answer these questions, custom dimensions are used to create new groupings of hits, sessions, and users.

Additionally, the developer is selling some extra features to enhance the user experience, such as "powerups". The developer is already using the category and variant fields, but wants an extra field to measure the strength of the powerup purchased. This way, the developer would be able to determine if certain powerup strengths were more popular than others.

Hit-level scope

Let's look at an example of how the game developer can use hit-level custom dimensions to find out how many levels of each difficulty level -- easy, medium, or hard -- were played.

The developer is already tracking the number of times each level is played using screen views. Now they want to know which difficulty is getting played the most.

The report will looks like this:

Difficulty Screen Views
easy  
medium  
hard  

Before using custom dimensions, the developer could see total screen views by level, but they were not able to group those screen views by difficulty.

By using a hit-level custom dimension, the difficulty can be associated with each screen view, allowing reports to include the difficulty being played the most.

Why hit-level scope?

A user may play several levels in the course of one session. Using hit-level scope means that a difficulty value will only be associated with the screen view with which it was sent. This ensures that each level screen view can be associated with a unique difficulty.

Configuration

The first step to implementing a custom dimension is to define it in your property settings in the Admin section of Analytics. For this example, the custom dimension definition looks like this:

Index 1
Name Difficulty
Scope Hit
Active true

Collection

In the game, the developer is already tracking each level with a screen view. In order to associate the difficulty with each level, the custom dimension value must be set just prior to the call to track the screen view.

The implementation might look like this:

ga('create', 'UA-XXXX-Y', 'auto');

// Set value for custom dimension at index 1.
ga('set', 'cd1', 'easy');

// Send the custom dimension value with a pageview hit.
ga('send', 'pageview', '/level_1/');

In this example, the custom dimension is set just before the level screen view is tracked. This associates the difficulty with the screen view and will allow the screen view hits to be grouped by difficulty in reports.

Processing

After the hits are collected and sent to Analytics, the data is processed and custom dimension values are applied to hits according to their scope.

For example, the data collected for a single player, with one session, who played 6 levels, looks like this:

userId = 5555
Session 1:
H1: screen_name=/level_1/ cd1_value=easy
H2: screen_name=/level_2/ cd1_value=medium
H3: screen_name=/level_3/ cd1_value=hard
H4: screen_name=/level_4/ cd1_value=easy
H5: screen_name=/level_5/ cd1_value=medium
H6: screen_name=/level_6/ cd1_value=medium

Note that using hit-level scope ensures each difficulty value is only associated with the screen view with which it was sent.

Reporting

Once processed, because each screen view is associated with its respective difficulty value, a developer can create a report that uses both screen name and difficulty as dimensions, and screen views as a metric:

Screen name Difficulty Screen views
/level_1/ easy 1
/level_2/ medium 1
/level_3/ hard 1
/level_4/ easy 1
/level_5/ medium 1
/level_6/ medium 1

A custom report can be created that uses Difficulty as a primary dimension to group screen views and find out how many times each difficulty level was played:

Difficulty Screen views
easy 2
medium 3
hard 1

In this report, levels of medium difficulty were played the most. This insight is made possible by using hit-level custom dimensions to group screen views.

Session-level scope

Let's now look at an example of how the game developer can use session level custom dimensions to see how many levels are played for each day in a 3-day free trial.

The developer already knows how many times each level is played by tracking a screen view for each level. Now they want to know how many levels were played on each day.

The report the developer wants to create looks like this:

Day of Trial Screen views
Day 1  
Day 2  
Day 3  

By using a session-level custom dimension, the developer can group screen views by the day of the trial and see how that number changes as a user spends more time in the free trial.

Why session-level scope?

You can use session-level scope to efficiently group entire sessions, and all of their component hits, under a single Day of Trial value.

Although hit-level scope could be used to achieve the same functionality, using session-level scope allows you to conveniently set a Day of Trial value using the least amount of additional code.

Configuration

The Day of Trial custom dimension is defined in the property settings section of the Analytics user interface with these values:

Index 2
Name Day of Trial
Scope Session
Active true

Collection

In the game, the developer is already tracking each level with a screen view. In order to associate a day with all the screen views in a session, the custom dimension value only needs to be set once per session.

The developer would set the custom dimension when the user first starts the game:

ga('create', 'UA-XXXX-Y', 'auto');

// Set value for custom dimension at index 2.
var day = getDayOfTrial();
ga('set', 'dimension2', day );

// Send the custom dimension value with a pageview hit.
ga('send', 'pageview', '/level_1/');

Note that a session-level custom dimension can be set at any time during the session. However in this example, it is simply convenient for the developer to determine the day of trial and set the value accordingly at the start of the session.

Processing

After the hits are collected and sent to Analytics, the data is processed and custom dimension values are applied to hits according to their scope.

For example, the data collected for a single player, who played the game twice on the first day, once the second day, and once the third day, looks like this:

userId = 5555
Session 1:
H1: screen_name=/level_1/  cd2_value=1
H2: screen_name=/level_2/
H3: screen_name=/level_2/

Session 2:
H4: screen_name=/level_3/  cd2_value=1
H5: screen_name=/level_4/
H6: screen_name=/level_4/

Session 3:
H1: screen_name=/level_1/  cd2_value=2
H2: screen_name=/level_2/
H3: screen_name=/level_3/

Session 4:
H1: screen_name=/level_3/  cd2_value=3

Note that custom dimension values have only been sent with one screen view per session.

Session-level scope ensures that the Day of Trial value will be associated with all hits in that session, not just the hit it was sent with.

Reporting

After processing, the session-level custom dimension values will be associated with all screen views received in the same session. The developer can now create a report using Day of Trial and screen name as dimensions and screen views as a metric:

Day of Trial Screen name Screen views
1 /level_1/ 1
1 /level_2/ 2
1 /level_3/ 1
1 /level_4/ 2
2 /level_1/ 1
2 /level_2/ 1
2 /level_3/ 1
3 /level_3/ 1

And finally, to group screen views by day and find out how many levels were played on each day of the trial, the developer can create a custom report that uses Day of Trial as a primary dimension:

Day of Trial Screen views
1 6
2 3
3 1

The data shows that the most levels on the first day and played noticeably fewer levels on days 2 and 3. This insight is made possible by using session-level custom dimensions to group multiple sessions and their component hits by a single value.

User-level scope

Finally, let's look at an example of how the game developer can use user-level custom dimensions to find out how many levels were played by paid users versus free trial users.

As in prior examples, the total number of times each level is being played is already tracked with screen views, but the developer now wants to group screen views by free and paid users.

The report the developer wants to see looks like this:

Player Type Screen views
Free  
Paid  

Using a user-level custom dimension, the developer can get this data by associating all screen views of a particular user, across their current and future sessions, with a Player Type value.

Why user-level scope?

User-level scope allows you to conveniently group all of a user's component sessions and hits by a single value. It is ideal for values that don't change often for a particular user, like Player Type in this example.

Note that although this same functionality could be achieved with hit or session-level scope, user-level scope provides the most convenient solution with the least amount of code.

Configuration

The Player Type custom dimension is defined in the Admin section with these values:

Index 3
Name Player Type
Scope User
Active true

Collection

As in previous examples, the developer is already tracking each level with a screen view. To group those screen views by Player Type, the developer only needs to set the Player Type dimension when the user starts the game, and a second time if a user subsequently pays to access the full version of the game.

The developer would set the custom dimension when the user first starts the game:

ga('create', 'UA-XXXX-Y', 'auto');

// Set value for custom dimension at index 3.
ga('set', 'dimension3', 'Free' );

// Send the custom dimension value with a pageview hit.
ga('send', 'pageview', '/level_1/');

The developer would also want to set the custom dimension when the user pays for the full version of the game:

ga('create', 'UA-XXXX-Y', 'auto');

// Set value for custom dimension at index 3.
ga('set', 'dimension3', 'Paid' );

// Send the custom dimension value with a pageview hit.
ga('send', 'pageview', '/level_1/');

Processing

As in previous examples, after data is collected it is processed and custom dimension values are applied to hits according to their scope.

For example, the data collected for a single player who played the game twice as a free user and once as a paid user would look like this:

userId = 5555
Session 1:
H2: screen_name=/level_1/ cd3_value=free
H3: screen_name=/level_2/

Session 2:
H1: screen_name=/level_2/
H2: screen_name=/level_3/
H3: screen_name=/level_3/

Session 3:
H1: screen_name=/level_3/ cd3_value=paid
H2: screen_name=/level_4/

Note that the free value set in session 1 applies to all hits in that session as well as session 2, until the new value of paid is set in session 3.

Reporting

After processing, Player Type custom dimension values will be associated with the sessions in which they were set, as well as any future sessions and hits.

The developer can now create a report using Player Type and screen name as dimensions and screen views as a metric:

Player Type Screen name Screen views
Free /level_1/ 1
Free /level_2/ 2
Free /level_3/ 2
Paid /level_3/ 1
Paid /level_4/ 1

Finally, to group screen views by Player Type and find out how many levels were played by free versus paid users, the developer can create a custom report that uses Player Type as a primary dimension:

Player type Screen views
Free 5
Paid 2

The data shows that more levels were played by free users than paid users. This insight is made possible by using user-level custom dimensions to group users and their component sessions and hits by a single value.

Product-level scope

Let's look at an example of how the game developer can use product-level custom dimensions to find which powerup strength -- weak, medium, or strong -- were purchased.

The developer is already tracking the number of times powerups are purchased using Enhanced Ecommerce. Now they want to know which strength powerup is getting purchased the most.

The report will look like this:

Powerup Strength Product Revenue
weak  
medium  
strong  

Before using custom dimensions, the developer could see total product revenue from powerups, but they were not able to group that revenue by strength of the powerup.

By using a product-level custom dimension, the strength can be associated with each product, allowing reports to include the strength being purchased the most (as well as viewed, clicked, and other Enhanced Ecommerce actions).

Why product-level scope?

A user may purchase several powerups in a single purchase. Using product-level scope means that a strength value will only be associated with the product with which it was sent. This ensures that each powerup purchased can be associated with a unique strength.

Configuration

The Powerup Strength custom dimension is defined in the property settings section of the Analytics Admin with these values:

Index 4
Name Powerup Strength
Scope Product
Active true

Collection

In the game, the developer is already tracking each powerup purchase. In order to associate the strength with each powerup, the custom dimension value must be set with the product data.

Adding this dimension to the product might look like this:

ga('ec:addProduct', {               // Provide product details in an productFieldObject.
  'id': 'P12345',                   // Product ID (string).
  'name': 'Powerup',                // Product name (string).
  'category': 'Extras',             // Product category (string).
  'variant': 'red',                 // Product variant (string).
  'price': '10.00',                 // Product price (currency).
  'quantity': 2,                    // Product quantity (number).
  'dimension4': 'strong'            // Product-scoped custom dimension (string).
});
ga('ec:setAction', 'purchase', {
  'id': 'T12345',
  'revenue': '20.00'
});

ga('send', 'pageview');     // Send transaction data with initial pageview.

In this example, the custom dimension is set along with the product information. This associates the strength with this Powerup.

Processing

As in previous examples, after the hits are collected and sent to Analytics, the data is processed and custom dimension values are applied to products they were set with.

For example, the data collected for a single player, with one session, who purchased 3 powerups, looks like this:

userId = 5555
Session 1:
H1: product_name=powerup cd4_value=weak
    product_name=powerup cd4_value=strong
H2: product_name=powerup cd4_value=weak

Note that using product-level scope ensures each powerup value is only associated with the product with which it was set.

Reporting

Once processed, because each product is associated with its respective strength value, a developer can create a custom report that shows revenue by Powerup Strength:

Powerup Strength Product Revenue
weak 20.00
strong 10.00

In this report, weak powerups contributed the most revenue.

Custom metrics

Scope

Similar to custom dimensions, custom metrics can have different scopes. Hit-level custom metrics get associated with all the hit-level dimensions with which they were sent. Similarly, product-level custom metrics are associated only with the products with which they were sent. The following examples illustrate these two types of custom metrics.

Hit-Scoped Custom Metric Example

In the examples above, the game developer has been tracking each play of a level as a screen view. In each of the reports generated, the screen view metric is used to represent a player's attempt to complete a level.

However, the developer also wants to know the completion rate of each level.

To determine the rate of completion, the developer will use a new custom metric called Level Completions and compare it to screen views for each level.

The report the developer wants looks like this:

Screen name Screen views Level Completions
/level_1/    
/level_2/    
/level_3/    

Why use a custom metric?

In many cases, you'll have the option to use events, screen views, and/or a custom metric to track your most important metrics. However, custom metrics can produce more flexible and more readable custom reports and as such are a convenient way to track your most important metrics.

In this example, level completions could not be tracked as a screen view without double counting the number of screen views per level, so you'd want to find another option.

Although an event could be used on its own, due to their hierarchical nature it would be difficult to build the above report combining screen views and level completions under a single dimension.

Due to the above limitations, and because level completions is such an important metric to this developer, it's most convenient to track level completions as a custom metric.

Configuration

The Level Completions custom metric is defined in the management section of the user interface with these values:

Index 1
Name Level Completions
Scope Hit
Formatting Type Integer
Active true

Collection

The developer is already tracking the start of each level using a screen view. Now they want to track a level completion using the new custom metric.

As with custom dimensions, custom metrics are sent to Analytics as parameters attached to other hits. In order to send the custom metric value, the developer will also need to send an additional hit to record the user completing a level. In this example an event will be fired once the level is completed and a custom metric will be associated with this event.

That implementation might look like this:

ga('create', 'UA-XXXX-Y', 'auto');

// Increment the level completion metric by 1.
ga('set', 'metric1', 1 );

// Send the custom metric value with an event hit.
ga('send', 'event', 'Level', 'completion');

Processing

Before processing, the data for a single player who plays three levels in the game in a single session would look like this:

userId = 5555
Session 1
H1: type=screen_view screen_name=/level_1/
H2: type=event screen_name=/level_1/ cm1_value=1
H3: type=screen_view screen_name=/level_2/
H4: type=screen_view screen_name=/level_2/
H5: type=screen_view screen_name=/level_2/
H6: type=event screen_name=/level_2/ cm1_value=1
H7: type=screen_view screen_name=/level_3/
H8: type=event screen_name=/level_3/ cm1_value=1

Reporting

After processing, the developer can create a report that uses screen name as the dimension and screen views, total events, and level completions as the metric:

Screen name Screen views Total Events Level Completions
/level_1/ 1 1 1
/level_2/ 3 1 1
/level_3/ 1 1 1

Since the developer has tracked level completions as a custom metric, it eliminates any future need to filter the completion events from the total events.

Instead, the developer can easily create the following custom report using the Level Completions custom metric:

Screen name Screen views Level Completions
/level_1/ 1 1
/level_2/ 3 1
/level_3/ 1 1

The data suggests that level 2 is actually more difficult relative to levels 1 and 3, as it only has a 33% completion rate based on screen views. By tracking level completions as a custom metric, the developer is able to easily answer questions about key metrics and create simplified reports to share with others.

Product-Scoped Custom Metric Example

In the examples above, the game developer has been tracking each purchase of a powerup. There are a number of metrics that can be associated with each purchase, such as quantity and product revenue.

However, the game developer recently ran a promotion, giving all users a $100 credit. The game developer wants to measure which powerups people are buying with their credit.

To determine the credits used per product purchase, the developer will use a new custom metric called Credits Used.

The report the developer wants looks like this:

Powerup Strength Product Revenue Credits Used
strong    
medium    
weak    

Configuration

The Credits Used custom metric is defined in the Admin section with these values:

Index 2
Name Credits Used
Scope Product
Formatting Type Integer
Active true

Collection

As with product-level custom dimensions, product-level custom metrics are sent to Analytics as parameters attached to the product data.

That implementation might look like this:

ga('ec:addProduct', {               // Provide product details in an productFieldObject.
  'id': 'P12345',                   // Product ID (string).
  'name': 'Powerup',                // Product name (string).
  'category': 'Extras',             // Product category (string).
  'variant': 'red',                 // Product variant (string).
  'price': '10.00',                 // Product price (currency).
  'quantity': 2,                    // Product quantity (number).
  'dimension4': 'strong',           // Product-scoped custom dimension (string).
  'metric2': 5                      // Product-scoped custom metric (integer).
});
ga('ec:setAction', 'purchase', {
  'id': 'T12345',
  'revenue': '20.00'
});

ga('send', 'pageview');     // Send transaction data with initial pageview.


Processing

Before processing, the data for a single player who purchases some powerups might look like this:

userId = 5555
Session 1
H1: type=screen_view screen_name=/level_1/
H2: type=screen_view screen_name=/level_2/
    product_name=powerup cd4_value=weak cm2_value=5
    product_name=powerup cd4_value=strong cm2_value=5
H4: type=screen_view screen_name=/level_2/
    product_name=powerup cd4_value=medium cm2_value=1
    product_name=powerup cd4_value=weak cm2_value=10

Reporting

After processing, the developer can create a report that uses Powerup Strength as the dimension and Product Revenue and Credits Used as the metric:

Powerup Strength Product Revenue Credits Used
weak 20 15
strong 10 5
medium 10 1

The data suggests that players are using their credits on weak powerups. The developer made the most profit on medium powerups.

Implementation considerations

When implementing custom dimensions or metrics, keep the following in mind:

Editing an existing dimension or metric

When you edit the name or scope of an existing custom dimension or metric, your data can be affected in the following ways:

  • Editing name: affects data that has already been processed. Old data will only be accessible using the new name.
  • Editing scope: does not affect data that has already been processed. Only new data will be processed using the new scope.
  • Changing active state: the active field determines whether custom dimension or metric values are actually processed. Note that when active is false, custom dimension or metric will still appear in your reporting, but because its values were not processed, it will not have any associated data.

Plan ahead when setting scope

When deciding which scope to use for a particular custom dimension, consider how often you expect the value to change. If it's a value that might change many times during a session, like the name of a level in a game, use hit scope and set the value before each hit. On the other hand, a custom dimension like gender could be set at the user level just once. Sending a gender value with each hit would require an unnecessary amount of work, and configuring a custom dimension that changes often with user scope would incorrectly associate many hits with that value.

Was this helpful?

How can we improve it?
true
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!

Search
Clear search
Close search
Google apps
Main menu