agentleFS
kastriasanikastriasani/google-ads-skills/skills/google-ads-bidding/SKILL.md

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

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
  1. Very specific:

    If the request is to forecast results or size a budget, use google-ads-forecast.

    line 28
  2. Very specific:

    If it is to design an experiment to test a bid change, use google-ads-ab-testing.

    line 29
  3. Very specific:

    Get the recommendation: Run scripts/bid_strategy_advisor.py --conversions-30d 90 --value-tracking yes --goal roas --roas-target 5 --margin …

    line 37
  4. Very specific:

    Sanity-check the target against economics: Run scripts/roas_calculator.py to confirm break-even ROAS (100 / margin) and current CPA/ROAS, …

    line 45
  5. Very specific:

    Allocate the budget: When several campaigns compete for one budget, run scripts/budget_mix_optimizer.py --input mix.json (or --demo).

    line 49

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

  1. 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.
  2. 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. See references/bid-strategies.md for the full progression and per-strategy detail.
  3. Sanity-check the target against economics. Run scripts/roas_calculator.py to 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.
  4. 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).
  5. Handle bid adjustments correctly. Most percentage modifiers are ignored under Smart Bidding - the algorithm bids per auction. Use references/bid-adjustments.md to know what still applies (notably -100% exclusions and audience Observation signals) and avoid wasting effort tuning inert modifiers.
  6. 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 --json output 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.