account | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes | - | Select the Microsoft Ads account to create a campaign in. |
campaign_name | string | Yes | - | Name for the new campaign. |
campaign_type | string or SelectableOption | Yes | - | Campaign type. Supported values: Search or PerformanceMax. |
status | string or SelectableOption | No | {'value': 'PAUSED', 'label': 'Paused'} | Initial campaign status. Default: PAUSED. |
daily_budget | number | Yes | - | Daily budget in the account currency, for example 50 for $50. |
locations | string or array of string or integer or SelectableOption | Yes | - | Microsoft Ads location IDs to target. Pass a comma/newline-separated string or a list. Use microsoft_ads_search_locations to find IDs. |
languages | string or array of string or SelectableOption | No | ['All'] | Campaign ad languages. Use Microsoft language names such as English, Arabic, or All. Default: All. |
bidding_strategy_type | string or SelectableOption | No | {'value': 'MaxConversionsBiddingScheme', 'label': 'Maximize Conversions'} | Bidding strategy for the campaign. |
max_cpc | number or string | No | - | Maximum CPC cap in account currency. Optional for MaxClicks, MaxConversions, MaxConversionValue, and TargetImpressionShare. |
target_cpa | number or string | No | - | Optional target CPA in account currency. Used by MaxConversions. |
target_roas | number or string | No | - | Optional target ROAS multiplier, for example 3.5 for 350%. Used by MaxConversionValue. |
target_ad_position | string or SelectableOption | No | - | Target ad position for TargetImpressionShare. |
target_impression_share | number or string | No | - | Target impression share percentage, 1 to 100. Used by TargetImpressionShare. |
goal_ids | string or array of string or integer | No | - | Optional Microsoft Ads conversion goal IDs. Recommended when using MaxConversions or MaxConversionValue bidding. |
geo_target_type | string or SelectableOption | No | {'value': 'PRESENCE_OR_INTEREST', 'label': 'Presence or Interest'} | Location intent option. Default: PRESENCE_OR_INTEREST. |
start_date | integer or string | No | - | Optional campaign start date as YYYY-MM-DD or Unix timestamp. |
end_date | integer or string | No | - | Optional campaign end date as YYYY-MM-DD or Unix timestamp. |
final_url_expansion_opt_out | boolean | No | True | If false, Microsoft can expand final URLs automatically. Default: true. |
auto_generated_image_opt_out | boolean | No | True | If false, Microsoft can generate image assets automatically. Default: true. |
auto_generated_text_opt_out | boolean | No | True | If false, Microsoft can generate and customize text assets automatically. Default: true. |
ai_search_enabled | boolean | No | False | Search campaigns only. Whether to enable AI Max or not. Default: false. |
search_term_matching_opt_out | boolean | No | True | Search campaigns only. If false, Microsoft can use AI search term matching. Default: true. |