update_conversion_goal
Update a Microsoft Advertising conversion goal by specifying only the fields to change. Control bidding inclusion, status, revenue model, and lookback window.
Instructions
Update a conversion goal in place. Only the fields you pass change.
The key bidding lever is exclude_from_bidding — the inverse of the web UI's "Include in
conversions" checkbox. exclude_from_bidding=false keeps the goal in the Conversions
column and in automated-bidding math (ECPC / tCPA); true drops it from both (it still
reports under All conversions). Confirm this is false before relying on a goal to steer
spend. Read the current values first with get_conversion_goals.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | New goal name (rename). | |
| status | No | "Active" or "Paused" (a paused goal stops recording conversions). | |
| goal_id | Yes | The conversion goal id (from get_conversion_goals). | |
| count_type | No | How conversions are counted per click — "All" (every conversion) or "Unique" (one per click). | |
| revenue_type | No | Conversion value model — "FixedValue" (same value each time, requires revenue_value), "VariableValue" (value sent with the event), or "NoValue". Revenue fields are merged onto the goal's current revenue, so you can change one without re-stating the others. | |
| revenue_value | No | Revenue amount (required for "FixedValue"; the default for "VariableValue"). | |
| exclude_from_bidding | No | false = include the goal in the Conversions column and automated bidding; true = exclude it from both (still tracked under All conversions). | |
| revenue_currency_code | No | ISO currency code for the revenue value, e.g. "USD". | |
| conversion_window_in_minutes | No | Click-to-conversion lookback window in minutes (e.g. 43200 = 30 days). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| ids | No | ||
| message | Yes | ||
| partial_errors | No |