Accounts
PUT /api/v1/accounts/{projectId}/optimization-targets
Replace the account's optimization objective.
PUT /api/v1/accounts/{projectId}/optimization-targetsReplace the account's optimization objective.
Admin-tier because these targets drive the optimization plan, the recommendation engine, and the safe-apply policy's judgement about whether a budget raise is safe. Changing them changes what the system will do unattended.
Requires a key with admin scope.
Returns 200 on success.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
projectId | path | string | yes | The Google Ads account, as returned by GET /api/v1/accounts. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
target_daily_spend_micros | object | no | Default: null. |
target_roas | object | no | ROAS floor as a ratio: 1.5 = 150%. Default: null. |
target_cpa_micros_min | object | no | Default: null. |
target_cpa_micros_max | object | no | Default: null. |
explore_share | object | no | Share of the daily spend goal reserved for unproven silos, as a ratio: 0.1 = 10%. null uses the 10% default; 0 turns exploration off. Default: null. |
Example
curl -X PUT "https://bidandscale.com/api/v1/accounts/{projectId}/optimization-targets" \
-H "Authorization: Bearer $BIDANDSCALE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ … }'