Google Ads

Propose a budget reallocation (writes nothing)

Produces a plan for moving budget between campaigns, based on what each one currently returns and whether it is actually budget-limited. It changes nothing. Applying any line of the plan means calling google_update_campaign_budget for that campaign, which the user approves separately. Use when: the user asks where their money should go and several campaigns have enough data to compare. Do not use when: campaigns have very different objectives (brand versus prospecting), or when a campaign has fewer than about 15 conversions in the window — the comparison is then noise dressed up as arithmetic. Say that instead of producing a plan. The heuristic: rank campaigns by cost per conversion (or by ROAS when you ask for value), raise the efficient ones that are spending their budget, lower the inefficient ones, cap every move at max_change_percentage, never go below min_daily_budget, and keep the account total the same unless you ask otherwise. Proposed budgets are whole multiples of the smallest amount Google bills in the account currency (a whole yen or won, a cent for most others), so any line can be applied exactly as shown. A campaign that is not spending its budget will not spend more just because the budget goes up: the plan says so rather than proposing a rise. If you are unsure which account, campaign or period the user means, ask them — do not guess ids or dates.

post/api/v1/tools/google_optimize_budget_allocation/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/google_optimize_budget_allocation/execute
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional 8-128 character key. A successful envelope is cached for 24 hours; replaying the key with the same arguments returns it again with Idempotent-Replayed: true, and replaying it with different arguments answers 409.

Request body

Response

The tool ran. A write returns proposal_id and approve_url while the change waits for approval.

successunknown required
toolstring required
dataobject required

Machine-readable result.

markdownstring required

The same result written for a person or a model.

proposal_idstring

Present for writes. Nothing changes on the ad platform until it is approved.

approve_urlstring

Where a person approves the proposal.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.