> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Bid Strategy

> Create, update or delete a Microsoft Ads portfolio (shared) bid strategy: name, type and targets such as target ROAS, target CPA or max CPC

Create, update or delete a Microsoft Ads portfolio (shared) bid strategy: name, type and targets such as target ROAS, target CPA or max CPC. Campaigns in a portfolio can only change their bidding here.

|                       |                                     |
| --------------------- | ----------------------------------- |
| **App**               | Microsoft Ads                       |
| **Operation ID**      | `microsoft_ads_manage_bid_strategy` |
| **Type**              | Action                              |
| **Connection**        | `microsoft_ads` (required)          |
| **Credits per run**   | 1                                   |
| **Agent / MCP tool**  | Yes                                 |
| **Requires approval** | Yes (write operation)               |

## Inputs

| Field                      | Type                                                                      | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| -------------------------- | ------------------------------------------------------------------------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`                  | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes      | -       | Select the Microsoft Ads account that owns the portfolio (shared) bid strategy.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `action`                   | string or SelectableOption                                                | Yes      | -       | 'create': add a new portfolio bid strategy (needs name and bidding\_strategy\_type). 'update': change the name or settings of an existing one (needs bid\_strategy\_id; the strategy type itself cannot be changed). 'delete': remove one (needs bid\_strategy\_id). To move campaigns in or out of a portfolio, use microsoft\_ads\_update\_campaign\_bidding\_strategy with portfolio\_bid\_strategy\_id.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `bid_strategy_id`          | integer or string                                                         | No       | -       | ID of the portfolio bid strategy to update or delete. Get it from microsoft\_ads\_list\_bid\_strategies or a campaign's bid\_strategy\_id.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `name`                     | string                                                                    | No       | -       | Name of the portfolio bid strategy, unique within the account (max 255 characters). Required for create.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `bidding_strategy_type`    | string or SelectableOption                                                | No       | -       | Portfolio bid strategy type, sent as the Microsoft technical value. Required for create. On update it is read from the strategy automatically, and settings you do not pass are kept, so only send the values to change. Microsoft does not report the type of MaxConversions portfolios, so for those pass bidding\_strategy\_type together with the settings. 'MaxClicksBiddingScheme': maximize clicks (Search, Shopping); optional max\_cpc. 'MaxConversionsBiddingScheme': maximize conversions (Search); optional target\_cpa and max\_cpc. 'MaxConversionValueBiddingScheme': maximize conversion value; optional target\_roas and max\_cpc. 'TargetImpressionShareBiddingScheme' (Search): needs target\_ad\_position and target\_impression\_share, optional max\_cpc. 'TargetCpaBiddingScheme' and 'TargetRoasBiddingScheme': target CPA / target ROAS as listed by Microsoft for portfolios; use target\_cpa / target\_roas. |
| `associated_campaign_type` | string or SelectableOption                                                | No       | -       | Campaign type the portfolio accepts: 'Search' (default) or 'Shopping'. Create only; cannot be changed later.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `max_cpc`                  | number or string                                                          | No       | -       | Maximum cost-per-click cap in account currency.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `target_cpa`               | number or string                                                          | No       | -       | Target cost-per-action in account currency.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `target_roas`              | number or string                                                          | No       | -       | Target return on ad spend as a multiplier (e.g. 4.2 = 420%).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `target_ad_position`       | string or SelectableOption                                                | No       | -       | Page position for TargetImpressionShare: 'FirstPage', 'MainLine' (top block), or 'MainLine1' (very first ad).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `target_impression_share`  | number or string                                                          | No       | -       | Target impression share percentage from 1 to 100 (e.g. 65 = 65%). For TargetImpressionShare.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

### MicrosoftAdsAccountItem

| Field        | Type   | Required | Default | Description                                                                                                     |
| ------------ | ------ | -------- | ------- | --------------------------------------------------------------------------------------------------------------- |
| `value`      | string | Yes      | -       |                                                                                                                 |
| `label`      | string | Yes      | -       |                                                                                                                 |
| `customerId` | string | No       | -       | The Microsoft Ads customer ID used for REST CustomerId headers. If omitted, it is resolved from the account ID. |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `Dict`

Returns the action, bid\_strategy\_id, a message and the bid strategy as stored after the change.

**Fields**: `action`, `bid_strategy_id`, `message`, `bid_strategy`