Manage Bid Strategy - Markifact

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