Manage Experiment - Markifact

Run the lifecycle of a Google Ads campaign experiment: schedule it to start, end it early, or promote the winning treatment to the base campaign. Experiments and their arms are created with gads_mutate; this operation covers the lifecycle actions gads_mutate cannot perform


App	Google Ads
Operation ID	`gads_manage_experiment`
Type	Action
Connection	`gads` (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
`account`	GadsAccountItem or object or array of object or string or integer	Yes	-	Select the Google Ads account, ask the user for it if not provided
`action`	string or SelectableOption	Yes	-	Lifecycle action for the experiment. Options: ‘SCHEDULE’ (materialize the treatment campaign and start the experiment), ‘END’ (stop a running experiment before its end date), ‘PROMOTE’ (apply the winning treatment changes to the base campaign)
`experiment_id`	string	Yes	-	The experiment to act on, as a numeric experiment ID or a full resource name like ‘customers/1234567890/experiments/987654’. The experiment and its arms are typically created beforehand with gads_mutate (experimentOperation and experimentArmOperation)
`validate_only`	boolean	No	`False`	When true, validates the request without executing the action. Only errors are returned

GadsAccountItem

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-
`managerId`	string	Yes	-	The manager ID for the Google Ads account. Ask user to use the dropdown to select accounts, this manager id is selected background and not shown to the user.

SelectableOption

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

Output

Type: Dict Returns the experiment and the initiated lifecycle action. Fields: action, experiment_id, resource_name