Manage Custom Dimensions - Markifact

Creates a Google Analytics 4 custom dimension from an event parameter, user property or item parameter, updates its display name or description, or archives it. Custom dimensions cannot be deleted, only archived.


App	GA4
Operation ID	`ga4_manage_custom_dimensions`
Type	Action
Connection	`ga4` (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
`account`	array (also accepts a comma-separated string)	No	-	The GA4 property to change. Only one property at a time.
`action`	string or SelectableOption	Yes	-	‘create’ registers an event parameter, user property or item parameter as a custom dimension so it appears in reports; ‘update’ changes its display name or description; ‘archive’ retires it (custom dimensions cannot be deleted). Options: ‘create’, ‘update’, ‘archive’.
`parameter_name`	string	Yes	-	The event parameter, user property or item parameter name as sent in the tag, e.g. ‘plan_type’. Cannot be changed after creation.
`display_name`	string	No	-	Name shown in GA4 reports, e.g. ‘Plan Type’. Required on create.
`scope`	string or SelectableOption	No	-	‘EVENT’ for event parameters (default), ‘USER’ for user properties, ‘ITEM’ for e-commerce item parameters. Cannot be changed after creation.
`description`	string	No	-	Optional description shown in the GA4 admin.
`disallow_ads_personalization`	boolean	No	-	USER scope only: exclude this dimension from ads personalization.

SelectableOption

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-

Output

Type: Dict Returns the saved custom dimension: id, parameter name, display name and scope. Fields: property_id, status, custom_dimension_id, parameter_name, display_name, scope