How to Add Custom Definitions in your GA4 Property How to Add Custom Definitions in your GA4 Property

How to Add Custom Definitions in your GA4 Property

Apps creator apps send Platform Name and Event Label with each logged Event to your GA4 property. However, to access those in your GA4 property you need to create two Custom Definitions in your GA4 account.

Follow the below steps to add these Custom Definitions:

Step 1: Login to your linked Google Analytics Account.

Step 2: Click on the cog wheel icon in the bottom left corner of the home page.

Screenshot 2023-02-17 at 2.05.26 PM.png

Step 3: Click on Custom Definitions, as shown in the screenshot below.

Screenshot 2023-02-17 at 2.08.29 PM.png

Step 4: Click on Create Custom Dimension, to create a new Dimension.

Screenshot 2023-02-17 at 2.10.53 PM.png

Step 5: Enter the Name as "EventLabel", the Scope as "Event" and the Event Parameter as "Label", and click Save.

Screenshot 2023-02-17 at 2.15.13 PM (1).png

Step 6: Now create another Custom Dimension with the following values and save:
Event Name: PlatformType
Scope: Event
Event Parameter: Platform_Type

Screenshot 2023-02-17 at 2.18.53 PM (1).png

Step 6: Next, create 3 more Custom Dimensions with the following values and save, similar to the previous three steps. Keep in mind that these Custom Dimensions will have a Scope of User instead of Event:

  1. Event Name: App Name
    Scope: User
    Event Parameter: app_name

  2. Event Name: App Version
    Scope: User
    Event Parameter: app_version

  3. Event Name: Platform Name
    Scope: User
    Event Parameter: platform_name

  4. Event Name: Profile_Id
    Scope: Event
    Event Parameter: Profile_Id

After completing these steps, your Custom Definitions should look like this:

Screenshot 2024-02-06 at 5.11.21 PM.png


You have successfully created the custom definitions for Platform Type and Event Labels. This can take up to 24 hours to take effect in your GA4. After 24 hours, you will be able to see these custom dimensions when exploring individual Event types under Events.

Screenshot 2023-02-17 at 2.22.52 PM.png

Important Note:

Data in these Custom Definitions will start populating from the date they become active in your GA4 property, any historical data will not be shown under these custom definitions. Therefore, it is recommended that you create these custom definitions while initial setup of your GA4 property.