Microsoft Advertising tools

Microsoft Advertising ad accounts the connected user can access (id, name, number, customer_id, currency, status) and which one is selected. Use it in manager/agency setups before writing. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

This tool takes no parameters.

Ad groups of a Microsoft Advertising campaign (id, name, status, default CPC bid). Use the ids for keywords, ads and ad-group-level targeting. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

Audiences in the Microsoft Advertising account (remarketing lists, in-market, custom) with sizes and UET tag. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

This tool takes no parameters.

Conversion goals of the Microsoft Advertising account with type, status, tracking status, category, revenue settings. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

This tool takes no parameters.

UET (Universal Event Tracking) tags of the Microsoft Advertising account with tracking status and script. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

This tool takes no parameters.

Microsoft Advertising search terms (queries that triggered ads) with spend, clicks, conversions, keyword and match type for the last N days, plus the wasted (zero-conversion) terms. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

Microsoft Advertising performance by campaign, ad group or device (spend, clicks, impressions, conversions, revenue, CTR, CPC, CPA, ROAS) with totals; compare_previous adds the prior period. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

Choose which Microsoft Advertising ad account all further reads and writes use (manager/agency setups). Local setting; nothing is changed on Microsoft.

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a Microsoft Advertising search campaign DRAFT with its ad groups, keywords and responsive search ad copy in one go (e.g. replicate a Google Ads structure). The whole structure is shown as a preview; after approval it is created PAUSED on Microsoft. Go live with update_microsoft_campaign_status(resume). Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Add an ad group to an existing Microsoft Advertising campaign, optionally with keywords and a responsive search ad (headlines + descriptions + final_url). Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Add keywords (text, match type BROAD|PHRASE|EXACT, optional bid) to a Microsoft Advertising ad group. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Add negative keywords to a Microsoft Advertising campaign (or ad group). Microsoft supports PHRASE and EXACT negatives. Typical follow-up of microsoft_search_terms_report. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a responsive search ad (3-15 headlines ≤30 chars, 2-4 descriptions ≤90 chars, landing URL) in a Microsoft Advertising ad group. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Change the daily budget of a Microsoft Advertising campaign. The preview shows old → new. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Pause or resume a Microsoft Advertising campaign (resume also publishes a campaign created paused). Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Pause or enable a Microsoft Advertising ad group. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Change a Microsoft Advertising keyword: bid, pause/resume, match type (keyword text cannot change). Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Set the bid strategy of a Microsoft Advertising campaign: manual/enhanced CPC, maximize clicks/conversions (optional target CPA), maximize conversion value (optional target ROAS), target impression share. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Target (or exclude) locations on a Microsoft Advertising campaign or ad group. Names are resolved to Microsoft location ids from the official geo file when the account is connected. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Set device bid adjustments (percent -100..900; -100 excludes) on a Microsoft Advertising campaign or ad group. Microsoft requires all three devices; missing ones are sent as 0. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Set age and gender bid adjustments (percent -100..900) on a Microsoft Advertising campaign or ad group. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Add an ad schedule (day/time slots with bid adjustment) to a Microsoft Advertising campaign or ad group; ads do not serve outside the slots. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a remarketing list (page visitors rule on the UET tag) in the Microsoft Advertising account. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a conversion goal (URL goal: thank-you page; event goal: custom UET event) in the Microsoft Advertising account. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

Create a UET tag; the result carries the tracking script to add to the website. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.