account | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes | - | Select the Microsoft Ads account that owns the campaigns to update. |
update_type | string or SelectableOption | Yes | - | Choose whether to update the bidding strategy of a single campaign or multiple campaigns at once. Options: ‘single’ or ‘bulk’. |
campaign_id | string or SelectItem | No | - | The campaign ID whose bidding strategy to update. Required for single update. |
bidding_strategy_type | string or SelectableOption | No | - | Bidding strategy (bid scheme) to set, sent as the Microsoft technical value. ‘EnhancedCpcBiddingScheme’: manual bids auto-adjusted toward conversions. ‘ManualCpcBiddingScheme’: manual cost-per-click. ‘ManualCpmBiddingScheme’: manual cost-per-thousand-impressions. ‘ManualCpvBiddingScheme’: manual cost-per-view (video). ‘MaxClicksBiddingScheme’: maximize clicks within budget; optional max_cpc cap. ‘MaxConversionsBiddingScheme’: maximize conversions; optional target_cpa and max_cpc. ‘MaxConversionValueBiddingScheme’: maximize conversion value; optional target_roas and max_cpc. ‘TargetImpressionShareBiddingScheme’: hit an impression share at a page position; needs target_ad_position and target_impression_share, optional max_cpc. ‘PercentCpcBiddingScheme’: bid a percent of price (used by hotel/commission campaigns); uses max_percent_cpc. ‘CommissionBiddingScheme’: pay a commission percentage per conversion; uses commission_rate. ‘CostPerSaleBiddingScheme’: pay per sale; uses target_cost_per_sale. ‘ManualCpaBiddingScheme’: manual cost-per-acquisition; uses manual_cpi. Required for single update. |
max_cpc | number or string | No | - | Maximum cost-per-click cap in account currency. Optional for MaxClicks, MaxConversions, MaxConversionValue, and TargetImpressionShare. |
target_cpa | number or string | No | - | Target cost-per-action in account currency. Used by MaxConversions. |
target_roas | number or string | No | - | Target return on ad spend as a multiplier (e.g. 3.5 = 350%). Used by MaxConversionValue. |
target_ad_position | string or SelectableOption | No | - | Where on the search results page to target, for TargetImpressionShare. ‘FirstPage’: anywhere on the first page. ‘MainLine’: the top block of ads on the first page. ‘MainLine1’: the very first ad on the first page. |
target_impression_share | number or string | No | - | Target impression share percentage from 1 to 100 (e.g. 65 = 65%). Used by TargetImpressionShare. |
max_percent_cpc | number or string | No | - | Maximum percent CPC (percentage of the product/booking price). Used by PercentCpc. |
commission_rate | number or string | No | - | Commission rate percentage paid per conversion. Used by Commission. |
target_cost_per_sale | number or string | No | - | Target cost per sale in account currency. Used by CostPerSale. |
manual_cpi | number or string | No | - | Manual cost-per-acquisition bid in account currency. Used by ManualCpa. |
portfolio_bid_strategy_id | integer or string | No | - | Portfolio (shared) bid strategy ID to attach the campaign to; get IDs from microsoft_ads_list_bid_strategies. Pass 0 to detach the campaign from its portfolio, together with the campaign-level bidding_strategy_type to fall back to. Campaigns inside a portfolio cannot change bidding settings directly; update the portfolio with microsoft_ads_manage_bid_strategy instead. |
structured_data | array (also accepts a comma-separated string) | No | - | Structured data for bulk update. Required columns: ‘campaign_id’ plus ‘bidding_strategy_type’ and/or ‘portfolio_bid_strategy_id’ (0 detaches). Optional columns by strategy: ‘max_cpc’, ‘target_cpa’, ‘target_roas’, ‘target_ad_position’, ‘target_impression_share’, ‘max_percent_cpc’, ‘commission_rate’, ‘target_cost_per_sale’, ‘manual_cpi’. Required for bulk update. |
