Plan a GA4 custom dimension
ga4_plan_custom_dimension_createPlan registering a custom dimension on a GA4 property to track event, user, or item parameters before applying changes. Checks required names, scope, and quota limits without writing data.
Instructions
PLAN (nothing is written): register a custom dimension on the client's GA4 property. Warning: parameterName and scope are immutable and the slot counts against the quota (50 event / 25 user / 10 item). Apply with google_apply after the user agreed. No automatic rollback (archiving is not offered).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"parameter_name": "<parameter_name>",
"display_name": "<display_name>"
},
"name": "ga4_plan_custom_dimension_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scope | No | Scope (can never be changed later) | EVENT |
| client_id | No | Client id from clients_list. Required when several clients are registered; empty uses the only client | |
| description | No | Optional description, 150 characters at most | |
| property_id | No | Numeric GA4 property id of the client (empty: the configured one) | |
| display_name | Yes | Name shown in GA4 reports | |
| parameter_name | Yes | Event or user parameter to register, e.g. payment_type (can never be changed later) | |
| disallow_ads_personalization | No | USER scope only: exclude it from ads personalization |