Run a Google Ads campaign A/B experiment with the Experiment and ExperimentArm resources

domain: developers.google.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create the experiment shell with ExperimentService.MutateExperiments: type, suffix, status SETUP, and start_date/end_date, without referencing any campaigns yet.
  2. In one MutateExperimentArms call, create exactly one control arm (control=true, referencing the base campaign) and one or more treatment arms, with traffic_split values summing to 100 — this call has no partial-failure support.
  3. Query experiment_arm.in_design_campaigns with include_drafts=true to get each treatment arm's auto-created draft campaign, then mutate that draft campaign to apply your test change.
  4. Call ExperimentService.ScheduleExperiment, an async long-running operation, to materialize the draft into a live, serving campaign at start_date.
  5. Monitor performance via standard reporting, then call EndExperiment (sync) to stop it, PromoteExperiment (async) to apply the treatment to the control, or GraduateExperiment (sync) to spin the treatment off as an independent campaign.

Known gotchas

Related routes

Create a Microsoft Advertising Responsive Search Ad and run an A/B experiment via the Campaign Management API
learn.microsoft.com/en-us/advertising/campaign-management-service · 6 steps · unrated
Create a Google Ads campaign via the API (budget, campaign, ad group)
developers.google.com/google-ads/api · 6 steps · unrated
Create a Google Ads Performance Max campaign via the API
developers.google.com/google-ads/api · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans