google-ads-bidding
Skill1 starsChanged 5 months agoMITView on GitHub
Recommend the right Google Ads Smart Bidding strategy and target with guardrails, and allocate budget across campaigns for the best return. Use this whenever someone asks which bid strategy to use, whether to switch to Target CPA or Target ROAS, how to set a tCPA or tROAS target, whether to use Maximize Conversions or Maximize Conversion Value, how to move off Manual CPC, why a Smart Bidding campaign is underperforming or stuck in learning, how to set bid adjustments or device/location/schedule modifiers, or how to split a budget across campaigns to maximize conversions or value. Triggers include bid strategy, Smart Bidding, automated bidding, tCPA, tROAS, target CPA, target ROAS, Maximize Conversions, Maximize Conversion Value, Manual CPC, bid adjustment, bid modifier, budget allocation, and learning period. Runs standalone on pasted numbers; optional Google Ads API and GA4 sharpen it.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- scumunna/programmatic-skillstheir own version, first seen Jul 3, 2026
- eliasmalmsandberg/google-ads-skillstheir own version, first seen Mar 14, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- eliasmalmsandberg/google-ads-skills★ 14same name
- scumunna/programmatic-skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository13 other files it gives its agents.
- google-ads-ab-testingSkill
- google-ads-ad-copySkill
- google-ads-auditSkill
- google-ads-campaign-setupSkill
- google-ads-competitor-intelSkill
- google-ads-forecastSkill
- google-ads-funnelSkill
- google-ads-keyword-researchSkill
- google-ads-media-planSkill
- google-ads-presentationSkill
- google-ads-reportingSkill
- google-ads-researchSkill
- google-ads-roastSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 0 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 28
If the request is to forecast results or size a budget, use google-ads-forecast.
- Very specific: line 29
If it is to design an experiment to test a bid change, use google-ads-ab-testing.
- Very specific: line 37
Get the recommendation: Run scripts/bid_strategy_advisor.py --conversions-30d 90 --value-tracking yes --goal roas --roas-target 5 --margin …
- Very specific: line 45
Sanity-check the target against economics: Run scripts/roas_calculator.py to confirm break-even ROAS (100 / margin) and current CPA/ROAS, …
- Very specific: line 49
Allocate the budget: When several campaigns compete for one budget, run scripts/budget_mix_optimizer.py --input mix.json (or --demo).
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Google Ads Bidding
Pick the bid strategy and target that match the data the account actually has, set the right number, and attach the guardrails that stop common, expensive mistakes - tROAS with no value tracking, tCPA on five conversions a month, Broad match on Manual CPC. Then split the budget across campaigns toward the best return.
When to use
Reach for this skill when the user wants to:
- Choose or change a bid strategy (Manual CPC, Maximize Clicks, Maximize Conversions, Target CPA, Maximize Conversion Value, Target ROAS).
- Decide whether they have enough data to move to tCPA or tROAS, and what target to set.
- Diagnose a Smart Bidding campaign that is underperforming or stuck in learning.
- Set or rationalise bid adjustments (device, location, schedule, audience).
- Allocate a fixed budget across campaigns to maximise conversions or value.
If the request is to forecast results or size a budget, use google-ads-forecast.
If it is to design an experiment to test a bid change, use google-ads-ab-testing.
Workflow
- Establish the data you have. You need: conversions in the trailing 30 days, whether conversion value is tracked, the goal (CPA or ROAS), the gross margin, and account/campaign maturity. These determine which strategies can even learn.
- Get the recommendation. Run
scripts/bid_strategy_advisor.py --conversions-30d 90 --value-tracking yes --goal roas --roas-target 5 --margin 30 --maturity established(or--demo). It returns the recommended strategy, the exact target to set, the rationale, the break-even ROAS, and hard guardrails. It enforces the thresholds: ~30 conversions/30d for Target CPA, ~50 plus value tracking for Target ROAS, and refuses to recommend tROAS without value tracking. Seereferences/bid-strategies.mdfor the full progression and per-strategy detail. - Sanity-check the target against economics. Run
scripts/roas_calculator.pyto confirm break-even ROAS (100 / margin) and current CPA/ROAS, so any tCPA or tROAS you set clears break-even and ideally sits at 1.5-2x it to fund growth. - Allocate the budget. When several campaigns compete for one budget, run
scripts/budget_mix_optimizer.py --input mix.json(or--demo). It scores each campaign on ROAS and effective (LTV-adjusted) ROAS, recommends a split under hard constraints (a floor on brand/defensive spend, a ceiling on concentration), and runs sensitivity scenarios (CPCs up, non-brand CVR down, learning under-delivery). - Handle bid adjustments correctly. Most percentage modifiers are ignored under
Smart Bidding - the algorithm bids per auction. Use
references/bid-adjustments.mdto know what still applies (notably -100% exclusions and audience Observation signals) and avoid wasting effort tuning inert modifiers. - Deliver with guardrails. State the strategy, the target value, why, and the guardrails: do not pair Broad match with Manual CPC; expect a 1-2 week learning period after any switch or 20%+ target change; move targets 10-20% at a time; reallocate budget gradually so campaigns do not re-enter learning.
Inputs and data sources
Runs standalone: paste the numbers or hand the scripts a small JSON. Each script has
a --demo mode and a --json flag for piping output into a report or sheet.
Optional sources that improve accuracy:
- Google Ads API / UI - conversions/30d, current CPA and ROAS, bid strategy and status, learning-period state, per-campaign spend and value.
- GA4 - conversion-value accuracy, assisted conversions, and offline-conversion imports so Smart Bidding optimises to revenue, not raw leads.
- Google Sheets / BigQuery - hold campaign inputs and pipe
--jsonoutput into a budget-allocation model.
Outputs
- A recommended bid strategy with the exact target to set and the rationale.
- Hard guardrails (data thresholds, things not to combine, learning-period rules).
- Break-even ROAS and a target-sanity check against margin.
- A constrained budget split across campaigns with sensitivity scenarios.
- Correct, strategy-aware bid-adjustment guidance.
References
references/bid-strategies.md- each strategy: when to use it, the data it requires, and how to set its target, plus the full progression.references/bid-adjustments.md- device/location/schedule/audience modifiers and how Smart Bidding overrides or honours each.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

