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.

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.

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.

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.

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.

Campaigns read live from the Microsoft Advertising account (id, name, status, type, daily budget, bidding). Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

Ads of a Microsoft Advertising ad group with type, status, editorial status, headlines, descriptions and landing URLs. Use the ids for update_microsoft_ad_status / update_microsoft_responsive_search_ad. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

Keywords of a Microsoft Advertising ad group (id, text, match type, status, editorial status, bid). Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

Negative keywords currently set on a Microsoft Advertising campaign or ad group — check here when traffic drops or before removing one. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

Sitelink and callout extensions attached to Microsoft Advertising campaigns (id, text, URLs, status, editorial status). Check before adding to avoid duplicates; the ids feed remove_microsoft_ad_extensions. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

Microsoft Advertising performance below campaign level — by ad group, ad, keyword (with quality score), location, device or age/gender — with spend, clicks, conversions, revenue, CTR, CPC, CPA, ROAS and totals. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

Look up Microsoft Advertising location ids by name (from Microsoft's official geo file), with type and full display name, for add_microsoft_location_target. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.

Free-form read of the Microsoft Advertising Reporting API (v13): any report type with the columns you choose; rows come back as returned by Microsoft. Use it when the fixed reports don't have the cut you need. 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. Switching accounts is always allowed; adding another account on the platform is subject to the plan's ads.accounts.max limit (error=entitlement body with next_plan and upgrade_url).

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 and created PAUSED on Microsoft. Go live with update_microsoft_campaign_status(resume). Applied directly when the user asks (the result shows the preview); applied to Microsoft 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). Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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). Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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). Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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.

PERMANENTLY delete a Microsoft Advertising campaign (cannot be undone; pause instead if unsure). Only call it when the user explicitly asked for it; it is applied at once. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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.

PERMANENTLY delete a Microsoft Advertising audience (e.g. a remarketing list). Only call it when the user explicitly asked for it; it is applied at once. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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 single Microsoft Advertising ad. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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 copy of an existing Microsoft Advertising responsive search ad in place (keeps the ad id and its performance history, unlike rebuilding it). Given lists replace the current ones. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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.

Edit a Microsoft Advertising ad group: name, default CPC bid, start/end date, status, search network. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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 sitelink and/or callout extensions to a Microsoft Advertising campaign (created in the account library, then attached to the campaign). Applied directly when the user asks (the result shows the preview); applied to Microsoft 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.

Remove sitelink/callout extensions: detaches them from the campaign and deletes them from the account library (permanent; they drop off every campaign). Only call it when the user explicitly asked for it; it is applied at once. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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.

Remove negative keywords (by text, optionally one match type) from a Microsoft Advertising campaign or ad group — e.g. to undo a negative that blocks good traffic. Only negatives that really exist are removed. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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.

Send offline conversions (e.g. CRM sales) to Microsoft Advertising by click id, so bidding learns from real outcomes. Up to 1000 rows per call; the goal must exist and the clicks must be under 90 days old. Applied directly when the user asks (the result shows the preview); applied to Microsoft 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.