> ## Documentation Index
> Fetch the complete documentation index at: https://www.adspirer.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Adspirer Changelog: New Tools, Platforms & Features

> Adspirer changelog — new MCP tools, platform integrations, AI client support, and feature releases for the autonomous advertising agent.

**November 18, 2026**

Meta Ads: find the advertiser identity Meta asks for, and a clear reconnect step when Meta ends your login

## "Advertiser Is Missing" Now Has A Way Out

Meta rejects ad sets in regulated locations and categories unless a verified advertiser or payer is declared, and the error never said which ID to use. **`get_meta_advertiser_identities`** lists your owning Business, your promotable Pages with whether each is verified, and the advertiser name Meta recommends. Pass a verified ID in `regional_regulation_identities` (or `dsa_beneficiary` and `dsa_payor` for EU ads) and retry. Verification itself is a one-time step in Meta Business Settings.

* **Reconnect step**: when Meta ends the login behind your connection, Meta calls now tell you to reconnect and link you there, instead of returning a raw error.
* **Flexible ad preview note**: multi-text single-image or single-video ads built by `create_meta_image_campaign`, `create_meta_video_campaign` and `add_meta_ad` now say that Meta's Ads Manager thumbnail can look blank while the creative is attached.

→ [Meta Ads troubleshooting](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#meta-says-the-advertiser-is-missing)

**November 17, 2026**

Meta Ads: UTM tags and Advantage+ enhancements reach your new ads. TikTok: lifetime-budget creates no longer report a false failure

## Your Meta Tracking Tags And Advantage+ Setting Now Reach The Ad

Three fixes for ads that did not match what you asked for.

* **UTM parameters on Meta creates**: `url_tags` was accepted by `create_meta_image_campaign`, `create_meta_video_campaign` and `create_meta_carousel_campaign`, then dropped. Every ad those tools created shipped without its tracking parameters, while `add_meta_ad` tagged correctly. The tags now land on the ad, including the fallback creative used when a placement image upload fails.
* **Advantage+ creative "on" now turns it on**: `advantage_plus_creative` set to true used to send nothing and Meta stored the ad with the enhancements off. On plain website image and video ads it now requests them, and the response reports what was sent. Features you list in `disabled_creative_features` stay off.
* **`update_meta_ad` multi-advertiser changes**: swapping no longer fails with Meta error 3858504 on ads that carry Meta's retired standard-enhancements setting, and a swap failure shows Meta's own error text.

On TikTok, a `create_tiktok_video_campaign` call with a lifetime budget created everything, then told you it had failed and asked you to clean up by hand. It now returns the IDs. Refusals say what, if anything, was left in your account, and a create whose outcome can't be confirmed tells you to check before retrying.

→ [Creative enhancement settings](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#creative-enhancement-settings) · [TikTok troubleshooting](https://www.adspirer.com/docs/ad-platforms/tiktok-ads.md#adspirer-says-a-campaign-failed-but-it-exists-in-tiktok)

**November 15, 2026**

Meta Ads: images your ad account can't use are flagged before you launch

## No More Half-Built Meta Campaigns From Borrowed Images

Meta lists images from a shared media library in your ad account even when another ad account owns them, then rejects them in your ads with error 2446386. Adspirer used to offer those images for reuse and only find out after it had created the campaign and ad set.

* **Discovery marks them**: `discover_meta_assets` shows one line per image and flags the ones this ad account can't use.
* **Creates refuse early**: an image only another, unconnected ad account owns is refused before anything is created, so you're not left with a stray paused campaign.
* **Carousel cards are checked too**: this covers the cards you pass to `add_meta_ad_set`.
* **Meta's error now explains itself**: if error 2446386 still comes back, the reply says the image belongs to another ad account and how to fix it.

→ [Asset handling across ad accounts](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#asset-handling-across-ad-accounts)

**November 14, 2026**

Meta Ads: promote a post you already published, without rebuilding it as a new ad

## Boost An Existing Facebook Or Instagram Post From A Prompt

Until now every Meta ad tool built a new creative, so "boost this post" ended with a lookalike ad instead of the post itself. **`create_meta_ad_from_existing_post`** runs the post you already published as the ad.

* **Pass one post**: a Facebook Page post ID or URL, or an Instagram image post ID or URL.
* **Pick the ad set**: the ad lands in an existing ad set and inherits its audience, budget, schedule and tracking.
* **Nothing spends yet**: the ad is created paused, so you activate it when you are ready.

Meta does not allow an existing Instagram video or Reel to be promoted by its ID. Upload the video to your Facebook Page and promote that post instead.

Boost a published post.

Run this Facebook post as an ad in my "Spring Sale" ad set: [https://www.facebook.com/mybrand/posts/1234567890](https://www.facebook.com/mybrand/posts/1234567890)

→ [Promote an existing post as an ad](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#promote-an-existing-post-as-an-ad)

**November 12, 2026**

Google Ads: block a search term in one ad group without blocking it in the rest of the campaign

## Negative Keywords At The Ad Group Level

Until now a negative keyword on Google could only go on the whole campaign, or on a shared list you attached to campaigns. If you wanted "refurbished" blocked in your New Products ad group but still allowed in your Outlet ad group, there was no way to say so.

Two new tools fix that:

* **`add_negative_keywords_to_ad_group`** takes an `ad_group_id` and a list of keywords, each `EXACT`, `PHRASE`, or `BROAD` (default `BROAD`). The block applies to that ad group only.
* **`remove_negative_keywords_from_ad_group`** takes the `ad_group_id` and the IDs of the negatives to remove. It is permanent, so it asks you to confirm first. `get_campaign_structure` lists each ad group's negatives with their IDs.

If the ad group, or the campaign it sits in, has been removed, the add comes back with that reason instead of a generic Google error.

Block a term in one ad group.

Block "refurbished" as a phrase match negative in my New Products ad group only

→ [Google Ads tools](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

**October 28, 2026**

Google Ads: update\_campaign no longer says it succeeded when a language or location change failed

## A Failed Location Change Now Says It Failed

Change a campaign's locations or languages through `update_campaign` and Google refused the change, and you still got **"Campaign updated successfully."** The refusal was appended below that line as a block of technical error text. An agent reading the headline would move on with targeting that never changed.

Now the headline matches what happened:

* **"Partly applied"** when some changes landed and others didn't. It lists the ones that failed and still need re-running, and the ones that applied and don't.
* **"Not applied"** when nothing you asked for went through. Nothing on the campaign changed.
* **Google's reason, in plain words**, in place of the raw error dump.

The same goes for a budget change that fails alongside a targeting change: the message now names both failures instead of only the budget. An update where every change goes through reads exactly as before.

→ [update\_campaign on Google Ads](https://www.adspirer.com/docs/ad-platforms/google-ads.md#when-update_campaign-reports-a-partial-or-failed-update)

**October 24, 2026**

Amazon: target competitor products, check eligibility before you create, and fixes for UK profiles, budgets, names, and Sponsored Brands

## Amazon Campaigns That Check First And Fail Loudly

**Product targeting on Sponsored Products.** `create_amazon_sp_campaign` takes `product_targets`: competitor or own ASINs and categories, with exact or expanded match and category refinements. Pass keywords, product targets, or both; both get separate ad groups. The new `add_amazon_negative_product_targets` excludes ASINs or brands.

**Eligibility before creation.** The new `check_amazon_product_eligibility` shows which products can advertise and why the others can't. `create_amazon_sp_campaign` runs it first, so an out-of-stock or suppressed product no longer leaves an empty campaign behind. Ineligible products are skipped and listed.

**Fewer rejected creates.** Campaign and ad group names with `·`, `–`, `—`, `|`, currency symbols, or emoji are cleaned before sending, and unusable keywords are dropped with a reason instead of failing the whole batch. `create_amazon_sd_campaign` works on UK profiles. Sponsored Brands creates use your profile's brand when there's only one, and submit ads in batches of 10.

**Updates you can trust.** `get_amazon_budget_usage` checks every enabled campaign when you give no IDs. Budget updates work for both Sponsored Products and Brands formats, pausing a batch with ended campaigns succeeds, and any partial or total failure is reported as one. Campaign lists page at Amazon's 100-per-page limit and no longer show "(0)" for a list that failed to load. Video uploads wait for the asset to become ACTIVE and explain a failed spec check.

→ [Amazon Ads](https://www.adspirer.com/docs/ad-platforms/amazon-ads.md)

**October 23, 2026**

Amazon lists and reports carry the IDs and an honest count, and Meta campaign rejections show Meta's real message

## Amazon Reads That Show Everything, Meta Errors That Say Why

**Amazon: no more silently hidden rows.** `list_amazon_campaigns` now shows "10 of 37" when there are more campaigns than one page, with a `next_token` to fetch the rest. Set `ad_product` to `sp`, `sb` or `sd` to page. Sponsored Display honors the `state` filter. Rows from `get_amazon_report` and `analyze_amazon_targeting` carry campaign, ad group, and keyword or target IDs, so duplicate target text in different campaigns is no longer ambiguous, and `analyze_amazon_targeting` states how many targets it left out. Queries through `amazon_unified_api` return a compact table with a count instead of a raw dump cut off after two rows.

**Amazon: corrected guidance for product targets and updates.** Product targets use `PRODUCT_EXACT` (not `ASIN_SAME_AS`) with the ASIN as `product: {productId}`. Update items must not carry `adProduct`. An audience bid adjustment is removed with `percentage: null`.

**Meta: a rejected campaign tells you why.** When Meta refuses a campaign, the four campaign-create tools now return Meta's title and message with the error code, subcode, and `fbtrace_id`, where they used to return an empty error.

→ [Amazon Ads](https://www.adspirer.com/docs/ad-platforms/amazon-ads.md) · [Meta Ads troubleshooting](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#troubleshooting)

**October 21, 2026**

Searching for one Google account in Manage Accounts no longer deactivates your others, and the TikTok campaign link opens the right campaign

## Activate One Account Without Switching Off The Rest

**Manage Accounts no longer drops accounts you didn't touch.** The picker for Google accounts loads in pages and has a search box, so it only ever shows part of your list. Saving sent just the accounts you had ticked on screen, and anything else went inactive. Searching for one account and activating it could switch off every other account you already had active.

Saving now starts from the accounts that are already active and applies only what you changed: accounts you tick are added, and an account leaves the active set only when you untick it yourself. The activate button and the counter reflect that full set, so you can't go over your plan's account limit without seeing it first.

**TikTok: the "View in TikTok Ads Manager" link opens your campaign.** After `create_tiktok_video_campaign`, the link in the result used the campaign ID where TikTok expects your advertiser ID, so it didn't land on the campaign you'd just created. It now carries both, and opens that campaign in Ads Manager.

→ [Multi-account](https://www.adspirer.com/docs/knowledge-base/multi-account.md) · [TikTok Ads](https://www.adspirer.com/docs/ad-platforms/tiktok-ads.md)

**October 21, 2026**

ChatGPT users: add Adspirer as a custom MCP server. It works on every plan, including Free

## In ChatGPT, Connect Adspirer Directly

The Adspirer plugin in ChatGPT's **Plugins** directory is having issues, and it was already missing Amazon Ads, ChatGPT Ads, Google Analytics, and Google Search Console. The ChatGPT setup guide now leads with the path that works: add Adspirer as a **custom MCP server**.

ChatGPT moved and renamed the option, so the steps changed. Open **Plugins → Add → Add custom MCP server**, keep **Server URL** selected, paste `https://mcp.adspirer.com/mcp`, set **Authentication** to **OAuth**, and click **Create as a plugin**. Then **Try in chat → Connect**, and click **Authorize** on Adspirer. About two minutes, on any ChatGPT plan, including Free.

You get every tool the day it ships, on the same Adspirer account you already use. If you installed the plugin, disconnect it under **Settings → Plugins** so ChatGPT doesn't pick it.

→ [ChatGPT setup, step by step](https://www.adspirer.com/docs/ai-clients/chatgpt.md)

**October 19, 2026**

Amazon reports stay inside the ad product you ask for, and Meta reports and campaign flows stop saying things that aren't true

## Reports That Say What The Data Says

**Amazon: a Sponsored Brands report is now only Sponsored Brands.** Sponsored Products, Brands, and Display share one analytics store, and campaign, search-term, targeting, product, ad-group, and placement reads were filtering by account and date only. Ask for Sponsored Brands and you got Display and Products rows too, with account-wide totals. Each read now returns the product you asked for. `ad_product` takes `SP`, `SB`, `SD` or the full names; anything else is rejected with an error instead of defaulting to Sponsored Products.

**Meta performance and audience reads no longer mislead.**

* A date range entirely after your last delivery used to say your range was "before any recorded activity." It now says there was no delivery in the period and gives the date of the most recent activity.
* The CPC and CPA lines in the written summary of `get_meta_campaign_performance` now match the table. The summary line could read \$0.00 while the table had the real figure.
* `get_meta_audience_insights` no longer reports "performing steadily" when there is nothing to rank. It says either that there was no delivery, or that impressions delivered but Meta couldn't resolve them to an age or gender segment.
* `validate_catalog_readiness` reports **limited** retargeting when the pixel fires only `InitiateCheckout` or `AddToWishlist`. Only `ViewContent` or `AddToCart` counts as ready.

**Meta campaign flows.** `validate_and_prepare_meta_assets` on a single image used to print "Asset Bundle ID: None" and a next step that passed `"None"` to `create_meta_image_campaign`. It now returns the image hash and points you to `existing_image_hash`. Carousel cards take the same hash under `image_hash`. `resume_meta_campaign` no longer claims delivery has resumed: it sets the campaign to ACTIVE, and delivery needs an active ad set and ad too.

→ [Amazon Ads](https://www.adspirer.com/docs/ad-platforms/amazon-ads.md) · [Meta Ads](https://www.adspirer.com/docs/ad-platforms/meta-ads.md)

**October 19, 2026**

Remove Google radius targets by ID, see full radius addresses, and Meta ad-set targeting edits no longer wipe what you didn't send

## Take A Radius Back Out, And Edit Meta Targeting Without Wiping It

**Google radius targeting now works in both directions.** `remove_campaign_proximity` is the opposite of `add_campaign_proximity`: ask your assistant to stop targeting within a set distance of an address and it removes that radius. It works from the **Criterion ID** that `get_campaign_targeting` now shows beside each radius and location. It only ever removes radius targets, so an ID that belongs to a location or keyword is skipped and reported instead of deleted.

`get_campaign_targeting` also reads radius targets properly. A street address used to show as a bare country code with no units. It now shows the full address and miles or kilometers. Targeting reads refresh within a minute, and a change you make shows on the next read.

**Meta partial targeting edits keep the rest.** Meta replaces the whole targeting spec on every edit, so changing only an age range on `update_meta_ad_set` or `update_meta_catalog_ad_set` used to drop locations, interests, and everything else you didn't resend. Edits now merge onto the ad set's current targeting. Send only the keys you want to change; to clear a key, send it empty.

→ [Google Ads tools](https://www.adspirer.com/docs/ad-platforms/google-ads.md) · [Meta targeting](https://www.adspirer.com/docs/ad-platforms/meta-ads.md)

**October 2, 2026**

Connecting an ad account mid-setup no longer loses the hand-off back to the Authorize screen your AI client is waiting on

## Connect An Ad Account Mid-Setup, Still Land On Authorize

Setting up from ChatGPT, Claude, or any other client ends on Adspirer's **Authorize** screen, and most people connect their first ad account on the way there. That connect opens the ad platform's own sign-in in a pop-up — and on mobile Chrome and desktop Safari, that pop-up often comes back without a link to the tab that opened it. Adspirer was holding the pending authorization in that one tab, so the return had nowhere to go: setup finished, you landed on your account page, and the client that sent you there was never connected.

The authorization now travels with you instead of sitting in one tab. It rides on the return address Adspirer hands the ad platform — Google, Meta, TikTok, LinkedIn alike — so an opener-less pop-up return still knows to finish the hand-off. The plan step in the middle of setup keeps it the same way.

**And if you already finished setup in another tab,** returning to the tab that still carries the authorization forwards you straight to the **Authorize** screen instead of showing you your account page. Only an authorization on the address itself counts, so an ordinary visit to the setup page can never replay an old one.

→ [Setup troubleshooting](https://www.adspirer.com/docs/knowledge-base/faq.md#troubleshooting) · [Add Adspirer to your agent](https://www.adspirer.com/docs/add-to-your-agent.md)

**September 30, 2026**

The Adspirer Authorize screen now shows it's working, ignores a second click, and restarts a lapsed sign-in instead of showing an error page

## You Clicked Authorize. Now The Page Says So.

Every client's setup ends on the same screen: Adspirer's **Authorize** page, where you grant your assistant access. You clicked **Authorize** and the page sat there, apparently unchanged, for a couple of seconds while your assistant's callback loaded — and the button was already outlined when the page opened, so it looked selected before you touched it. The natural response is to click again, which sent a second approval for a connection that had already been approved.

The screen now answers the first click. The button turns into a spinner reading **Connecting…**, with a line underneath naming the app you're connecting and telling you that you'll be taken back automatically. Clicks after the first do nothing, and so does Enter — the first click is the one that counts, so a second one can't send a second approval. Nothing is focused when the page loads.

If the hand-off takes longer than usual, the screen says so rather than leaving you to guess. Around eight seconds it tells you it's still connecting and to keep the window open; around twenty it tells you to press **Authorize** again if your client never opened. Desktop apps hand off differently — they open over this page instead of replacing it — so those end on **Sent ✓** and tell you that you can close the window once the app comes up.

**A lapsed sign-in no longer dead-ends.** Leave the Authorize screen open long enough and your Adspirer sign-in expires behind it. Clicking **Authorize** then used to land you on a bare error page with no way forward. Now it sends you back through sign-in and returns you to the same Authorize screen with your request intact — finish signing in, click **Authorize**, and you're connected. No access is granted on that path, and the expired sign-in isn't carried through it.

→ [Setup troubleshooting](https://www.adspirer.com/docs/knowledge-base/faq.md#troubleshooting) · [Quickstart](https://www.adspirer.com/docs/quickstart.md)

**September 29, 2026**

Adspirer is an official, reviewed listing in Claude, ChatGPT, Cursor, and Grok Bot — search for it and add it, no custom connector

## Search For Adspirer, Click Add. That's The Whole Setup.

Adspirer is now an official, reviewed listing in every major chat app's own directory, so setup is a search and one click:

| App | Listing | Click |
| - | - | - |
| **Claude** | **Adspirer Ads & Performance Marketing Agent**, an **Anthropic-verified** connector (Anthropic reviewed it for quality and security). The **Adspirer** plugin in Anthropic's directory adds 15 skills, 5 slash commands, and an agent on top | **Connect to Claude** / **Add** |
| **ChatGPT** | **Adspirer** in the **Plugins** directory, reviewed by OpenAI (OpenAI renamed Apps to Plugins) | **Install plugin** |
| **Cursor** | **Adspirer** on the Cursor Marketplace, **Verified by Cursor** | **Add to Cursor** |
| **Grok Bot** | **Adspirer for Grok Bot**, the same Verified by Cursor listing | **Add to Grok Bot** |

**Drop the custom connector in Claude, Cursor, and Grok Bot.** The listing includes the connector, the skills, and the agent, and it's always current. If you added `mcp.adspirer.com` by hand before, remove it so your assistant doesn't see every tool twice. The Claude page no longer asks you to paste a `SKILL.md` either, because the plugin ships the skills.

ChatGPT is the one exception for now. The plugin is still waiting on OpenAI to publish our latest update, so it has no Amazon Ads, ChatGPT Ads, Google Analytics, or Search Console tools yet. For those, **Plugins → Add → Create MCP App** connects straight to Adspirer's server in about two minutes. Codex and clients without a listing keep their existing install paths.

→ [Add Adspirer to your agent](https://www.adspirer.com/docs/add-to-your-agent.md) · [Claude](https://www.adspirer.com/docs/ai-clients/claude.md) · [ChatGPT](https://www.adspirer.com/docs/ai-clients/chatgpt.md) · [Cursor](https://www.adspirer.com/docs/ai-clients/cursor.md) · [Grok Bot](https://www.adspirer.com/docs/ai-clients/grok.md)

**September 28, 2026**

Sellers can read the brand entity ID Sponsored Brands requires, instead of hunting for it outside Adspirer

## Sponsored Brands Asks Sellers For A Brand ID. Now You Can Just Read It.

Creating a Sponsored Brands campaign on a **seller** account means passing a `brand_entity_id`, and Adspirer had no way to tell you what yours was. Either you already had it written down, or the campaign didn't get created. Vendor accounts were never affected — they can usually leave the field empty.

**`list_amazon_brands`** reads the Brand Registry entities on your Amazon profile and returns each one's `brandEntityId`, next to its `brandId` and its registered brand name. Read-only. Ask for your brands, take the ID, create the campaign.

Two things worth knowing. Sponsored Brands wants the **`brandEntityId`** — the long one starting with `ENTITY` — not the shorter `brandId` sitting beside it. And each advertiser profile carries its own, so a brand you sell under in the UK and in the US has a different ID in each marketplace; ask against the profile you're about to advertise on.

It covers creative assets too — `upload_amazon_asset` takes the same ID from sellers. And when Amazon rejects a Sponsored Brands campaign over a brand problem, the error now names this tool rather than leaving you to work out which field it meant.

→ [Finding your brand entity ID](https://www.adspirer.com/docs/ad-platforms/amazon-ads.md#finding-your-brand-entity-id) · [Tool catalog](https://www.adspirer.com/docs/agent-skills/tools.md)

**September 27, 2026**

Performance Max finally answers 'what did it spend on?', and negative keyword lists become reusable across campaigns

## Performance Max Will Tell You What It Spent On

Ask for the search terms on a Performance Max campaign and the answer used to be **"No search term data"** — which read like Google was hiding them. It wasn't. Google keeps PMax queries in a different place than Search and Shopping queries, and Adspirer was only reading the latter. Two tools now read the PMax side.

**`analyze_pmax_search_terms`** returns every query the campaign matched, one row each, with cost, clicks, impressions, conversions, conversion value, CTR, and CPC. It opens with a summary across the whole window — how many terms, total cost, total conversions, and how many terms recorded no conversions along with what they cost. Those are facts, not a verdict: a query with nothing attributed may be upper-funnel or tracked elsewhere, and that call is yours.

**`analyze_pmax_search_categories`** reads Google's own grouping of those queries into search categories, so you can see the shape of demand — which themes convert — without reading ten thousand individual terms. Google's residual **(Other search terms)** bucket comes back labelled rather than silently folded into a total.

Both take a lookback of 7, 30, 60, 90, or 120 days, sort on any metric they return, and take a free-text filter so "show me everything with *free* in it" is one call. Results are ranked by cost first, so the terms worth your attention are on the first screen — paging is capped on purpose rather than inviting a walk through the long tail. Money renders in your ad account's own currency.

## One Negative Keyword List, Every Campaign

`add_negative_keywords` blocks a term on one campaign. Blocking the same twenty terms across fifteen campaigns meant fifteen calls, and adding a sixteenth term later meant fifteen more.

Five new tools bring Google's shared negative keyword lists to the agent: **`create_negative_keyword_list`** to start one, **`add_negative_keywords_to_list`** to fill it (each term `EXACT`, `PHRASE`, or `BROAD`), **`attach_negative_keyword_list_to_campaign`** to put it to work, and **`list_negative_keyword_lists`** / **`get_negative_keyword_list`** to read back what you have — the first of those reports each list's keyword count and how many campaigns it's attached to.

Add a term to the list and every campaign carrying it blocks the term at once. Detaching a list from one campaign leaves it intact everywhere else.

→ [PMax search terms](https://www.adspirer.com/docs/ad-platforms/google-ads.md#pmax-search-terms) · [Shared negative keyword lists](https://www.adspirer.com/docs/ad-platforms/google-ads.md#shared-negative-keyword-lists) · [Tool catalog](https://www.adspirer.com/docs/agent-skills/tools.md)

**September 27, 2026**

Meta engagement campaigns stop failing on a performance goal you never picked

## An Engagement Campaign That Actually Gets Created

Asking for a Meta engagement campaign — the objective that buys reactions, comments, shares, and saves on a Page post — failed at creation every time, with a rejection that blamed a setting you never chose:

> Performance goal isn't available: You can't use the selected performance goal with your campaign objective

Meta wants an engagement ad set to declare **where** the engagement happens. Adspirer sent the performance goal and the Page, but left the destination blank, and Meta refuses that pairing at creation — so the campaign never existed. It now sets the destination to the post itself, which is the one Meta accepts for post engagement.

Every create path that can build an engagement ad set is covered: **`create_meta_image_campaign`**, **`create_meta_video_campaign`**, **`create_meta_carousel_campaign`**, and **`add_meta_ad_set`**.

Nothing else moved. Pass `destination_type` yourself and your value still wins. Campaigns that send people into WhatsApp, Messenger, or Instagram Direct keep their own destination. Traffic, leads, sales, and awareness campaigns were never affected and are unchanged.

→ [Engagement campaigns on Meta](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#engagement-campaigns)

**September 23, 2026**

Google Analytics, Search Console and Tag Manager stop guessing which property, site or container you meant, and ask instead

## One Google Login, Many Properties — And No More Guessing Which

Connecting Google Analytics hands Adspirer one Google login, and that login usually reaches more than one thing: a dozen GA4 properties, several verified Search Console sites, a Tag Manager account with containers under it. Ask for "last week's sessions" without saying which property and the agent had to pick one. A wrong read gave you another site's numbers with no hint they were the wrong site's. A wrong write — a tag created in the wrong container — quietly changed tracking on a live website.

The agent now asks. Call an action that operates on a specific property, site, or container without naming one, and Adspirer pulls the real labelled list off your connection and hands it back for you to choose from:

```
You have 28 properties connected for Google Analytics on jane@agency.com.
This is NOT a connection problem — do not reconnect. Tell me which one —
a single property, a few, or all of them — then call again.
```

Picking is part of the conversation, not a lookup you go do somewhere else. You can answer with one, with a few, or with **all** — and "all" means every property on *that* connection, one call each, so the agent says what that will cost you in tool calls and waits for a yes before running them. The question itself doesn't cost you a tool call.

**Reads with exactly one property, site, or container are untouched.** If your login reaches a single GA4 property, nothing changes — the agent uses it and answers, exactly as before.

**Writes always confirm, even at one.** Search Console's `submit-url-for-indexing`, `submit-sitemap` and `delete-sitemap`, and Tag Manager's `create-tag`, `update-tag` and `update-variable` name their target back to you before they run. Tag Manager is a three-level hierarchy — account, then container, then workspace — and it asks one level at a time rather than presenting a list of everything at once.

This is the same idea as [one integration holding more than one account](https://www.adspirer.com/docs/agent-skills/tools.md#marketing-stack-integrations-plus-and-above), one level deeper: first which account, then which property inside it.

→ [Google Analytics integration](https://www.adspirer.com/docs/integrations/google-analytics.md) · [Integration tool reference](https://www.adspirer.com/docs/agent-skills/tools.md)

**September 20, 2026**

Meta housing, employment, credit and politics campaigns no longer fail when you target outside your ad account's own country

## A Housing Campaign Can Run Somewhere Other Than Your Own Country

Meta requires a campaign in a Special Ad Category — **housing, employment, credit, or social issues, elections and politics** — to declare the country it runs in, separately from its targeting. Adspirer sent the category but never the country, so Meta fell back to whatever country your ad account sits in and rejected the campaign the moment the targeting pointed anywhere else:

> The locations are not in the countries selected for Special Ad Categories

A US agency launching a housing campaign in Brazil hit that every time. Adspirer now reads the country out of the campaign's own targeting and sends it alongside the category — ask for a housing campaign targeting Brazil and nothing else is needed.

It covers every create path that takes a special ad category — **`create_meta_image_campaign`**, **`create_meta_video_campaign`**, **`create_meta_carousel_campaign`**, and **`create_meta_catalog_campaign`** — plus **`update_meta_catalog_campaign`**.

Two cases still want a word from you. If you target only cities, regions, or ZIP codes and none of them names a country, there is nothing to read a country from: pass `special_ad_category_country` with the ISO codes yourself, such as `['BR']` or `['US', 'CA']`. Pass it too when the country the campaign is declared in genuinely differs from where it's targeted. Adspirer never guesses one.

Campaigns with no special ad category are untouched — the field isn't sent at all.

→ [Special Ad Categories on Meta](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#special-ad-categories)

**September 18, 2026**

ChatGPT Ads gets custom audiences from your own customer list, server-side conversion sending with hashed matching, conversion reporting, and ad-group auto-bidding

## Your Customer List Is Now A ChatGPT Ads Audience

Upload the people you already know and target them inside ChatGPT — or keep them out of a prospecting campaign. Twelve new tools cover the whole life of an audience: **`create_chatgpt_custom_audience`** to build one (empty, or seeded from a file you've uploaded to OpenAI), **`add_chatgpt_custom_audience_members`** and **`remove_chatgpt_custom_audience_members`** to change it, **`replace_chatgpt_custom_audience_members`** to swap the membership wholesale, and **`merge_chatgpt_custom_audiences`** to combine up to 64 of them into one.

Give the agent emails, phone numbers, identifiers you've already hashed, or Google Advertising IDs. Building an audience is asynchronous, so the tools hand back an operation you can watch with **`get_chatgpt_custom_audience_operation`** — and the agent polls until the audience is `ready` instead of reporting a size it can't see yet.

Then target it. A campaign can include audiences and exclude audiences, and an ad group can bid **0.1× to 10×** for one, so your highest-value list pays up without a separate campaign. Including an audience or bidding on it needs roughly 25,000 matched users; excluding one has no minimum. Size comes back as OpenAI's matched-user range — that is the only number OpenAI publishes, and Adspirer won't invent a precise one.

## Conversions You Send Yourself, And View-Throughs Kept Apart

**`send_chatgpt_conversion_event`** posts a real conversion through the Conversions API — the path that survives ad blockers and the cross-device journeys a pixel misses. Send the event type, its value and currency, an order id so OpenAI can de-duplicate against the pixel, and the customer fields that raise match rates: email, phone, name, external id, country, city, region, postal code, IP, user agent, Google Advertising ID.

Raw emails, phone numbers, and names are **SHA-256 hashed at the point of the call**. The plain values never reach Adspirer's backend and are never written to your tool-call history; the response reports which match keys were used, never what they were. Values are whole minor units — 2599 for \$25.99 — and a decimal is rejected rather than quietly truncated. Ask for a dry run and nothing is sent.

**`get_chatgpt_conversion_insights`** reads the results back by campaign, ad group, or ad, split by country or device on request. View-through conversions get their own line and are never folded into the total, so a view is never counted as a click.

## Auto-Bidding, Surfaces, And URLs That Tag Themselves

Ad groups now carry a bid strategy. Keep `fixed_bid` and set the number yourself, or hand it over with `maximize_clicks` or `maximize_conversions` — each of which needs a matching campaign bidding type, checked before the request is sent rather than after OpenAI rejects it.

Three smaller things that were missing:

* **Surface targeting.** Restrict a campaign to `ios_app`, `android_app`, `desktop_web`, or any mix, instead of running everywhere.
* **One query string for every landing page.** Set `utm_source=chatgpt&utm_campaign={campaign_id}` on the campaign; `{campaign_id}`, `{ad_group_id}`, `{ad_id}`, and `{ad_account_id}` are filled in when the ad serves.
* **Lists you can actually search.** Campaigns, ad groups, ads, pixels, and event settings all take a free-text search, a status filter, a sort, a date range, and paging — and report *3 of 41* rather than handing back an empty result that reads like an empty account. On ads the search covers the copy itself.

Targeting a campaign now has five sides — locations in and out, audiences in and out, and surfaces. Change one and the other four stay exactly as they were; if the agent can't read your current targeting to merge a change into it, it refuses rather than guessing.

→ [ChatGPT Ads](https://www.adspirer.com/docs/ad-platforms/chatgpt-ads.md) · [Tool catalog](https://www.adspirer.com/docs/agent-skills/tools.md)

**September 18, 2026**

Adspirer is on the Cursor Marketplace — one install for the subagent, 14 skills, 2 rules, and the MCP server, and the same listing runs in Grok Bot

## Installing Adspirer In Cursor Is One Click Now

Adspirer is listed on the [Cursor Marketplace](https://cursor.com/marketplace/adspirer). Open **Customize** in Cursor's sidebar, search **adspirer**, and select **Install** — or type `/add-plugin adspirer` in any chat. Choose **user** scope for every project or **project** scope for one client folder.

One install brings four things: the `adspirer` MCP server with 400+ tools, the `performance-marketing-agent` subagent, **14 skills**, and **2 rules**. Nothing is copied into `~/.cursor/` by hand, the plugin updates itself, and Cursor reviews every release before it ships.

The 14 skills replace the old 5. There is now one per platform — `adspirer-google-ads`, `adspirer-meta-ads`, `adspirer-amazon-ads`, `adspirer-linkedin-ads`, `adspirer-tiktok-ads`, `adspirer-chatgpt-ads` — each carrying the traps that cause most failures there, plus workflow skills for setup, launch, optimize, performance review, and creative, and `adspirer-docs` for questions about Adspirer itself. Cursor matches them from what you ask; `/adspirer-optimize` and friends force one.

**The `install.sh` script is retired.** If you ran it, delete the `adspirer-*` folders it left in `~/.cursor/skills/`, `~/.cursor/agents/`, and `~/.cursor/rules/` so they don't shadow the plugin's copies.

## The Same Plugin Runs In Grok Bot

[Grok Bot](https://www.adspirer.com/docs/ai-clients/grok.md) installs from the same marketplace. Open **Marketplace** at the bottom of the sidebar, add **adspirer**, and complete **Authorize** — your bot now reads and acts on your live ad accounts. All 14 skills come across.

What Grok Bot adds is scheduling that doesn't depend on your laptop being open. A routine runs in the cloud on an hourly, daily, weekday, weekly, or monthly schedule, so a Monday scorecard across every connected platform arrives before you sit down. Every run spends tool calls, so start weekly.

Installing in one product doesn't install in the other — they share a marketplace, not an install.

→ [Cursor setup](https://www.adspirer.com/docs/ai-clients/cursor.md) · [Grok Bot setup](https://www.adspirer.com/docs/ai-clients/grok.md) · [What's in the plugin](https://www.adspirer.com/docs/agent-skills/cursor-agent.md)

**September 17, 2026**

Microsoft Advertising is no longer read-only — create and edit campaigns, ad groups, ads, keywords, budgets, bid strategies, extensions, Performance Max asset groups and targeting from your assistant

## Your Bing Account Is Something You Can Change Now

The launch note two days ago said creating and editing Microsoft campaigns weren't live. They are now. Every control you can create on Microsoft Advertising, you can also edit — campaign down to a single device bid adjustment — without opening the Microsoft interface.

Ten edit tools, one per layer:

* **`update_microsoft_campaign`** — name, budget, bidding scheme, languages, time zone, URL tracking, dates, and status.
* **`update_microsoft_ad_groups`** — name, status, CPC/CPM/CPV/mCPA bids, bidding scheme.
* **`update_microsoft_ads`** — status, and the creative on responsive ads: headlines, descriptions, long headlines, images, videos with pinning, paths, and URLs.
* **`update_microsoft_keywords`** — match type, status, and per-keyword bid.
* **`update_microsoft_budgets`** and **`update_microsoft_bid_strategies`** — the shared budget library and portfolio bid strategies.
* **`update_microsoft_asset_groups`** — Performance Max asset groups: business name, call to action, headlines, descriptions, images, videos, final URLs, paths, search themes, and dates.
* **`update_microsoft_ad_extensions`** — sitelink text and URLs, callout text, price rows, promotion details.
* **`update_microsoft_ad_group_criterions`** and **`update_microsoft_campaign_criterions`** — the bid adjustment and status on targeting you've already added, at ad-group or campaign level.

The create tools from the launch — campaigns of every type, ad groups, ads, keywords, extensions, Performance Max asset groups, audiences, and deep targeting — are live too.

## Edits Are Partial, With Two Places They Aren't

Pass the fields you want changed and everything else is left alone. Clearing a value is explicit: an empty string `""` clears a URL field, `0` detaches a shared budget or a portfolio bid strategy, and an end date on or after 2050-01-01 removes the end date.

Two exceptions worth knowing before you ask for an edit:

* **Creative lists replace.** Send headlines, descriptions, or images on an ad or an asset group and that whole list is replaced — omit it to keep what's there.
* **Ad extensions are all-or-nothing.** Microsoft deletes any field you don't send, so an extension edit has to carry the complete object. Ask your assistant to read the extension back with `list_microsoft_ad_extensions` first and it will.

A campaign's type can't change, and neither can the detail of a targeting criterion — the age range, device, or geo itself. Change a bid or pause it in place; to change what's targeted, delete it and add it again.

## Two Things That Can't Go Wrong Quietly

A Performance Max asset group edit refuses to replace a live asset list when an image or video fails to resolve, rather than emptying it. And extension and targeting edits never report an item as applied when Microsoft rejected it.

`list_microsoft_ad_extensions` also returns your account's extension library now — it came back empty for every account before, whatever was in there.

Performance reporting on Microsoft — spend, clicks, conversions — isn't live yet.

Edit a live Bing campaign.

On my Microsoft Advertising account, raise the budget on my top Search campaign to 75 a day, pause every keyword in its ad groups that has no conversions, and set a -20% bid adjustment on tablets.

→ [Microsoft Advertising tools](https://www.adspirer.com/docs/agent-skills/tools.md) · [What Adspirer can and can't do](https://www.adspirer.com/docs/knowledge-base/capabilities.md)

**September 16, 2026**

Connect a Microsoft Advertising account and ask your assistant what's running on it — Search, Shopping, Audience, Performance Max, Hotel and App campaigns, with status, budget and bidding scheme

## Your Bing Account Is Now Something You Can Ask About

Microsoft Advertising (Bing Ads) connects in the Connections tab, through Microsoft's own sign-in, the same way Google or Meta does. Once it's connected your assistant can read the account without you opening the Microsoft interface.

Two tools are live:

* **`list_microsoft_accounts`** — every Microsoft Advertising account you've connected, each with the `account_id` to pass, its customer id, and its currency.
* **`list_microsoft_campaigns`** — campaigns of every type on the account — **Search**, **Shopping**, **Audience**, **Performance Max**, **Hotel**, and **App** — each with its status, budget, and bidding scheme.

Several Microsoft Advertising accounts, and several Microsoft logins, can be connected at once. Pass the `account_id` from `list_microsoft_accounts` to say which one you mean; with a single account connected you can leave it out. Ask without naming one while several are connected and you get the account list back rather than a guess — that reply is not a connection problem, and disconnecting won't change it.

Budgets and bids read back as plain decimals in the account's own currency: `50` means 50.00 in that account's currency, never cents and never micros.

## Reading Is The Whole Surface Today

Creating and editing Microsoft campaigns is not live yet. Everything above is read-only — nothing Adspirer does on a Microsoft account can change it or spend on it. The write tools land in a later release and will be announced here.

See what's running on your Bing account.

List my Microsoft Advertising accounts, then show me every campaign on the main one with its type, status, budget and bidding scheme.

→ [Microsoft Advertising tools](https://www.adspirer.com/docs/agent-skills/tools.md) · [What Adspirer can and can't do](https://www.adspirer.com/docs/knowledge-base/capabilities.md)

**September 16, 2026**

Pause or re-enable any number of Google ads, ad groups, or campaigns in one call each, with every change verified against Google before it reports success

## Swapping Ads Across An Account No Longer Means Hundreds Of Calls

Refreshing creative across 150 ad groups used to mean pausing each old ad and resuming each new one, one at a time. Three new tools do the whole sweep in a call apiece:

* **`bulk_update_ad_status`** — pause or enable any number of ads in one ad group. Pass `ad_group_id`, the `ad_ids`, and `PAUSED` or `ENABLED`. One call per ad group; get the IDs from `get_campaign_structure` or `get_ad_performance`.
* **`bulk_update_ad_group_status`** — pause or enable any number of ad groups, on any campaign type: Search, Performance Max, Display, Demand Gen. Pass `campaign_id` too and each ad group is checked to belong to that campaign, so an ID from somewhere else is reported instead of quietly changed.
* **`bulk_update_campaign_status`** — pause or enable any number of campaigns from a list of IDs.

There is no cap on how many IDs you can pass. All three set status and never remove anything, so re-running with the opposite status undoes the sweep.

## A Bulk Change That Didn't Land Can't Report Success

Each of these reads the live status back from Google after writing. Anything that didn't actually change is moved out of the success list and into the failures, with the reason — so a swallowed mutation shows up as a failure rather than a green tick.

Before writing, the current status is checked as well. Anything already in the target status is skipped rather than rewritten, an ID that isn't in the ad group or campaign you named comes back as not found, and a removed entity can't be re-enabled — Google has no route back from removed, and the tool says so instead of failing obscurely.

Nothing changes for one-off work: `pause_campaign`, `resume_campaign`, `pause_ad_group`, and `resume_ad_group` are unchanged, and `bulk_update_keyword_status` still covers keywords.

Pause every old ad in an ad group before swapping in new creative.

List the ads in my Search ad group, then pause all of the ones launched before this month in a single bulk call and confirm each one actually changed.

Pause a set of campaigns at once.

Pause every Google Ads campaign that spent money last month with zero conversions — use the bulk campaign status tool so it's one call, and show me anything that didn't pause.

→ [Google Ads campaign management](https://www.adspirer.com/docs/ad-platforms/google-ads.md#campaign-management) · [Tool reference](https://www.adspirer.com/docs/agent-skills/tools.md)

**September 15, 2026**

A max CPC ceiling on Maximize Clicks is applied instead of discarded, and a brief you asked for weekly no longer arrives every morning

## Maximize Clicks Took Your Max CPC And Threw It Away

Put a campaign on Maximize Clicks with a cap — *"maximize clicks, but never pay more than CA\$8 a click"* — and `update_bid_strategy` accepted the number, reported **Bidding Strategy Updated**, and saved no ceiling at all. The campaign went on bidding uncapped. A ceiling was only ever written for Target Impression Share; on Maximize Clicks it was dropped on the way to Google. Over the last 120 days, 191 successful calls passed a cap that never landed.

`cpc_bid_ceiling` now applies on **Maximize Clicks**, where it caps what the strategy may pay for a click. Give it in your account's own currency as a decimal — `8` for a CA\$8.00 cap, not cents and not USD. Leave it out and an existing ceiling stays as it is, so you can change something else about the campaign without clearing the cap by accident.

The response no longer takes your word for what was saved. Adspirer reads the ceiling **back from Google** after the write and shows what is actually stored, before and after — so **"Max CPC ceiling: not set"** means the cap really is absent, rather than repeating the number you sent. On the strategies that have no max-CPC field at all, a ceiling is now refused up front, naming the two strategies that accept one, instead of being taken and discarded.

Reading a cap back no longer means opening the Google Ads interface either: `list_campaigns` and `get_campaign_structure` both report the ceiling and which strategy it sits on.

Cap what Maximize Clicks pays for a click.

Put my Search campaign on Maximize Clicks but never pay more than \$8 a click, then read the ceiling back from Google and confirm it saved.

## A Brief You Asked For Weekly Arrived Every Morning

Ask for a weekly performance brief and you were told you would get one — *"Schedule: weekly at 09:00"* — and then it arrived daily. Every brief scheduled through an assistant fell back to a daily cadence no matter what you requested. The confirmation echoed your request rather than what was stored, so nothing in the reply gave you a reason to check.

`schedule_brief` now keeps the cadence you actually asked for — **daily**, **weekly**, or **every N days**. Weekly runs on Mondays at the time and timezone you chose; every-N-days runs on its own interval.

If you set up a brief before this and it has been landing every morning, it is still stored as daily — fixing it means scheduling it again. Ask for your scheduled tasks, delete the ones whose cadence is wrong, and create them fresh at the cadence you want.

Audit the cadence on your existing briefs.

List my scheduled tasks and tell me the cadence of each performance brief. For any that should be weekly rather than daily, delete it and schedule it again as weekly.

→ [Google Ads campaign management](https://www.adspirer.com/docs/ad-platforms/google-ads.md#campaign-management) · [Scheduled briefs & reports](https://www.adspirer.com/docs/agent-skills/tools.md)

**September 12, 2026**

Performance Max campaigns with Brand Guidelines can be built end to end — the square logo and business name now attach where Google requires them

## A Brand Guidelines PMax Campaign Could Never Finish Its Asset Group

Turn on Brand Guidelines for a Performance Max campaign and Google stops accepting the square logo and business name as asset-group assets — it requires them on the **campaign**. Adspirer only ever linked them to the asset group, so the campaign could never be completed: the attempt came back with *"require at least one square logo to be linked as a CampaignAsset"*, and no asset-group tool could clear it, because none of them link at the campaign level.

**`create_pmax_campaign` now takes `brand_guidelines_enabled`.** Set it at creation and the logo and business name are routed to the campaign level in the same call. Google does not allow this flag to change after the fact, so it is create-time only — a campaign built without it cannot be converted later.

**`add_pmax_campaign_logo` links the square logo to a campaign that already exists.** Point it at an `asset_id` already approved in your account, or give it an image URL to upload a new one, and pass `business_name` to attach both at once. A logo that is already linked is skipped rather than duplicated. `add_pmax_asset_group` is aware of Brand Guidelines too — it builds the group from text and marketing images while the brand assets go to the campaign.

**`get_pmax_conversion_goals` reads what a campaign actually bids toward** — each goal's category, its origin, and whether it is biddable. The check it exists for is confirming that purchase is the only biddable goal before a retail campaign spends anything.

Performance Max campaigns without Brand Guidelines are unchanged; none of this applies unless the setting is on.

## Removing The Logo From A Brand Guidelines Campaign Now Stops You

A campaign with Brand Guidelines enabled cannot serve without its logo and business name, and nothing warned you before the campaign went dark. Removing or pausing a logo, landscape logo, or business name on one of these campaigns is refused now, with the reason and the safe way to swap it — add the replacement first, then remove the old one. Re-enabling an asset is never blocked.

Reads caught up as well. `list_campaign_extensions` and the Extensions block of `get_campaign_structure` show campaign-level logos and the business name, which previously read as absent however much was attached.

Build a Performance Max campaign with Google's brand-controlled layout.

Create a Performance Max campaign with Brand Guidelines enabled, link our square logo and business name at the campaign level, then confirm purchase is the only biddable conversion goal.

→ [PMax Brand Guidelines](https://www.adspirer.com/docs/ad-platforms/google-ads.md#pmax-brand-guidelines)

**September 11, 2026**

A campaign you launched today stops reporting no delivery, your stop times land in your own timezone, and sitelinks attached at ad-group level are finally visible

## "No Delivery" On A Campaign That Launched An Hour Ago

Launch a Meta campaign, ask whether it's running, and Adspirer could tell you nothing was being delivered while the campaign was already spending. Asking again tomorrow would show it. `get_meta_campaign_details` has two paths — with the full ad set and ad hierarchy, and without — and only the second one was passing your requested date window through. The hierarchy path fell back to a silent `last_7d`, and Meta's `last_7d` **excludes today**, so a campaign created today had a reporting window containing none of its life. It fired on 5,262 calls across 829 accounts.

Both paths carry the window now. And when you don't name one, a campaign created in the last seven days defaults to its own run so far — creation date through today — instead of to a week that ended before it existed. An established campaign still defaults to the last 7 days, so nothing changes on the accounts where that was already the right answer.

Check a campaign you just launched.

I launched a Meta campaign today. Is it actually delivering, and what has it spent?

## Your 11:59 PM Stop Time Was 11:59 PM In London

Give Meta a date and time with no timezone on it — `2026-09-30T23:59:59` — and Meta reads it as UTC. A campaign an advertiser in Los Angeles meant to stop at midnight stopped at 5 PM, and a dated start ran and spent hours before it was supposed to be live. 763 calls across 193 accounts sent a stop time this way; 67 sent a start time.

Adspirer now attaches your **ad account's own timezone** to a time you give without one, daylight saving included, on every create and update path — campaigns, ad sets, and all five ad types, catalog ads included. A time that already carries an offset, a `Z`, or a bare date is passed through untouched. Update responses show the time that was **applied**, offset and all, so you can read back what Meta actually stored rather than the string you typed.

`update_meta_campaign` also says plainly that it changed the **campaign's** stop time, and that ad sets keep their own end times — the ambiguity that had people setting a campaign stop date and wondering why an ad set kept spending.

## A New Ad Says PAUSED Three Times, And Means It

Create a Meta campaign and Meta may email you that your ad is under review, which reads like it is about to start spending. Create responses now show the status at every level — **Campaign: PAUSED · Ad set: PAUSED · Ad: PAUSED (in Meta review)** — with a note that Meta reviews and notifies about a new ad even while everything is paused, and that nothing delivers or spends until you set the campaign Active. Wired into the image, video, and carousel create paths.

**Carousel asset prep stopped pointing you at the wrong tool.** `validate_and_prepare_meta_assets` on a carousel printed `Asset Bundle ID: None` — a field carousels don't have — and told you to call `create_meta_image_campaign` next, which is not the tool that builds a carousel. It now lists the image hash per card and names `create_meta_carousel_campaign` with the fields it wants.

**`search_meta_targeting` stopped returning all 285 behaviors.** Meta's behavior browse endpoint accepts a search term and a limit and then ignores both, so asking for "engaged shoppers" came back with every behavior Meta has, *Facebook access (OS): Windows 7* among them. Adspirer pulls the category once and filters it itself, on name, description, and category path, and honours the limit you asked for. No match now returns an honest empty result instead of a haystack. Interest search was never affected.

## Sitelinks At Ad-Group Level Existed. Adspirer Said Zero.

Extension assets can be attached at three levels in Google Ads — account, campaign, and ad group — and every read tool only ever looked at one of them. `list_campaign_extensions` and the Extensions block of `get_campaign_structure` read campaign level only, so an account with 16 live sitelinks on its ad groups was told **Sitelinks (0)**. Nothing read account level at all. 609 campaign checks across 345 accounts hit that flat zero.

All three levels are read now, and each asset says where it's attached — *"16 at ad-group level — these serve"* rather than a count that hides which ones are actually running. **"None configured at any level"** appears only when all three really are empty, which is the difference between an extension you should add and one you already have somewhere you weren't looking.

**Locations read as place names.** `get_campaign_targeting` used to hand back Google's raw criterion IDs — `geoTargetConstants/2036` — leaving your assistant to spend a call resolving each one, or to guess. Positive and negative locations now come back resolved: **Australia | Country | 2036**.

## Keyword Research Stopped Coming Back Empty For A City

Ask `research_keywords` to research a city — *"McKinney, TX"* — and it could return nothing at all, then blame Google for an empty result. Google had returned around a thousand ideas. Keyword Planner scopes volume to the area you target, so city-level volumes are small, and a fixed 100-monthly-searches floor removed every single one. A quarter of all calls returned zero, and 35% of calls naming a city.

The floor can no longer empty a list that had something in it: if it would remove everything, the top 20 by volume are kept and labelled as low volume. And the empty-result message is honest about who emptied it — it says Google returned nothing **only when Google returned nothing**, and otherwise tells you what Adspirer filtered out and why.

→ [Google Ads extensions](https://www.adspirer.com/docs/ad-platforms/google-ads.md#ad-extensions-assets) · [Meta campaign scheduling](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#start-and-stop-times-use-your-account-timezone)

**September 8, 2026**

Lead-gen campaigns stop being reported as losing money at 0.00x ROAS, and Meta's 'authenticate your account' block finally comes with the steps that clear it

## Your Lead Campaign Was Never Losing Money At 0.00x ROAS

Ask about wasted spend on an account that runs lead generation and Adspirer could hand back something that reads like a disaster: the campaign listed as losing money, most of its spend marked wasted, **ROAS 0.00x**. Lead campaigns earn no revenue, so that zero was arithmetic, not a finding — and acting on it meant pausing campaigns that were doing their job.

The test behind it was on the wrong thing. Waste analysis chose its yardstick — revenue or cost per lead — by checking whether the campaign had recorded any conversion *value*. One stray purchase value drifting into a lead campaign on a mixed account was enough to make it look like a revenue campaign and get it graded on ROAS. `analyze_meta_wasted_spend`, `analyze_tiktok_wasted_spend`, and `analyze_linkedin_wasted_spend` now decide from the **campaign's objective**, so lead, messaging, and talent-lead campaigns are measured on cost per lead whatever values landed against them.

A lead campaign with genuinely zero leads is still a real loss — that spend bought nothing — but it now reads as what it is: *spend with no leads recorded, ROAS does not apply to this objective*, and the suggested next step is to confirm your lead tracking rather than to pause. **LinkedIn gained a Lead Gen Campaign Performance table** it never had, sorted best cost-per-lead first. **TikTok stopped printing its internal `insufficient_signal` marker in the Severity column** and says `unrated (not enough data)` instead.

**Budget optimization stopped saying "Only 0 days of data" about every campaign.** `optimize_meta_budget`, Google's `optimize_budget_allocation`, and `optimize_linkedin_budget` are meant to leave out campaigns with less than a week of data — there is nothing to optimize against yet. But none of them was counting the days, so every campaign carried that note *and* was optimized anyway: the answer said it had excluded the campaigns it had just reallocated. The count is real now, so the exclusion is real. When every campaign in the account is that young you get one plainly provisional note instead of a confident reallocation built on three days. On Meta the excluded campaigns are also listed by name with the reason, under **Constraints Applied** — a section that previously read two keys the backend had stopped sending, so it showed nothing at all.

**Money in the written dashboard summaries reads as money.** Sentences that quoted a total used the currency code where the symbol belonged — `GBP17,808` — and fell back to `$` when the account currency couldn't be determined. They use the account's own symbol now. A metric that doesn't apply to your objectives shows as **n/a** with a note instead of a coloured delta, and click-through rate is never coloured as though up were always good.

→ [Which conversions Adspirer counts](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#performance-analysis)

## Meta's "Please Authenticate Your Account" Is Not A Reconnect

Meta error code **31**, subcode **3858385**, blocks the API from publishing or editing ads while the account itself keeps working normally in Ads Manager. Adspirer's message said the account needed re-verifying and to retry — which reads as *reconnect Adspirer*. Reconnecting never clears it, so customers reconnected, hit the same wall, and reconnected again.

The error now carries the steps that actually clear it: open Ads Manager with no VPN, go to **Billing and payments** and click **Start Authentication** to get Meta's code; if that button isn't there, rename an existing ad in a private window and hit Publish to make the prompt appear. Turn on two-factor authentication, check [Account Quality](https://www.facebook.com/accountquality), and retry once — then wait 24 to 48 hours before trying again rather than hammering it.

→ [Meta troubleshooting](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#meta-is-holding-a-security-check-on-the-account)

**September 6, 2026**

ChatGPT's App Store app no longer stalls when a tool it needs to read a schema isn't on its list

## The Assistant That Stopped Because A Tool It Needed Wasn't On Its List

Before it calls anything, Adspirer has your assistant fetch that tool's exact parameters with `get_tool_schema`. That step is what stops it inventing an argument name and failing on a real campaign. But some clients hold a tool list that was frozen when you installed them — the ChatGPT App Store app is the common one, and some older uploaded skill kits do it too. On those, `get_tool_schema` isn't in the list at all, so the assistant announced that a required tool wasn't available and stopped, mid-task, with nothing done.

The way around it already worked. Nothing said so. Any platform router will fetch a schema for you — `google_ads`, `meta_ads`, `linkedin_ads`, `tiktok_ads`, whichever you have — and what comes back is identical to calling `get_tool_schema` directly. That sentence is now in the text the assistant reads, so it takes the detour itself instead of giving up.

Nothing changes if your client does list `get_tool_schema`: calling it directly by name is still the normal path, and still the one to use.

→ [Tool discovery](https://www.adspirer.com/docs/agent-skills/tools.md)

**August 30, 2026**

Google Ads accounts that aren't activated now appear with the reason instead of vanishing, and active accounts stop being marked inactive

## The Account That Wasn't There, And The One That Shouldn't Have Been Greyed

Connecting Google Ads could hand you an empty account picker. If an account you genuinely have access to hadn't been activated on Google's side — billing never set up, or the account deactivated — discovery dropped it without a word and you got *"no accounts found"*. The account existed, you could see it in Google Ads, and Adspirer behaved as though it didn't.

It shows up now. An account that can't be activated appears in the picker as a greyed-out row you can't select, carrying the reason it's unavailable. That's the difference between *"Adspirer can't see my account"* and *"this account needs billing set up in Google Ads"* — two problems with very different fixes, which used to look identical. The row carries the account number and the reason and nothing else: currency and time zone are left off, because the lookup that would have supplied them is the one that failed, and an invented currency is worse than a missing one.

**Accounts that are fine are no longer greyed out by mistake.** The same check could go the other way. A transient hiccup on Google's side sometimes came back with a message that read like a deactivation notice, and an account that was perfectly active got shown as inactive and blocked from selection. Eligibility is now decided on the account's actual status rather than the wording of an error, and a check that fails temporarily leaves the account selectable instead of locking you out of it.

→ [Connecting Google Ads](https://www.adspirer.com/docs/ad-platforms/google-ads.md#connecting-google-ads)

**August 25, 2026**

Meta campaigns stop guessing which Facebook Page to run from when your account has more than one

## Two Facebook Pages, And Adspirer Was Quietly Picking One

If your Meta ad account can run ads from more than one Facebook Page and you didn't name one, Adspirer used whichever Page Meta listed first. Meta has no "default Page" and the order it returns them in is arbitrary, so an ad could go out under the wrong brand — and it looked like a choice Adspirer had made on purpose.

It doesn't choose any more. When the ad account has **exactly one** promotable Page, that Page is used and nothing changes for you. When it has **two or more** and you haven't named one, the campaign stops before anything is created and comes back with every Page it could run from, each with its name and ID, so you pick. Adspirer won't guess the linked Instagram account in that case either.

**`list_meta_pages`** is the new tool behind it: every Facebook Page that can run ads on the account, with any Instagram account attached to it. Ask *"which Facebook Pages can I run ads from?"* and you get the list without starting a campaign to find out.

See your promotable Pages before you launch.

Which Facebook Pages can I run Meta ads from on my ad account?

This covers image, video, carousel, and Advantage+ Catalog creation, plus `add_meta_ad_set` and `add_meta_ad`. Pausing, resuming, updating, and duplicating are untouched — those work on an ad that already has its Page.

→ [Choosing a Facebook Page](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#choosing-a-facebook-page)

**August 25, 2026**

Adspirer installs into Codex inside the ChatGPT desktop app with three chat messages

## Codex Desktop: Three Messages, No Terminal

The ChatGPT desktop app now has Codex built in, and Adspirer's Codex plugin installs from a chat window. Switch to **Codex** in the top-left dropdown, then send `codex plugin marketplace add amekala/ads-mcp`, `install plugin`, and `help me oauth it`. Codex runs each one, opens the Adspirer sign-in, and confirms when the connection is live.

It's the same `adspirer-ads-agent` plugin as the terminal install — 400+ tools, five skills, brand workspace — so nothing changes if you later move to the CLI for scheduled runs. In the sidebar, the terminal guide is now **Codex Terminal** and the new one is **Codex Desktop**.

Two optional extras follow the setup. Turn on the desktop app's **Computer use** and **Computer history** and Codex can work in Chrome and Excel and remember what you were doing. And if you have an **Expert Kit**, hand Codex the downloaded folder — it installs the skill and the account's agent itself, no file copying.

→ [Codex Desktop setup](https://www.adspirer.com/docs/ai-clients/codex-desktop.md)

**August 24, 2026**

Amazon ad review status, and long product-ad and asset lists you can actually page through

## Find Out Why The Ad Isn't Running

An Amazon ad that never serves usually isn't broken — it's rejected, and Amazon doesn't volunteer that. **`get_amazon_moderation`** reads the review status straight off the ad: APPROVED, IN\_PROGRESS, REJECTED, or FAILED, broken out per component, so you can see that the text passed and the video didn't. On a rejection it comes back with the policy violation. Sponsored Products, Sponsored Display, and Sponsored Brands.

Check an Amazon ad's review status.

Check the moderation status of my Amazon ad and tell me if anything was
rejected and why.

**Long lists no longer stop partway.** On a large account, `list_amazon_product_ads` and `search_amazon_assets` used to truncate — whatever came after the first batch was unreachable. Both page properly now, and product ads can be narrowed by state or ad group up front so you don't have to page at all. `get_amazon_product_performance` returns the page you asked for instead of the top 20 every time, so the 40th ASIN is finally visible.

**Sponsored Products ad extensions get an honest answer.** Amazon's API supports creating extensions for Sponsored Brands, Sponsored Display, and DSP — not for Sponsored Products, which are console-only. Asking for one used to return a bare `ACTION_NOT_SUPPORTED`; now you're told what's actually going on. An extension update that carries fields Amazon ignores is rejected out loud rather than reported as a success that didn't happen.

→ [Amazon Ads tools](https://www.adspirer.com/docs/ad-platforms/amazon-ads.md#creative-assets)

**August 24, 2026**

Several multi-text Meta ads can now run in one ad set, and a pixel on a traffic campaign finally records events

## The Second Multi-Text Ad Used To Be Rejected. Now It Just Runs.

Give a Meta image or video ad several primary texts and headlines and Meta tests the combinations. Try to put a *second* one of those ads in the same ad set and it failed — *"You can only have one ad in a dynamic creative ad set"*, error `1885553`.

That was Dynamic Creative doing what Dynamic Creative does: it caps an ad set at one ad. Multi-text ads are now built as Meta's **Flexible** format, which is an ordinary ad. So an image ad with three headlines, a video ad with two, and a plain single-text ad all coexist in one ad set and compete properly.

Explicit Dynamic Creative is untouched — `create_meta_dco_ad` and `is_dynamic_creative` on `add_meta_ad_set` still give you a real DCO ad set, one ad and all. On-platform lead-form ads keep their previous shape too.

**`add_meta_ad` with multiple texts works at all now.** It had been failing every single time with *"object\_story\_spec is malformed"* (error `1443048`) while the same creative through the create path was fine. A multi-text ad aimed at a lead form now carries the form through as well.

**A pixel on a traffic, awareness, or engagement campaign records events again.** Those objectives don't optimize toward a pixel, so the `pixel_id` you passed was accepted and then dropped, and Website Events never switched on. It's now attached as ad-level tracking, so the events land in Meta reporting. Conversion objectives never had this problem and are unchanged.

One more: a **Click-to-WhatsApp video** ad no longer dies on *"The field link is not supported in the field video\_data."* Meta's video creatives can't hold a top-level link, so the WhatsApp destination now rides the call-to-action instead. Image and carousel WhatsApp ads are byte-for-byte what they were.

→ [Several ads with multiple text variations in one ad set](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#several-ads-with-multiple-text-variations-in-one-ad-set)

**August 24, 2026**

Four helper tools withdrawn after they reported working accounts as disconnected

## Four Helper Tools Pulled For Calling A Connected Account Disconnected

`diagnose_my_setup`, `preflight_campaign`, `whats_changed_since_last_visit`, and `weekly_opportunities` are no longer part of the tool surface. Your assistant doesn't see them any more, so they won't come up on their own — treat them as gone.

They were misreading which ad platform you meant. Say "meta" and the check looked for the account's canonical `meta_ads` name, failed to match it, and answered that no account was connected — on an account that was connected and working fine. That is worse than no answer: it sends you off to reconnect something that was never broken.

The other **nine** Diagnostic & Helper tools are unaffected and still quota-free on every plan, Free included: `start_here`, `suggest_next_action`, `list_what_i_can_do`, `get_campaign_spec`, `validate_campaign_draft`, `explain_platform_error`, `why_did_this_fail`, `verify_campaign_is_live`, and `usage_value_summary`.

If you were reaching for `diagnose_my_setup` to work out where a problem is, ask *"why did my recent calls fail?"* instead. `why_did_this_fail` names the platform's real error on each recent failure, which is usually enough to tell an expired AI-client connection apart from an ad-platform sign-in — the two connections customers most often confuse.

→ [Diagnostic & Helper tools](https://www.adspirer.com/docs/agent-skills/diagnostic-helper-tools.md)

**August 24, 2026**

A direct-connection path for ChatGPT with every current tool, while the App Store app waits on OpenAI review

## ChatGPT: Connect Directly For Amazon Ads, ChatGPT Ads, Analytics, and Search Console

The Adspirer app in the ChatGPT App Store is behind. Every update to a ChatGPT app has to be approved by OpenAI, and our latest one hasn't been published — so App Store users have no **Amazon Ads**, **ChatGPT Ads**, **Google Analytics**, or **Google Search Console** tools, and won't see anything new until the next review lands.

You don't have to wait. ChatGPT's **Developer mode** lets you add Adspirer as a custom connector that talks to `mcp.adspirer.com` directly: same account, same sign-in, every tool the day it ships. It takes about two minutes. The [ChatGPT setup guide](https://www.adspirer.com/docs/ai-clients/chatgpt.md) now documents both paths side by side, with a plain comparison so you can pick the one you need.

The App Store app still works for Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads, and you can keep both installed.

→ [ChatGPT setup — App Store vs. custom connector](https://www.adspirer.com/docs/ai-clients/chatgpt.md)

**August 22, 2026**

Meta video ads upload regardless of file size, and a brand-new funded Meta account can create its first campaign

## Video Size Stopped Mattering

An 80 MB video ad sometimes came back as **"Backend returned a non-JSON response (HTTP 503)"**. A 1.3 GB one came back as **"timed out after 250s"**, three times in a row. Same cause both times: Adspirer downloaded your entire video before handing it to Meta, so the bigger the file, the more likely the upload fell over.

It doesn't download it any more. Adspirer hands Meta the URL and Meta fetches the file itself, so nothing about the upload depends on how big the video is. `create_meta_video_campaign`, `add_meta_ad`, and `add_meta_ad_set` all take the same path.

One thing this asks of you: **the video URL has to be reachable from the public internet**, because Meta is the one fetching it now. A Google Drive or Dropbox link shared with "anyone with the link" works; a private or sign-in-required link does not. If Meta genuinely can't fetch it, Adspirer falls back to fetching and pushing the file itself.

→ [Creative assets](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#creative-assets-what-you-need-to-know)

## "No Payment Method Is Set" — On An Account That Has A Card

Before creating a campaign, Adspirer checks the Meta ad account for the things Meta will reject it for. The payment check read the wrong signal: Meta leaves that field empty on an account that has a valid card attached but has **never spent** — which is exactly the state of every brand-new account at the moment its owner launches their first campaign.

So a first campaign got blocked with **"No payment method is set on this Meta ad account"** on accounts that were funded and ready. Worse, the phantom blocker was listed ahead of any real one, so when something genuine was also missing — usually a promotable Facebook Page — you went and fixed the wrong thing.

It now reads Meta's own `HAS_VALID_PAYMENT_METHODS` capability, and it fails open: if Meta's answer comes back partial or empty, Adspirer doesn't block a campaign Meta would have accepted. This covers image, video, carousel, and catalog campaign creation.

→ [Campaign creation failed](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#troubleshooting)

**August 22, 2026**

Adding the same call asset twice no longer creates a duplicate phone number, and call assets get list, pause, and remove tools

## The Duplicate Phone Number Problem, Both Halves

A customer added a call asset, couldn't tell whether it had worked, and added it again. Google stores a call asset's phone number verbatim and never deduplicates, so the campaign ended up serving two identical phone extensions — and there was no way to list what was on the campaign, no way to pause one, and no way to take one off.

Both halves are fixed.

**Adding is idempotent now.** `add_call_asset`, `add_business_name_asset`, and `add_search_campaign_image` check the campaign before they write, and skip when the same asset is already there — telling you it was already present rather than reporting a second success. Pass `force=true` when a genuine duplicate is what you want.

**Call assets get a full lifecycle.** Three new tools:

* **`list_call_assets`** — every phone number on a campaign, with its country code, status, and the asset ID the other two need.
* **`set_call_asset_status`** — pause a number so it stops showing, or re-enable it, without unlinking anything. Name specific asset IDs, or omit them to change all of them.
* **`remove_call_assets`** — unlink numbers from the campaign. The asset stays in your Asset Library and can be re-linked elsewhere.

`list_campaign_extensions` grew to match. It used to report sitelinks, callouts, and structured snippets; it now covers call assets, business names, and images too, each with its status — so "what's actually on this campaign?" is one call rather than four.

Find and clear a duplicate phone number on a Google Ads campaign.

Show me every phone number on my Brand Search campaign, and remove the duplicate
if there is one.

→ [Ad extensions and assets](https://www.adspirer.com/docs/ad-platforms/google-ads.md#ad-extensions-assets)

**August 18, 2026**

Competitor research stopped demanding a connected Google Ads account — Meta-only, TikTok-only and LinkedIn-only advertisers can now run it

## Competitor Research No Longer Needs A Google Ads Account

`competitor_ads_research` reads public ad libraries. It never needed a connected Google Ads account to do that — but it insisted on one anyway, and stopped with **"No google\_ads account connected"** for anyone who hadn't connected Google. If you advertise on Meta only, the tool was unreachable, even when you explicitly asked for `sources=["meta"]`.

It now resolves who you are instead of demanding an account you don't have. The research runs on whatever sources you name.

The *Your ads* half of the comparison — your own creatives and brand terms placed beside theirs — still needs a connected account on the platform being compared. With nothing connected there you get the competitor findings and no comparison tab, instead of an error and nothing at all.

Naming an account explicitly still behaves exactly as before: a wrong or ambiguous `account_id` errors and tells you which accounts to pick between. Only the requirement to have one at all is gone.

Run competitor research on Meta with no Google Ads account connected.

Show me the Facebook and Instagram ads figma.com is running right now.

→ [Competitor research](https://www.adspirer.com/docs/agent-skills/tools.md#competitor-research-1)

**August 18, 2026**

Meta budgets on yen, won, rupiah and eight other whole-unit currencies were being sent to Meta 100x too high — fixed on both the write and the read side

## Meta Budgets On Whole-Unit Currencies Were 100× Too High

If your Meta ad account bills in Japanese yen, Korean won, Indonesian rupiah, or one of eight other currencies that have no decimal subdivision, **a budget you set through Adspirer reached Meta a hundred times larger than you asked for**. A ¥20,000 daily budget was sent as ¥2,000,000.

Meta wants budgets in each currency's smallest unit, and how many of those make one unit depends on the currency: 100 for dollars, euros and most others, but **1** for the eleven currencies that have no minor unit at all. Adspirer multiplied by 100 in every case.

The read side hid it. Adspirer divided by 100 to display a budget, so the number it showed you back was the one you'd asked for — correct on our screen, wrong at Meta. That is why this ran undetected.

Both sides are fixed. The multiplier is now the one Meta actually specifies for your account's currency, applied once, at the last step before the request leaves — and budgets, bids, and remaining spend read back with the real conversion and the real currency symbol. A ¥20,000 budget now displays as `¥20,000`, not `$200`.

> [!WARNING]
>
> **If your Meta ad account bills in one of these currencies, check your live budgets now** — in Adspirer or in Meta Ads Manager — and correct anything that reads 100× high. Any budget or bid set through Adspirer before August 18, 2026 is affected. This does not apply to USD, EUR, GBP, or any other currency with cents; those were always sent correctly.
>
> The eleven affected currencies: **CLP, COP, CRC, HUF, IDR, ISK, JPY, KRW, PYG, TWD, VND**.

Two smaller things came with it. Budget validation no longer rejects legitimate budgets on these accounts — the old fixed ceiling was effectively 100× lower for them, which turned real Japanese and Korean advertisers away. And whole-unit currencies stop rendering a meaningless `.00`: a Hungarian account reads `Ft 5,000`, not `Ft 5,000.00`.

→ [Meta budget guidelines](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#budget-guidelines)

**August 17, 2026**

ChatGPT Ads campaigns can bid for conversions, budgets read in your account's own currency, location exclusions arrive, and archiving asks before it acts

## ChatGPT Ads Campaigns Can Bid For Conversions

A ChatGPT Ads campaign used to optimize for clicks or impressions and nothing else. If you had conversion tracking set up, the campaign couldn't use it.

`create_chatgpt_campaign` and `update_chatgpt_campaign` now take a **`bidding_type`** — `conversions` (oCPC), `clicks` (CPC), or `impressions` (CPM). On `conversions`, OpenAI optimizes toward the clicks most likely to convert and still bills you per valid click.

Conversions bidding needs exactly one conversion event to aim at, named with **`conversion_event_setting_ids`**. Get one from `list_chatgpt_event_settings`, or create it with `create_chatgpt_event_setting`. Ask for conversions bidding without an event setting — or with more than one — and the agent tells you so before the request leaves, instead of relaying an opaque rejection from OpenAI.

Switch a running ChatGPT Ads campaign to conversions bidding.

List my ChatGPT Ads conversion event settings, then switch my Spring Launch
campaign to conversions bidding against the order\_created one.

→ [Budgets, bidding, and targeting](https://www.adspirer.com/docs/ad-platforms/chatgpt-ads.md#budgets-bidding-and-targeting)

## Budgets In Your Own Currency, And Budget Edits That Stick

Two money problems, both fixed.

**Budget changes silently did nothing.** Asking to raise a ChatGPT campaign's daily budget reported success and changed no budget — the number went to OpenAI in the wrong shape and was discarded. It applies now, on daily and lifetime budgets alike, and a lifetime campaign is no longer quietly converted to a daily one. If you tried to change a ChatGPT Ads budget from chat and the campaign kept spending at the old rate, that is why. Check the campaign and set it again.

**ChatGPT Ads is not a dollars-only platform.** Roughly a third of connected accounts bill in AUD, BRL, CAD, GBP, MXN, or NZD, and every budget and bid was labelled in dollars regardless. Budgets and bids are the account's own currency now — say `25` for 25 a day in whatever currency the account bills in — and create and update responses read back the budget and bidding that actually applied, rendered in that currency, so you confirm the number rather than trust it.

One consequence worth knowing: OpenAI's real minimum for a daily budget is **25 a day** in the account's currency, not 1. Adspirer had been enforcing 1, so a smaller budget passed validation and then failed at OpenAI with nothing useful attached. It's caught up front now, with the account's currency in the message.

→ [Budgets, bidding, and targeting](https://www.adspirer.com/docs/ad-platforms/chatgpt-ads.md#budgets-bidding-and-targeting)

## Exclude A Location — And Keep The Targeting You Already Had

`create_chatgpt_campaign` and `update_chatgpt_campaign` gain **`exclude_location_query`** and **`exclude_location_ids`**, so you can run nationally and skip a state, or target a metro and cut a suburb out of it.

The more important half is what happens on an edit. OpenAI replaces a campaign's targeting wholesale rather than merging it, so changing one side used to erase the other — add an exclusion and the campaign quietly lost its include list and started serving everywhere. Adspirer now reads the current targeting and preserves whichever side you didn't mention.

Two related guards came with it:

* **A location it can't resolve is an error, not a wipe.** A misspelled place name leaves your targeting exactly as it was and says so, rather than clearing it.
* **Serving everywhere is now something you ask for explicitly**, with `clear_targeting`. Empty location lists no longer mean it by accident.

`update_chatgpt_campaign` also checks OpenAI's response against what you asked for and names any field OpenAI kept at its old value — so a change that didn't take never comes back reported as done.

Add a location exclusion without disturbing the existing targeting.

My ChatGPT Ads campaign targets California. Keep that, but exclude Los Angeles,
and show me the targeting that ended up applied.

→ [Budgets, bidding, and targeting](https://www.adspirer.com/docs/ad-platforms/chatgpt-ads.md#budgets-bidding-and-targeting)

## Archiving A ChatGPT Campaign Asks First

OpenAI has no un-archive endpoint. Archive a ChatGPT campaign, ad group, or ad and it is gone for good — but the confirmation gate that guards permanent actions only recognised tools named `delete` or `remove`, so the three `archive_chatgpt_*` tools went straight through.

They now require an explicit confirmation, and the agent points you at pausing instead when pausing is what you meant. Archive tools on Google, Meta, TikTok, and LinkedIn are unaffected — archiving there is reversible, and nothing about how they behave has changed.

→ [Safety guardrails](https://www.adspirer.com/docs/ad-platforms/chatgpt-ads.md#safety-guardrails)

**August 17, 2026**

ChatGPT Ads holds more than one account, and the agent can now create your pixel, Conversions API key, and conversion events without opening Ads Manager

## More Than One ChatGPT Ads Account

ChatGPT Ads authenticates with a pasted Advertiser API key rather than an OAuth login, and one key reaches exactly one advertiser account. That made it the only Adspirer platform locked to a single account — awkward for an agency, and worse for anyone running two brands.

Connect a key per account and they all sit side by side. **"Connect another account"** in the [Connections](https://adspirer.ai/connections) tab adds one; each disconnects on its own, so removing a client doesn't disturb the rest. How many you keep active at once follows your plan.

Nothing changes if you have a single account connected — tools still use it automatically and you never pass an ID. With two or more, name the account you mean. `list_chatgpt_accounts` shows each one with its `account_id`, name, and currency, and a request that doesn't say which account comes back with your list rather than a guess at one.

See every connected ChatGPT Ads account, then scope a question to one.

List my ChatGPT Ads accounts with their account IDs and currencies,
then show me last week's spend for the Northwind Retail one.

→ [Managing several ChatGPT Ads accounts](https://www.adspirer.com/docs/ad-platforms/chatgpt-ads.md)

## Conversion Tracking You Can Set Up By Asking

Measuring a ChatGPT ad used to mean leaving the conversation: open OpenAI Ads Manager, create a pixel, copy the ID back, create a Conversions API key, define your events. Five tools now do it from chat.

* **`create_chatgpt_pixel`** creates the web pixel and hands back the **site snippet ready to paste** into your `<head>`, along with the Pixel ID and the Source ID you need next. Automatic Advanced Matching — which hashes what your site forms collect so more conversions match — is on unless you ask for it off.
* **`create_chatgpt_conversions_api_key`** creates a server-side key. The secret is shown once and never again, and by default it's stored encrypted so Adspirer starts sending server-side conversions straight away.
* **`create_chatgpt_event_setting`** ties an event — `order_created`, `lead_created`, one of the other supported types, or a custom one — to a pixel or Conversions API source, with an attribution window.
* **`list_chatgpt_pixels`** and **`list_chatgpt_event_settings`** show what already exists.

One thing to know before you ask: OpenAI has no way to delete a pixel, a Conversions API key, or an event setting. They are permanent. So each create asks you to confirm first, and none of them will overwrite a pixel or key you already have unless you explicitly say to replace it.

Set up ChatGPT Ads conversion tracking end to end from chat.

Create a ChatGPT Ads pixel called "Main Site" and give me the snippet to paste.
Then set up an order\_created conversion event against it with a 30-day window.

→ [ChatGPT Ads conversion tracking](https://www.adspirer.com/docs/ad-platforms/chatgpt-ads.md)

**August 17, 2026**

One unchangeable field no longer sinks an entire conversion action update, and Search language targeting degrades honestly ahead of Google removing it in September

## One Field Google Won't Change No Longer Sinks The Whole Update

A customer asked to make a conversion action secondary and, in the same breath, to leave it out of the Conversions column — where it already was. Nothing happened. Google returned an immutable-field error, and because the update is a single atomic write, the field that *was* changeable went down with it. Only a retry that dropped the second request worked.

The cause: **"counts in the Conversions column" cannot be set through the Google Ads API on an existing conversion action.** Not for GA4-imported actions, not for native ones. Google derives it from the action's category and goal setup — and for imported conversions, from Google Analytics. Adspirer had been sending it anyway.

It now never goes to Google. Ask for it and:

* **If the action is already set that way**, it's skipped in silence and the rest of your update applies — which is exactly the customer's case, now working.
* **If it's a real change**, the rest of your update still applies and you're told to make that one change in the Google Ads UI (Goals → Conversions → the action → Edit settings) or in GA4.
* **If it was the only thing you asked for**, you get that explanation rather than Google's opaque refusal.

The confirmation also stopped over-reporting. It lists the fields that actually landed, not the fields you asked for.

→ [Conversion tracking on Google Ads](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

## Search Language Targeting Ends In September, And Says So

Google is removing campaign-level language targeting for Search campaigns in late September 2026. Search ads will match on the language of the ad itself. Performance Max is exempt, and reading a campaign's existing language criteria keeps working.

`update_campaign` would have started failing on Search the day Google flipped it, with a context error that names nothing you could act on. It now recognises that specific rejection and explains it: Google no longer accepts language targeting on Search campaigns. A language-only update tells you it didn't apply instead of reporting success, and a mixed update applies everything else and says which part Google refused.

Nothing changes before the cutover — Adspirer keys off Google's own rejection rather than a date on a calendar, so today the setting still writes exactly as it did yesterday. You don't need to do anything now; when the change lands you'll get a sentence instead of a stack trace.

→ [Campaign management on Google Ads](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

**August 16, 2026**

Integration tools are listed before you connect them instead of hiding until you do, and a reused logo no longer breaks Demand Gen and YouTube campaign creation

## Integration Tools Stop Hiding Until You Connect Them

Google Analytics, Search Console, Tag Manager, and Klaviyo were hidden from your AI client's tool list until you had connected them. The reasoning was to save you a dead-end call. The effect was a trap: you couldn't discover an integration existed, so you never learned there was something to connect.

It cost a real customer more than a wasted call. They connected Search Console and Tag Manager, their Claude client was still holding a tool list from before those tools existed, and because the server had also been hiding them pre-connection, the agent never tried them once. From the outside it looked like the integrations were broken.

Integration tools are now always listed, exactly like every ad platform. Ask for one you haven't connected and it answers with a prompt to authorize it in [Connections](https://adspirer.ai/connections) — which is the nudge that gets it connected, and a good deal more use than a tool that isn't there.

→ [Integration tool reference](https://www.adspirer.com/docs/agent-skills/tools.md)

## A Reused Logo No Longer Breaks Demand Gen And YouTube Campaigns

`discover_existing_assets` hands back the logos already in your Google Ads account and tells the agent to reuse them as-is. `create_demandgen_campaign` and `create_youtube_campaign` then wrapped that value a second time, sending Google a malformed asset reference and getting back an `INVALID_ARGUMENT` that named nothing useful. Five accounts hit it across both tools over the last 90 days.

Both tools now recognize an asset reference that's already complete and pass it through untouched. Reusing a logo the agent just discovered works, and so does supplying a bare asset ID — the path that happened to work before is unchanged.

If a Demand Gen or YouTube campaign refused to create for you with an invalid-argument error after picking up an existing logo, try it again.

→ [YouTube campaigns](https://www.adspirer.com/docs/ad-platforms/youtube-ads.md)

**August 16, 2026**

Competitor research reaches Meta, TikTok and LinkedIn, a stricter advertiser match so you never get a stranger's ads, Google Tag Manager becomes connectable, and integrations hold more than one account

## Competitor Research Now Covers Meta, TikTok, And LinkedIn

`competitor_ads_research` read Google's ad library — Search, Display, and YouTube. For a competitor whose real budget sits on Instagram or TikTok, that was a report about the smallest part of what they run.

Three more ad libraries are now behind the same tool. Ask for a competitor's **Facebook and Instagram** ads, their **TikTok** ads, their **LinkedIn** ads, or any combination, and they come back in the same gallery — creatives, headlines, offers, formats, and how long each has been running, every one read with vision analysis.

Google is still the default. You add the rest by naming them, and each one is another set of lookups, so ask for the platforms your competitor actually advertises on rather than all four out of habit.

Two details worth knowing:

* **Meta carousel ads arrive whole.** A multi-card ad used to show its first image and drop the rest. It now renders as a swipeable strip with all its cards, labelled for what it is.
* **`region` doesn't apply everywhere.** Google and Meta ad libraries filter by market. TikTok's and LinkedIn's are worldwide and can't be narrowed — so those results are labelled worldwide rather than passed off as your market.

Compare a competitor's social ads against their search ads.

Show me what notion.so is running on Meta, TikTok, and LinkedIn right now,
alongside their Google ads, and tell me which platform gets their best creative.

→ [Tool catalog](https://www.adspirer.com/docs/agent-skills/tools.md)

## The Right Advertiser, Or Nothing At All

A live account asked about `get-ryze.ai` and got back ads from a haircare brand and a GP-booking service. Two strangers, presented as their competitors. The domain had been matched loosely by name, and nothing checked whether the advertiser it landed on was actually the company you asked about.

Matching is now strict everywhere. A domain resolves to one advertiser and is confirmed against the links inside that advertiser's own ads where the platform exposes them — a check that rejects lookalike domains rather than accepting anything that merely contains your competitor's name. When a match can't be confirmed, you get an honest empty result instead of somebody else's creatives.

Where a platform gives no website to verify against — TikTok and LinkedIn identify advertisers by name only — the result says so, so you can judge the match yourself.

Two smaller honesty fixes shipped with it. An empty TikTok or LinkedIn result now reads "no ads found on TikTok (worldwide)" rather than "none in this market", which was a claim about where a competitor advertises that Adspirer had no basis for. And one bad domain in a list no longer kills the whole report — the rest run, and the ones that couldn't be read are named.

→ [Tool catalog](https://www.adspirer.com/docs/agent-skills/tools.md)

## Competitor Video Opens Where It Actually Plays

Yesterday's release played competitor video inside the card. In Claude that turned out to render a blank white frame that never played — the sandbox around the card blocks an embedded player, and no setting on our side changes that.

So the video no longer pretends to play in place. You get the poster frame with a **Watch on YouTube / Meta / TikTok / LinkedIn ↗** link, and clicking it opens the ad on the platform it runs on, in a new tab. The frame is still read with vision analysis exactly as before, so the written analysis of the video is unchanged.

The Summary tab also stopped growing without limit — a long analysis scrolls inside the card now instead of stretching it down the page. And the **Your ads** tab no longer appears when there is nothing to put in it; it used to tell customers who were already connected to "connect an ad account".

→ [Tool catalog](https://www.adspirer.com/docs/agent-skills/tools.md)

## Google Tag Manager Joins Your Connections

"Is my Meta pixel actually installed?" and "why isn't this conversion firing?" were questions your agent could see the symptoms of and not the cause.

**Google Tag Manager** is now a connectable integration, alongside Google Analytics, Search Console, and Klaviyo. Connect it at [adspirer.ai/connections](https://adspirer.ai/connections) and the agent can read the tags and variables in your containers — which conversion pixels, analytics, and remarketing tags are on your site, and how each is configured.

It can also create or update a tag or a variable. That writes to a live container firing tracking on your real website, where a wrong edit breaks conversion tracking everywhere at once, so the agent confirms the exact change with you first and leans on the read actions for diagnosis.

Check whether your conversion tracking is really installed.

List the tags in my Google Tag Manager container and tell me whether my Meta
pixel and Google Ads conversion tag are both there and firing on the right pages.

→ [Integration tool reference](https://www.adspirer.com/docs/agent-skills/tools.md)

## One Integration, More Than One Account

An integration held exactly one account. One GA4 login, one Search Console user, one Klaviyo. Agencies with a client's analytics and their own, or anyone whose properties sit under two logins, had to disconnect and reconnect to switch.

Every integration now holds several accounts at once, the same way ad accounts already work — all equal, no primary. Add one with **Connect another account** on that integration's card in [Connections](https://adspirer.ai/connections), and each account gets its own row you can disconnect on its own. How many you can connect follows your plan's account limit.

When an integration has more than one account, tell the agent which one you mean and it uses that; ask and it lists what it can see. With a single account nothing changes — you say nothing and it resolves as it always did.

→ [Integration tool reference](https://www.adspirer.com/docs/agent-skills/tools.md)

**August 15, 2026**

Competitor video ads are read instead of skipped, and the competitor card becomes three tabs instead of one long scroll

## Competitor Video Ads Are Read, Not Skipped

A large share of what advertisers run is video, and `competitor_ads_research` was stepping straight past all of it. A competitor's video ad came back as nothing at all.

Now each video ad's poster frame is pulled from the ad-transparency listing and read with the same vision analysis an image ad gets. The video shows up in the gallery with its headline, offer, format, and run duration alongside everything else. Click the frame and the ad plays inline in the card; close it and you're back in the gallery exactly where you left off.

One frame is described as one frame. Adspirer reads what that frame shows and doesn't narrate the rest of a video it hasn't watched.

## The Competitor Card Splits Into Three Tabs

The card stacked the written analysis, the competitor gallery, and your own ads into one continuous scroll — and the analysis arrived with its formatting showing as raw characters, literal `##` and `**` sitting in the middle of sentences.

Both are fixed. The analysis renders as formatted text with real headings and emphasis, and the card is now three tabs — **Summary**, **Ads**, and **Your ads** — so you can read the takeaway first and then go look at the creatives behind it.

→ [Tool catalog](https://www.adspirer.com/docs/agent-skills/tools.md)

**August 14, 2026**

See a competitor's live ads next to your own — real creatives, offers, and how long each one has been running

## `competitor_ads_research` — Their Live Ads, Next To Yours

Ask what a competitor is advertising and you now get their actual ads back: creatives, headlines, offers, calls to action, formats, and how long each one has been running. They come from public ad-transparency sources, and every creative is read with a vision model so the copy and the offer are extracted rather than left as an image you squint at.

The second half is the part an ad-spy tool can't reach. Your own connected accounts land in the same answer — the ads you're running, and any competitor brand terms you're already paying for.

**You supply the domains.** `competitor_domains` takes websites, not brand names — `semrush.com`, not "Semrush". A bare brand name returns nothing, so if you name a company without a website the agent asks for one instead of guessing. It never invents a competitor list for you either. `region` takes an ISO country code and defaults to your own account's market.

Running more than one ad account? Pass `account_id` (or `customer_id` — same field) to scope the your-ads half of the comparison to one of them. Leave it off and the comparison covers every connected account and tells you so.

> [!WARNING]
>
> It does not return competitor spend, ROAS, conversions, CPC, or impressions. No source publishes those, so Adspirer never estimates them. A creative that has been running for 1,200 days has been running for 1,200 days — that's a duration, not proof it works.

In ChatGPT and Claude the result renders as an interactive card with a scrollable creative gallery; every other client gets the same findings as text. Available on Pro and Max.

Put two competitors' live ads next to your own account.

Show me what semrush.com and ahrefs.com are running as ads right now, and put
it next to what my own account is running.

→ [Tool catalog](https://www.adspirer.com/docs/agent-skills/tools.md)

**August 13, 2026**

Connect Google Search Console and put your organic search performance next to what you pay for it

## Google Search Console Joins Your Connections

Your agent could see what you pay for in Google Ads and what happens on the site afterwards in GA4. The half in between — what you rank for without paying — wasn't there.

**Google Search Console** is now a connectable integration, alongside Google Analytics and Klaviyo. Connect it at [adspirer.ai/connections](https://adspirer.ai/connections) and the agent can read organic-search performance for any site you've verified: clicks, impressions, CTR, and average position, broken down by query, page, country, device, or date.

The useful part is the comparison. Paid and organic search results for the same query now sit in one conversation, so "which of my top Google Ads keywords do I already rank for organically" is a question your agent can actually answer.

It can also ask Google to re-crawl a page after you publish or update one. That one's a write, so the agent confirms the exact URL with you first.

Find paid keywords you're already winning organically.

Pull my top 25 Search Console queries by clicks for the last 28 days, then
check which of them I'm also bidding on in Google Ads and what those cost me.

→ [Integration tool reference](https://www.adspirer.com/docs/agent-skills/tools.md)

**August 13, 2026**

Target Impression Share bidding arrives, a strategy switch that used to report success without changing anything is fixed, and conversion actions become editable

## Bid For The Top Of The Page: Target Impression Share

Impression-share bidding meant a trip to the Google Ads interface. `update_bid_strategy` now accepts **`TARGET_IMPRESSION_SHARE`** alongside Target CPA, Target ROAS, Maximize Clicks, and Maximize Conversions.

You set two things: where you want to appear — **absolute top of page**, **top of page**, or **anywhere on the page** — and the share of auctions you want to win there, 1 to 100.

Send a **max CPC ceiling** too. Without one, a target of 90% at the absolute top will chase that number as far as your budget allows. The ceiling is a plain amount in the ad account's own currency, so a €4 ceiling is `4` — not 400, and not converted to dollars.

Switch a brand campaign to impression-share bidding with a bid ceiling.

On my brand Search campaign, switch bidding to target impression share —
80% at the absolute top of the page, with a max CPC ceiling of \$4.

→ [Google Ads integration](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

## A Bidding Switch That Said "Done" And Changed Nothing

This one affected **every** bid strategy change, not only the new one. Moving a campaign from one strategy to another — Maximize Clicks to Maximize Conversions, say — could come back reporting success while Google quietly kept the old strategy. The response said the change landed. The campaign carried on bidding exactly as before, and nothing in the reply gave you a reason to check.

That's fixed. And because a false success is the hardest kind of failure to notice, `update_bid_strategy` now **reads the strategy back from Google after writing it** and returns an honest error when the campaign isn't on the strategy you asked for. A change Google declines can no longer be reported as a change that worked.

> [!NOTE]
>
> If you switched a Google Ads bid strategy through Adspirer before August 13 and the performance never moved the way a strategy change should, check what the campaign is actually bidding on now. It may never have switched.

→ [Google Ads integration](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

## Edit A Conversion Action Instead Of Rebuilding It

Changing anything about a live conversion action — its name, its default value, how long its click window runs — meant doing it in the Google Ads interface, because Adspirer could only read conversion actions or create new ones.

**`update_conversion_action`** edits one in place. Pass the conversion action ID plus whatever you want changed: name, category, status, value and currency, counting type, click-through and view-through lookback windows, whether it counts in the Conversions column, whether it's primary for its goal, or its attribution model.

Only the fields you pass change. Everything else stays as it is, and the tool never removes a conversion action — to stop one counting, set `status` to `PAUSED`, which you can undo.

Value changes are handled carefully on purpose: a conversion's value, currency, and always-use-default setting move as a set, and if Adspirer can't read the action's current settings first, the update fails rather than guessing. Smart Bidding reads those numbers, so a value silently rewritten to zero is worse than an update that didn't happen.

Widen a conversion action's click window without touching anything else.

List my Google Ads conversion actions, then change the click-through lookback
window on the Purchase one to 60 days. Leave everything else as it is.

→ [Google Ads integration](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

**August 12, 2026**

Pause hundreds of keywords in one call, Meta updates that show you the value they applied, an audit that stops passing agency accounts it never read, and an Expert Kit that installs an agent instead of overwriting yours

## `bulk_update_keyword_status` — Pause 300 Keywords In One Call

Pausing a list of keywords meant one `update_keyword` call per keyword. The only bulk option was `remove_keywords`, which **permanently deletes** — so the fast path and the safe path were different paths.

**`bulk_update_keyword_status`** sets status on up to **300 keywords in one ad group** in a single call, in both directions: `PAUSED` or `ENABLED`. It's fully reversible, and re-running it on a keyword already in the target status does nothing, so a retry is safe.

You pass explicit keyword IDs. There is deliberately no "pause everything" mode — that's how a whole ad group gets switched off by accident. The delete-confirmation gate now points bulk-pause requests here instead of at `remove_keywords`.

Pause a batch of underperforming keywords without deleting them.

Find keywords in my Search campaign that spent more than \$50 last month with
zero conversions, then pause all of them in one go. Don't delete anything.

→ [Google Ads integration](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

## Meta Updates Now Show You The Value They Applied

A successful Meta update replied with field *names* only — "Updated Fields: `daily_budget`". Not the value. So a budget that landed wrong was invisible in the response, and neither you nor your assistant had anything to catch it against.

Every Meta update tool now echoes each field **with the value that was applied**, money rendered in the ad account's own currency — an Australian account reads `A$2,000.00`, not a dollar sign bolted onto the number. That covers campaign, ad set, ad, and the three catalog update tools. Each response ends by asking you to check the values before moving on, because they are live at that point.

Catalog updates used to be the worst case: editing only a product set, pixel, or retargeting audience could report an **empty** change list on a successful write. Those fields now come back under readable names.

→ [Meta Ads integration](https://www.adspirer.com/docs/ad-platforms/meta-ads.md)

## The Conversion Audit Was Passing Accounts It Had Never Read

If you manage Google Ads through a manager (MCC) account, `audit_conversion_tracking` was sending the wrong manager account on every request. Google refused it, the Google checks abstained, and the audit still printed a **Grade A** — a clean bill of health on an account it had not actually examined. Around **547 manager-managed accounts** were affected.

Shared agency accounts had a second version of the same problem. Performance rows are stored under whichever teammate's login collected them, and the audit only counted rows belonging to *you* — so a colleague auditing a shared account saw zero conversion volume and got a "0/0 stable" **pass**. LinkedIn audits returned that same false pass for every account, from a platform-name mismatch.

Both are fixed, and the report is honest about the difference between *checked and healthy* and *couldn't check*: when a critical check can't run, the header now reads **Incomplete** rather than showing a grade. `diagnose_funnel` no longer reports that "tracking checks out" on the back of an incomplete audit.

> [!WARNING]
>
> If you run Google Ads under a manager account or share an account with teammates, re-run your conversion tracking audit. A previous Grade A may have been an audit that never reached your account.

→ [Multi-client agency setup](https://www.adspirer.com/docs/knowledge-base/multi-client.md)

## The Expert Kit Ships An Agent Instead Of Overwriting Yours

The Prompt Engineering Playbook used to tell you to copy its `AGENTS.md` to your project root. That is a single well-known filename — so the step **replaced whatever was already there** with "work only on Google Ads account NNN", and a coding agent that had been useful for your own work stopped being useful for anything else.

That step is gone, and it was never necessary. Every one of these clients has a first-class slot for exactly what an Expert Kit is, so the kit now generates **the agent definition itself** — `.claude/agents/`, `.cursor/agents/`, `.agents/agents/` as markdown, Codex as TOML. Your account instructions become that agent's system prompt, the file points at the skill, and on Claude Code, Codex and Antigravity it declares `mcp.adspirer.com` too, so there's no connector left to wire up. A uniquely-named new file can't clobber anything, and uninstalling is deleting it.

Skills now install at **project scope**, never the `~/` home paths — those loaded one account's ads agent into every unrelated repo on your machine.

Setup is now per client, and every claim was re-checked against that vendor's own documentation:

* **Claude** — five steps: create the project, upload the skill, paste the agent instructions into the project instructions, add the prompt book to project knowledge, connect. Skills are on **every plan, including Free** (we had said paid-only), the upload control is **Add** rather than "+ Create skill", and Team and Enterprise do this under **Organization settings**. Teams can upload once for the whole org instead of once per seat.
* **ChatGPT** — instructions and files, in a project. ChatGPT chat can't install a standalone skill; OpenAI scopes those to Codex, including Codex running inside the desktop app.
* **OpenClaw** — its own steps. It's a workspace-scoped gateway, not a project-based IDE.
* **Windsurf** — removed from the kit. Cognition renamed it Devin Desktop, it isn't on the Agent Skills client list, and nothing documents the desktop app loading a local skill. This does not affect using Windsurf as an MCP client — [that setup](https://www.adspirer.com/docs/ai-clients/windsurf.md) is unchanged.

The prompt book changed shape too: each entry was a one-line prompt, and is now a short operating brief — the goal, what to look at, the guardrails, and how to report.

→ [Prompt Engineering Playbook](https://www.adspirer.com/docs/agent-skills/prompt-engineering-playbook.md)

**August 11, 2026**

TikTok Instant Form lead generation, Meta errors that name the failure, and a budget unit that told you to send 100x

## TikTok Lead Generation Campaigns Can Be Built At All Now

Lead generation with a TikTok Instant Form was structurally impossible here — not because of one bug, but because the `page_id` that attaches a form to an ad was dropped at six independent points between your request and TikTok. Each one was fatal on its own. All six are fixed.

**`list_tiktok_lead_pages`** lists the Instant Forms on your advertiser with the `page_id` each one needs, and says whether the form is `PUBLISHED` — TikTok won't let a draft be attached to an ad.

**Start here, though: an Instant Form is the minority path.** Most live lead-gen campaigns capture leads on your own site instead, with a pixel on the ad group and `optimization_event=FORM`. Run `list_tiktok_pixels` for that route. Use an Instant Form when you specifically want the form hosted inside TikTok.

Three ad group settings that TikTok requires for lead gen — and which it reported only as the useless *"There was an error with the Lead Generation advertising objective"* — are now set for you:

* The ad group is promoted as lead generation, not as a website visit
* A custom bid is set, because TikTok refuses its own no-bid strategy on this objective
* Placements are named explicitly, because automatic placement is rejected

A form ad also can't carry a landing page URL — the TikTok-hosted form *is* the destination, and TikTok rejects an ad holding both. `add_tiktok_ad` had been sending both; it now carries exactly one destination, matching campaign creation.

Launch a TikTok lead generation campaign on an Instant Form.

What TikTok Instant Forms do I have, and which are published? Then build a
lead generation campaign on the published one, \$40/day, targeting the US.

→ [TikTok Ads integration](https://www.adspirer.com/docs/ad-platforms/tiktok-ads.md)

## Meta Failures Now Hand You The Identifiers Meta Sent

A customer spent three days isolating a Meta ad set publish failure — twelve controlled tests, then rebuilding the campaign by hand in Ads Manager to compare — and finally asked us for the error code, subcode and `fbtrace_id`. Adspirer had all three on every one of his failures and printed none of them. Across the previous 30 days, **2% of Meta errors reached a customer carrying an `fbtrace_id`**.

Without those, there is nothing to act on and nothing to quote to Meta support. They now trail the error as their own reference line, so a failure that Meta sends without identifiers reads exactly as it did before.

Two routes — including `add_ad_set`, the customer's failing call — had hand-rolled their own error handling and were the last Meta write paths still discarding the identifiers. All 32 Meta write paths behave identically now. When Meta sends a title and an explanatory sentence but no user-facing message, you get the sentence too, rather than a bare title.

→ [Meta Ads troubleshooting](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#troubleshooting)

## Meta Budget Fields Said "Cents". They Were Never Cents.

Every caller-facing description on a Meta money field — budgets, bids, spend caps, spend targets — told your assistant to send cents, or to convert to USD. The tools have always taken the value in **the ad account's own currency**, and converted internally.

An assistant that followed the description literally sent `2000` for a 20/day budget, and Adspirer converted it again. That is a **100x budget**, on `update_meta_campaign` and `update_meta_ad_set` above all.

Every Meta money-field description is now uniform: the ad account's own currency, as a decimal. For 20/day, send `20`. No conversion arithmetic changed — the tools behaved correctly the whole time, and only the instructions were wrong. The project-setup skill, which had been stamping "Meta = CENTS" into generated brand context, is corrected too.

> [!WARNING]
>
> If you set a Meta budget or bid through Adspirer before August 11, 2026, check the value that actually landed on the campaign. An assistant that followed the old wording would have set it 100x too high.

→ [Meta budget guidelines](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#budget-guidelines)

**August 9, 2026**

TikTok campaign creation actually works — pixel and video discovery, and two tools that never once succeeded are gone

## Two TikTok Tools That Had Never Worked Are Gone

`create_tiktok_campaign` succeeded **zero times in 176 attempts** across 33 customers over the past year. `create_tiktok_carousel_card` never worked either. Neither was fixable: TikTok's in-feed placement requires a video creative, so a single-image in-feed campaign is rejected on principle, and the carousel tool was built against an endpoint that doesn't accept the value it was sending.

Both are removed. Asking for them now returns a clean "unknown tool" with a pointer to what to use instead, rather than a campaign that half-builds and then fails.

**`create_tiktok_video_campaign` is the creation tool**, and it now honours all three creative sources its schema has advertised since April:

* **`video_url`** — a public MP4/MOV that Adspirer uploads for you
* **`video_id`** — a video already in your TikTok library, reused without re-uploading
* **`tiktok_item_id`** — an organic post boosted as a Spark Ad

The two ID-based paths were dropped at four separate layers and always failed with *"Video asset (URL or data) is required"* — after creating a partial campaign. They work end to end now. `add_tiktok_ad` with an existing `video_id` used to fail with *"You must upload an image"*, because TikTok wants a cover alongside the video; Adspirer derives the cover itself.

## Find Your Pixel Instead Of Guessing At It

Conversion campaigns were TikTok's largest failure cluster — **124 attempts, 27 customers, one success**. You had no way to discover a pixel or the events it accepts, so both got guessed at.

**`list_tiktok_pixels`** returns each pixel on the advertiser with the **numeric `pixel_id`** TikTok requires — not the alphanumeric Pixel Code, which TikTok rejects — and the exact `optimization_event` values that pixel supports. Pixels with no events configured are flagged as unusable for conversion optimization rather than handed back as if they'd work.

Adspirer no longer defaults `optimization_event` to `COMPLETE_PAYMENT`. The valid set is per-pixel, so a fixed guess is simply wrong for anyone whose pixel doesn't carry that event. Ask for a conversion campaign without one and you're told to run `list_tiktok_pixels` for the real list.

## A Conversion Campaign That Was Quietly Built As Something Else

`WEB_CONVERSIONS` was missing from all three creation paths, so it fell through to each one's default. A campaign you asked to optimize for conversions was built as **video views** or **traffic** — and it still spent, with your purchase pixel attached to an ad group optimizing for something else entirely. If your TikTok conversion campaigns have been underperforming without an obvious reason, this is worth a look at what actually got built.

`WEB_CONVERSIONS` maps correctly now in all three.

## `list_tiktok_ad_videos` — Reuse A Video You Already Uploaded

Lists your advertiser's video library with the `video_id` for each, so a second ad from the same video doesn't mean a second upload. `discover_tiktok_assets` used to claim TikTok's API "does not support listing or searching existing assets," which was never true; it covers your image library and now points at the video tool for videos.

Pixel and video lookups also raise a real error when TikTok's API fails. A timeout or a permission denial used to render as a confident "no pixels on this advertiser," with instructions to create one you may already have had.

## What TikTok Genuinely Doesn't Allow, Said Plainly

* **Image-only in-feed ads are rejected by TikTok**, not by Adspirer. Images are supporting assets alongside a video creative — `upload_tiktok_images` and `discover_tiktok_assets` feed `image_ids` into a video ad.
* **Carousel ads can't be built through the API.** Build the carousel in TikTok Ads Manager, then boost that post here as a Spark Ad with its `tiktok_item_id`.

Set up a TikTok conversion campaign with the right pixel and event.

Which TikTok pixels do I have, and what conversion events does each one
support? Then set up a conversions campaign on the one that tracks purchases,
\$50/day, using a video I've already uploaded.

→ [TikTok Ads integration](https://www.adspirer.com/docs/ad-platforms/tiktok-ads.md)

**August 8, 2026**

Google App campaigns become readable — promoted app, bidding goal, real target CPA, and install counts that aren't zero

## Your App Campaign Read Back As A Blank "MULTI\_CHANNEL"

Google files App campaigns under the channel type `MULTI_CHANNEL`, and that was all `list_campaigns` and `get_campaign_structure` told you. No app, no store, no bidding goal — nothing identifying *which* app the campaign promotes or what Google optimizes toward. If you run a portfolio of apps, that's the first thing you need before touching a budget or a bid.

Campaign reads now name it:

* **The sub-type** — an App campaign says it's an App campaign instead of hiding behind `MULTI_CHANNEL`.
* **The promoted app and its store** — the Play package name or App Store ID Google holds, and which store it points at.
* **The App bidding goal** — install volume, installs at a target cost, in-app conversions, return on ad spend, or pre-registration volume. What Google is actually optimizing toward.

These appear in the normal readback, not behind `raw_data`. Search, Shopping, PMax and every other campaign type read back exactly as before.

## A Live Target CPA That Reported As No Target At All

Google stores a target CPA or ROAS in one of two shapes: as a standalone **Target CPA** / **Target ROAS** strategy, or as a target sitting on top of **Maximize Conversions** / **Maximize Conversion Value**. Adspirer only read the second shape. A campaign running a standalone \$2.00 Target CPA came back with no target at all — so asking "what is this campaign bidding to?" got you silence about a campaign that was very much bidding to a number.

Both shapes are read now, and the readback says which one you have. A bare **Target CPA** is a standalone strategy; **Target CPA (target on Maximize Conversions)** is a ceiling on a maximize strategy. They behave differently, and the difference is worth knowing before you move one.

## `update_bid_strategy` Stops Handing You Google's Opaque Rejection

On an App campaign the bidding strategy is paired with the App bidding goal, and Google refuses a mismatched pair with *"bidding strategy is incompatible with the goal type"* — which tells you nothing about which half to change. Campaign creation already enforced the pairing. Updates didn't know App campaigns existed, so the two disagreed.

The check now runs before the call reaches Google. If the strategy you asked for doesn't fit the campaign's goal, you get the goal, the strategy that goal requires, and both ways forward: change the goal in Google Ads (which resets the campaign's learning — your decision, not something Adspirer does behind a bid change), or use the strategy that matches the goal you have. Non-App campaigns are untouched, and a goal Adspirer can't identify goes to Google rather than being blocked on a guess.

## Installs And Cost Per Install Were Zero On Every Google App Campaign

Adspirer wasn't collecting Google's app-install metric at all, so `installs` read `0` on every Google app campaign while Google reported six figures of installs over the same window for a single account. Installs, cost per install, and post-install conversions are collected now.

Two things worth knowing. **Cost per install is reported only when there are installs** — no installs means no CPI, rather than a number with nothing behind it. And **periods already collected stay at zero until they're re-collected**, so a June app campaign still looks flat when you look back at it.

Read an App campaign back before you touch its bids.

Show me the structure of my Google App campaign — which app it promotes, what
it's optimizing for, and what it's bidding to.

→ [Google Ads integration](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

**August 8, 2026**

A Google budget change that fails now says so, instead of reporting success

## "Campaign Updated Successfully" Now Means The Budget Actually Changed

When you asked Adspirer to change a campaign's daily budget and Google rejected the change, `update_campaign` came back with **"Campaign updated successfully"** anyway. The failure was logged somewhere you couldn't see it. If you were moving budget through an agent — lifting the cap on a winner, cutting one on a loser — you got a confirmation for a spend cap that had not moved.

Budget updates now report what actually happened:

* **The budget was the only thing you asked to change, and it failed.** You get a failure that says plainly that nothing on the campaign changed, with Google's own reason attached.
* **Other changes landed but the budget didn't.** You get a failure that names exactly which changes *did* apply and don't need re-running, so your retry is the budget alone rather than the whole call.
* **Adspirer couldn't find the campaign's budget at all.** This used to be indistinguishable from success. It now says so, and names the likely causes — the campaign doesn't exist, it was removed, or the account doesn't grant access to its budget.
* **A budget change that works names the new amount** in the list of applied changes, instead of asserting success in general terms.

This applies to every Google campaign type, not just one. Pausing, resuming and deleting a campaign never touch the budget, so they behave exactly as before.

The same honesty now holds one layer up: when your AI client reports a campaign update, it reads the result's own success flag rather than assuming the request went through. An update that didn't happen can't be passed back to you as one that did.

→ [Google Ads integration](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

**August 7, 2026**

Meta app campaigns stop failing, video completion metrics stop reading zero, and Google errors name the actual problem

## Meta App Campaigns Stop Bouncing Off "Mobile Targeting Mismatch"

App-promotion ad sets were the single largest cluster of Meta campaign-creation failures. Meta rejected them with *"The app you're trying to create an ad for is on a different operating system than targeting settings for this ad set"* — because the campaign named an app without constraining the targeting to that app's OS.

Adspirer now reads the OS off your app's store URL and sets it for you. An App Store link targets iOS, a Google Play link targets Android, and either way the ad set is constrained to mobile — an app install can't be fulfilled on a desktop. This applies wherever an app ad set gets built: image, video, and carousel campaigns, `add_meta_ad_set`, and `update_meta_ad_set` when you repoint an existing ad set at an app on the other platform.

You can override it with `user_os` if you need to. If that override contradicts the store URL, Adspirer stops and says so instead of forwarding Meta the exact pair it rejects.

**`list_meta_promotable_apps` finds your app instead of you guessing at it.** App campaigns need the numeric *Facebook* App ID — not an iOS bundle ID, not an Android package name — and customers were guessing (a literal `YOUR_FACEBOOK_APP_ID` reached Meta in production). The new tool lists the apps your ad account can promote, each with its App ID and the store URLs Meta already holds, so both fields get filled without leaving the conversation. Apps with no mobile store listing come back separately with the reason, rather than quietly missing.

Launch a Meta app-install campaign without hunting for IDs.

Which mobile apps can I promote on Meta? Then set up an app install campaign
for the iOS one at \$30/day.

## Your Meta Video Completion Rates Were Zero. They Were Never Zero.

Video view-through and completion metrics — 25%, 50%, 75%, and 100% watched — were being recorded as `0` for every account. Adspirer was looking for the completion percentage in the wrong part of Meta's response, so real numbers were read as nothing: one delivering account had **103,316 quarter-views and 13,823 completions** all stored as zero. Anything built on them — Meta video analysis, creative comparisons — inherited the zeros.

Newly collected data is correct. **Periods already collected before this fix stay at zero until they are re-collected**, so a video campaign you ran in July will still look flat when you look back at it.

## Advantage+ State And Bid Strategy, Readable And Editable From Chat

**Campaign reads now include `advantage_state_info` and `bid_strategy`** — so you can ask whether Advantage+ is actually on for a campaign and what it's bidding toward, instead of opening Ads Manager to check. Meta retired the old Advantage+ App Campaign API object in May; this is the readback surface for the model that replaced it.

**Campaign-level bid strategy is editable.** `update_meta_campaign` used to refuse and tell you to go adjust it in Meta Ads Manager. It now accepts `LOWEST_COST_WITHOUT_CAP`, `LOWEST_COST_WITH_BID_CAP`, `COST_CAP`, and `LOWEST_COST_WITH_MIN_ROAS`. The capped strategies need a bid cap on the ad sets first (`bid_amount` via `update_meta_ad_set`) or Meta rejects the change.

## Google Errors That Name The Actual Problem

**Broad-match-only Search campaigns.** If a campaign runs broad match only (AI Max), Google rejects exact and phrase keywords with an error code newer than the client library can name — so the only thing that surfaced was the placeholder *"The error code is not in this version."* Neither you nor your AI client could tell what to fix. Adspirer now reads the campaign's real match-type setting before saying anything, then explains that this campaign takes broad match only. Exact and phrase keywords on normal campaigns are unaffected.

**Retail PMax asset groups build in the right order.** Google validates an asset group at the end of each batch of asset links, so interleaving asset creation with asset linking could start validation before the required assets existed — and the campaign failed on assets you had actually supplied. Every asset is now created before anything is linked.

→ [Meta Ads integration](https://www.adspirer.com/docs/ad-platforms/meta-ads.md) · [Google Ads integration](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

**August 6, 2026**

Meta summary numbers now say when they don't apply, and the conversion audit scopes to one account

## A 0.00x ROAS On A Traffic Account Is Not A Failing Account

If your Meta campaigns run traffic, awareness, engagement or link-click objectives, Meta reports no revenue against them — ROAS is `0` by design. `get_meta_campaign_performance` handed your AI client that bare `0.00x` with nothing attached, and clients read it as an account in trouble.

Every summary number now carries whether it applies to *your* account's objectives:

* **The ROAS row reads "Not applicable"** instead of `0.00x`, with a sentence underneath naming the objectives behind it — "traffic and engagement campaigns, measured by CPC. ROAS is not a meaningful measure here."
* **Your account's actual primary KPI is named** — cost per conversion, cost per install, CPC, CPM, cost per video view, whichever your objectives call for — so the agent leads with the number that matters instead of the first one in the table.
* **Lead-gen, messaging and app accounts are described correctly.** They expect conversions that carry no revenue, so they're measured on cost per conversion or cost per install — not reported as broken tracking.
* Accounts whose objectives Meta never recorded are told exactly that, rather than assumed to be traffic accounts.

No number changed. The same flags reach the in-chat dashboard tile, so the widget and the text can't contradict each other, and they survive raw-data responses — whether a metric applies is a fact about the number, not advice.

## No More "Scale This Segment" On A Segment You Can't Target

`analyze_meta_audiences` used to close with "Best performing segment: X with Nx ROAS. Consider increasing budget allocation" every time. Three fixes:

* **It names the metric the ranking actually used.** On an account with no conversion value the segments are ranked by CTR, so the message now says CTR ranks engagement rather than quoting a ROAS figure that means nothing there.
* **Meta's `Unknown` demographic bucket no longer wins.** That bucket holds people Meta couldn't resolve, so its spend and its attributed value describe different populations and the ratio is fiction — one account showed 623x while every resolvable segment sat at 1.3–2.2x. It is out of the ranking and stays in the age and gender breakdowns as a measured fact. You couldn't target it anyway.
* **"Scale" has to be earned.** A top-ranked segment without the volume to back the claim now gets a plain statement of what was measured, instead of an instruction to move budget onto the segment we know least about.

## Audit One Account, Not All Of Them

`audit_conversion_tracking` takes an optional `account_id` (`customer_id` works too, for Google Ads). Without it the audit sweeps every active account on the platform — a lot of live API calls if you run several — and agents used to narrow it by switching your active accounts, changing state you never asked to change.

Scope the conversion audit to a single account.

Audit conversion tracking for just my main Google Ads account, not all of them

→ [Meta Ads integration](https://www.adspirer.com/docs/ad-platforms/meta-ads.md) · [Tool catalog](https://www.adspirer.com/docs/agent-skills/tools.md)

**August 6, 2026**

One flat Expert Kit that installs cleanly in every AI client

## One Zip, One Folder — The Expert Kit Installs Where You Point It

We audited the [Prompt Engineering Playbook](https://www.adspirer.com/docs/agent-skills/prompt-engineering-playbook.md) kit against the Agent Skills spec and against every client's own documentation. The skill itself was conformant. The packaging and the setup steps were not.

**One download, one folder, flat inside.** The kit is now a single root folder — `SKILL.md`, `AGENTS.md`, `PROMPTBOOK.md`, `README.md`, and `references/` — which is exactly the shape Claude's uploader documents *and* exactly what the filesystem clients want copied into a skills directory. One download now serves every client. Only `references/` still nests, because that is the spec's progressive-disclosure mechanism: the dossier loads on demand instead of burning context on every activation.

**One instructions file.** `AGENT_INSTRUCTIONS.md` is gone — it was a third copy of text already in `AGENTS.md` and already behind the kit page's **Copy instructions** button. Kits you downloaded before this change keep working exactly as they did.

**A README that says where each piece goes**, per client, so the folder explains itself even if you unzip before reading anything.

**Setup steps that name the actual path.** The wizard now gives Claude's real route — Customize → Skills → **+ Create skill**, with code execution turned on first — and the literal install directory for coding agents: `~/.claude/skills/` for **Claude Code**, `.agents/skills/` for **Codex**, **Cursor**, **OpenClaw**, and **Antigravity**, instead of "check its docs". It also tells you to copy `AGENTS.md` up to your project root, which is the only place agents actually read it. **ChatGPT** and **Windsurf** now route down the paste path, which is the one that works on those clients today.

**The prompt book is now visible to your agent — as a menu, not a script.** It can open `PROMPTBOOK.md` to suggest a sensible next step, or to find the right approach for something you asked for, and then run just that one. It is explicitly told never to work through the book in bulk or in order, because every prompt in it spends real tool calls. You can also download the prompt book on its own as a `.md`.

Also: an account with nothing to show yet — brand new, or simply quiet — now builds its honest no-recent-activity kit instead of failing. → [Prompt Engineering Playbook](https://www.adspirer.com/docs/agent-skills/prompt-engineering-playbook.md)

**August 5, 2026**

Prompt Engineering Playbook — an agent trained on your own ad account

## A Playbook Generated From Your Own Ad Account

The **[Prompt Engineering Playbook](https://www.adspirer.com/docs/agent-skills/prompt-engineering-playbook.md)** reads one of your ad accounts — its campaigns, spend history, and current state — and generates a set of agent files you download and install in your AI client:

* **`SKILL.md`** — an operating doctrine scoped to that one account, in the open [Agent Skills](https://agentskills.io) format
* **`references/account-profile.md`** — a written dossier: what state the account is in, what to prioritize, what cadence to work on
* **`PROMPTBOOK.md`** — starting prompts written against your real campaigns and currency
* **`AGENT_INSTRUCTIONS.md`** / **`AGENTS.md`** — paste-ready instructions for Claude and ChatGPT Projects, and the [agents.md](https://agents.md/) file that folder-based clients read automatically

This sits on top of the [13 free Agent Skills](https://www.adspirer.com/docs/agent-skills/skills.md), which every plan already gets. Those teach advertising in general; the playbook is your specific account, written down.

**\$39 one time, per ad account — not a subscription.** Nothing recurs, and the files are yours to keep. Annual plans include one free. Rebuilding against fresh account data is free and unlimited. → [Pricing](https://www.adspirer.com/docs/knowledge-base/pricing.md#add-ons-one-time-purchases)

**July 7, 2026**

Delete-confirmation safety gate

## A Hard Gate So "Pause" Never Means "Delete"

Adspirer now hard-gates every destructive tool. `remove_*` and `delete_*` tools carry a `destructiveHint` and **won't run unless the call explicitly passes `confirm_delete: true`**, and a "pause" request is never routed to a delete tool. This closes a class of error where an ambiguous instruction like "pause these keywords" could be interpreted as a permanent deletion. Read tools still auto-run; only irreversible actions are gated. → [Tool safety model](https://www.adspirer.com/docs/mcp.md#tool-safety-model)

**July 6, 2026**

Google App campaigns + LinkedIn campaign groups & forecasting

## Google App Campaigns + a Much Deeper LinkedIn

**Google App (Universal App) campaigns.** `create_app_campaign` launches campaigns that drive app **installs, engagement, or pre-registration** across Search, Google Play, YouTube, Display, and Discover — with app-ad creative management. Created PAUSED for review. → [Google App campaigns](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

**LinkedIn, deepened (now 55 tools).** New this week:

* **Campaign groups** — create, update, delete, list, search, and batch-create groups with shared budgets and schedules.
* **Pre-launch forecasting** — `estimate_linkedin_audience_size` and `forecast_linkedin_campaign_supply` project reachable audience and expected impressions/clicks/spend at a given budget, so you size campaigns with data.
* **Full lifecycle** — archive, reactivate, delete, clone, and batch-update campaigns.

→ [LinkedIn Ads integration](https://www.adspirer.com/docs/ad-platforms/linkedin-ads.md)

**July 4, 2026**

Google Shopping + Merchant Center + smarter tool discovery

## Google Shopping Campaigns Arrive

Run **Standard Shopping** campaigns straight from your Google Merchant Center feed — no per-product ad building.

* `link_merchant_center` / `get_merchant_center_links` connect your product feed.
* `create_shopping_campaign` → `add_shopping_ad_group` → `add_shopping_product_ad` builds the campaign.
* **Product partition trees** (`add_product_group` and friends) let you subdivide the feed by brand, category, product type, or item ID and bid on each partition independently.

→ [Google Shopping campaigns](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

**Smarter tool discovery.** As the surface grows past 400 tools, new `search_tools` (find the right tool from a natural-language description) and `get_tool_schema` (fetch a tool's exact parameters) keep the AI accurate. → [How discovery works](https://www.adspirer.com/docs/mcp.md)

**July 3, 2026**

Google Ads Manager-parity deep management

## Manager-Parity Deep Management for Google Ads

Google Ads is now Adspirer's deepest integration at **147 tools**, with control down to the ad-group, asset-group, and product-partition level:

* **Search** — ad-group lifecycle and settings, demographics, audiences, proximity / ad-schedule / device-bid targeting.
* **Demand Gen** — create campaigns and ads, manage audiences and channel controls across YouTube, Shorts, Discover, and Gmail.
* **Performance Max** — full asset-group lifecycle, per-asset edits, asset-performance ratings (Best / Good / Low), and listing filters for retail PMax.
* **Campaign-level depth** — tracking, dates, frequency caps, network settings, and labels.

Every write is live-verified against a sandbox. → [Google Ads integration](https://www.adspirer.com/docs/ad-platforms/google-ads.md)

**July 2, 2026**

Cross-platform Ad Ops agents, teach-your-agent + Meta lead forms

## Ad Ops Agents Get Smarter — and Cross-Platform

* **Cross-platform agents.** One agent can now reason and act across **Google, Meta, TikTok, LinkedIn, and Amazon** from a single goal — e.g. "cap total monthly spend at 10,000 CAD across Meta, Google, and LinkedIn."
* **Teach your agent.** Upload your own brand rules, target CPAs, seasonal calendars, and SOPs; every run grounds its decisions in your documents.
* **Evidence-gated impact.** Impact verdicts only make a causal claim when your own data supports it — no more misleading "+54% worse" calls off a tiny sample.
* **Rejection-reason chips.** One tap tells the agent *why* you rejected a proposal, so the next run is better.

Also: **Meta native lead-form campaigns** (on-platform Instant Forms, no pixel required) now pass pre-flight. → [Autonomous Ad Ops agents](https://www.adspirer.com/docs/agent-skills/ad-ops-agents.md)

**June 30, 2026**

Meta Advantage+ Catalog (dynamic product ads)

## Meta Advantage+ Catalog — Dynamic Product Ads

Adspirer now runs **Meta Advantage+ Catalog campaigns (dynamic product ads / DPA)** — the way e-commerce advertisers show the exact products from their feed to the right shopper without hand-building an ad per SKU. **16 new Meta tools** (Meta Ads is now 54 tools):

* **Discover & prepare** — `list_meta_catalogs`, `list_meta_products`, `list_meta_product_sets`, `create_meta_product_set`, and `validate_catalog_readiness` (a pre-flight that tells you whether your catalog + pixel data supports **retargeting** or **prospecting only**, before you spend).
* **Launch & manage** — `create_meta_catalog_campaign` (prospecting or retargeting, created PAUSED) plus catalog ad-set and ad management.
* **Optimize** — `analyze_meta_catalog_performance`, `get_meta_product_performance` (per-SKU ROAS), `detect_meta_catalog_waste`, and `diagnose_meta_catalog_funnel`.

Connect a catalog you already manage in Meta Commerce Manager (or synced from Shopify/WooCommerce) and manage the ads conversationally. → [Meta Catalog ads](https://www.adspirer.com/docs/ad-platforms/meta-ads.md)

**June 24, 2026**

Ad Ops agent builder, approvals & community playbooks

## Build, Approve, and Share Ad Ops Agents

The autonomous Ad Ops agent got a full build-and-run experience:

* **Gallery + 5-step builder** with active-agent cards, background goal-compile so the builder opens instantly, and per-agent detail panels.
* **Approvals from the card** — review, approve, or reject each proposal in place, with server-side approval counts and a per-agent inbox.
* **Impact & Recommendations tabs** — see whether approved changes actually added value (fed back into the next run) and a running list of prioritized, ad-focused suggestions.
* **Community playbooks** — share an agent's decision logic (goal, rules, and guardrails only — never accounts or budgets) and fork others' proven playbooks onto your own account.

→ [Autonomous Ad Ops agents](https://www.adspirer.com/docs/agent-skills/ad-ops-agents.md)

**June 23, 2026**

Shareable Dashboards V2 — white-label & adaptive

## Shareable Dashboards V2 — White-Label & Adaptive

Shareable dashboards were rebuilt into a data- and platform-adaptive report you can hand to clients:

* **White-label** — upload your own logo, set a custom title and footer, and hide Adspirer branding.
* **Adaptive depth** — \~20 analysis blocks (Pareto, anomaly z-scores, efficiency frontier, funnel, treemap, waterfall) that appear only when your data supports them, plus per-platform "signatures" for Google, Meta, TikTok, and LinkedIn.
* **Prompt-mode** — compose a dashboard's layout from a natural-language prompt.

Links stay live (fresh data on open), expire per plan tier, and are revocable. → [Shareable dashboards](https://www.adspirer.com/docs/knowledge-base/capabilities.md#shareable-dashboards)

**June 22, 2026**

Community Plugins — open-source, read-only extensions

## Community Plugins (v1)

Adspirer can now be extended with **open-source, community-contributed analysis tools** that appear alongside the built-in ones via the `community_plugins` router. They're **read-only** to your ad accounts, run in a **credential-free, sandboxed** sub-server, and are loaded from a **pinned, reviewed commit** of the public [`Adspirer/adspirer-mcp-community`](https://github.com/Adspirer/adspirer-mcp-community) repo. First example: a keyword clusterer that groups your search terms into themes. → [Community Plugins](https://www.adspirer.com/docs/agent-skills/community-plugins.md)

**June 20, 2026**

Now in 116 languages + Start Here onboarding

## Adspirer Now Speaks 116 Languages

The Adspirer dashboard, onboarding, and AI-client setup guides are now localized into **116 languages**, with:

* **Automatic browser-language detection** and a one-click language switcher.
* Full **right-to-left (RTL)** support for Arabic, Hebrew, Persian, Urdu, and more.
* A language preference that's **remembered across devices**.

And because you manage ads by chatting with an AI, you can give instructions in your own language. → [Localization](https://www.adspirer.com/docs/knowledge-base/localization.md)

Also new: a redesigned **Start Here** onboarding experience with an interactive, illustrated card carousel and try-it prompts that track real completion from your own account history.

**June 18, 2026**

Autonomous Ad Ops agents are live

## Autonomous Ad Ops Agents Go Live

Adspirer's **autonomous Ad Ops agents** are out of beta. Give an agent a plain-English goal and a cadence, and it monitors your accounts on a schedule and **proposes every change to an approval queue** — find winners to scale, wasted spend to cut, budgets to rebalance, CPA/ROAS drift to correct, or broken conversion tracking to flag. Nothing spends or changes without your approval, enforced server-side. Available on Plus, Pro, and Max. → [Autonomous Ad Ops agents](https://www.adspirer.com/docs/agent-skills/ad-ops-agents.md)

**June 17, 2026**

ChatGPT Ads — new platform

## Run Ads Inside ChatGPT — New: ChatGPT Ads (OpenAI Ads)

Adspirer now supports **ChatGPT Ads (OpenAI Ads)** — pay-per-click "chat card" ads that render inside ChatGPT responses, with **31 tools** to launch, manage, and measure them conversationally from ChatGPT, Claude, or any connected AI client. (This also brings Adspirer's total tool surface to 340+.)

* **Connect once with an API key.** ChatGPT Ads is Adspirer's first non-OAuth platform: paste your OpenAI Advertiser API key in the Connections tab (one key = one ad account). It's stored encrypted, and the chat agent never sees it.
* **Launch in one shot, or manage granularly.** `launch_chatgpt_ad` builds the whole ad from a description (URL, headline, body, image, budget, geo), or use full campaign/ad-group/ad controls (list, get, create, update, pause, resume, archive).
* **Paused by default.** Nothing serves or spends until you resume the campaign, and the agent always speaks in dollars, not micros.
* **Honest review status.** Adspirer reports OpenAI's ad-review state (in review → approved/rejected) and flags policies up front — notably that third-party AI services are disallowed.
* **Conversions** via the OpenAI pixel and Conversions API, with a built-in test event to verify tracking.

→ [ChatGPT Ads integration guide](https://www.adspirer.com/docs/ad-platforms/chatgpt-ads.md)

**June 16, 2026**

Meta conversions reconcile with Ads Manager

## Meta Performance: Conversions That Reconcile With Ads Manager

The Meta performance dashboard now shows a **full conversion-action breakdown** and highlights the **purchase-class event** that matches the "Results" column in Meta Ads Manager. Meta's `total_conversions` sums every pixel action (add-to-cart, initiate-checkout, purchase, and more), which could make the dashboard headline look far higher than Ads Manager's purchase count. Now you can see exactly which figure reconciles — no more chasing a phantom discrepancy. CPA, ROAS, and deltas are unchanged.

**June 12, 2026**

Google ad-level performance & creative export

## Google Ads: Per-Ad Performance, Creative Export & Complete Asset Discovery

* **`get_ad_performance`** — a per-ad breakdown (one row per ad) with impressions, clicks, CTR, cost, conversions, conversion value, CPC, CPA, ROAS, video views, ad strength, and a live flag — plus a head-to-head comparison when an ad group has multiple ads. Covers Search, Display, Demand Gen, and YouTube.
* **`get_ad_creative`** — export the creative composition of existing ads: YouTube video IDs and thumbnails, downloadable image URLs with roles and dimensions, every headline/description/CTA, and carousel cards.
* **`discover_existing_assets`** is now **paginated** across all asset types, returning your complete asset inventory instead of silently capping — with downloadable image URLs and a clear path forward when a square logo is missing (previously a dead end for Performance Max).

The OpenClaw plugin (v2026.6.12) bundles these too.

**June 11, 2026**

Claude Cowork OAuth self-serve fix

## Claude Cowork: Self-Serve Fix for "No OAuth Flow Is in Progress"

If Claude's desktop/Cowork app shows *"No OAuth flow is in progress"* when connecting Adspirer, that's a known client-side bug in the Claude app — not an Adspirer problem. The fix takes about 30 seconds: in Claude, go to **Settings → Connectors → Add custom connector**, enter `https://mcp.adspirer.com/mcp`, and connect from there. → [Claude Cowork setup](https://www.adspirer.com/docs/ai-clients/claude-cowork.md)

**June 10, 2026**

Amazon Ads — new platform

## Amazon Ads Joins Adspirer — 61 Tools for Sponsored Products, Brands & Display

Amazon Ads is now a fully supported ad platform, with **61 tools** spanning **Sponsored Products, Sponsored Brands, and Sponsored Display**.

* Connect via **Login with Amazon**; Adspirer discovers your advertiser profiles across **North America, Europe, and the Far East** and imports each as an ad account.
* Full Sponsored Products lifecycle (campaigns → ad groups → product ads → keywords / targets / negatives), all 7 Sponsored Brands ad types (Brand Registry required), and Sponsored Display.
* Amazon-native analytics: **ACOS / ROAS**, per-ASIN performance, wasted-spend detection, budget optimization, and a purchased-products cross-sell view. Reporting runs asynchronously via `get_amazon_report`.

→ [Amazon Ads integration guide](https://www.adspirer.com/docs/ad-platforms/amazon-ads.md)

### Meta: EU DSA support + an extra Google extension tool

* Meta ad sets that target the **EU/EEA** now accept the required **DSA disclosure** fields (`dsa_beneficiary` / `dsa_payor`), so EU-targeted campaigns no longer dead-end. The fields are sent only when an ad set actually targets the EU/EEA.
* Google Ads adds **`remove_structured_snippets`** to clear stale snippet values before adding fresh ones.

The OpenClaw plugin (v2026.6.10) adds the Amazon Ads router.

**June 9, 2026**

In-chat dashboards overhaul

## In-Chat Dashboards: Tabs, Date Ranges, Working Buttons & Mobile

The interactive widgets in ChatGPT and Claude got a major upgrade:

* **Tabbed performance dashboard** — Overview / Campaigns / Insights, with KPI tiles, period-over-period deltas, charts, "needs attention" highlights, and **7 / 14 / 30 / 60 / 90-day plus custom date-range** switching that re-runs the query live.
* **Redesigned conversion-audit and connections widgets** — a graded scorecard with an action plan, and an account switcher with a quota meter.
* **Action buttons now work** — "pause this campaign" or "draft a message for my developer" post straight back into the chat.
* **Mobile rendering** — widgets now render in the Claude mobile app, with a clean text fallback on clients that don't support them.

**June 8, 2026**

Google agency-level Standard Access

## Approved at the Agency Level for the Google Ads API

Google reviewed and classified Adspirer as an **agency, full-service ad platform** for the Google Ads API and granted **Standard Access** — which lifts the daily operations cap. Bulk builds, large account restructures, and account-wide optimization now run at full speed, with no daily ceiling on Google Ads work.

**June 6, 2026**

Connection Health on Usage & Billing

## See Your Connection Health on Usage & Billing

The Usage & Billing page now shows a **Connection Health** card: whether your AI assistant is connected via MCP, and — per ad account — whether the OAuth link is healthy or needs reconnecting. A **Test now** button re-checks live, so you can confirm everything's wired up before you start a session.

**June 5, 2026**

TikTok targeting fix + redesigned setup guide

## TikTok Targeting Search Fixed + Redesigned Setup Guide

* **TikTok targeting search works again.** `search_tiktok_targeting` had been failing for every caller; it's fixed. Interest keywords are targeted by **numeric ID** (from that search), not by plain keyword strings — the tool docs now make this explicit.
* **Redesigned setup guide.** The per-client setup experience now has a screenshot carousel synced to the step list and a walkthrough video for Claude Cowork and ChatGPT, plus a standalone Setup Guide you can revisit any time from the web app.

**June 2, 2026**

Local targeting & support chat

## Meta Local Targeting Lands Correctly + Screenshots in Support Chat

### City + radius targeting now reaches Meta

Targeting a city with a radius — "everyone within 20 miles of Austin" — now reaches Meta as a real city-and-radius instead of being mis-sent as an invalid country code and silently dropped. Local campaigns on image, video, and carousel ads were effectively running nationwide (or failing) before this fix.

* **Multiple cities, each with its own radius**, now work in a single ad set.
* **Location reach modes** — choose who in a location you reach: people who **live** there, were **recently** there, or are **traveling to / interested in** it.
* **Safer location edits** — updating an ad set's locations now merges onto its existing targeting instead of replacing everything, so a location-only change no longer wipes the rest of your targeting.

### Attach screenshots to the support chat

The in-app support chat widget now accepts **PNG/JPEG screenshots** — click the paperclip, paste, or drag-and-drop. Support reads the image and runs its diagnostics on it, which is far faster for visual issues. Up to 5 images per message (5 MB each); screenshots are processed in-memory and never stored. Conversations also now **resume where you left off for up to 7 days** (previously 48 hours).

**June 1, 2026**

Onboarding & billing

## Onboarding & Billing Refresh

A polish pass across sign-up and plan management:

* **App Store connect tabs** on the onboarding connection screen, matching how you actually install Adspirer in ChatGPT and Claude.
* **Redesigned pricing step** — an animated tool-call hero, clearer active-account messaging, and a full-width tier ladder so the plan differences are easy to scan.
* **Congrats screen** confetti and copy polish once you finish setup.
* **"Manage Subscription"** now reliably opens the Stripe billing portal from the account menu.

**May 31, 2026**

Account switching

## Switch Your Active Ad Account From Chat

You can now change which ad account Adspirer acts on **by just asking** inside ChatGPT or Claude — including switching between child accounts under the same Google Ads manager (MCC) — without opening the web app.

```
Use my Sahaayak Google Ads account instead
```

* `list_connected_accounts` now surfaces connected-but-not-yet-activated accounts (including live MCC child accounts), so the agent can resolve a business name to the right account and switch to it.
* Switching respects your plan's [active-account cap](https://www.adspirer.com/docs/knowledge-base/multi-account.md): on single-account tiers the new account **replaces** the active one; on multi-account tiers (annual plans and Max) it's **added** to the active set.
* Account switching is a session operation — it never costs a tool call.

Previously this switch silently failed over MCP. It now works end-to-end from any connected AI client.

**May 30, 2026**

Diagnostic & Helper tools

## Diagnostic & Helper Tools — and Interactive Widgets in ChatGPT & Claude

A new group of **13 read-only "get unstuck" tools** is now live across every AI client, on Free and up. They're **quota-free** — calling them never counts against your monthly tool calls.

### Get started, pre-flight, diagnose, and see your value

| When | Tools | What they do |
| - | - | - |
| **Getting started** | `start_here`, `suggest_next_action`, `list_what_i_can_do` | Personalized "what should I do next" based on your real connected accounts and data |
| **Before launching** | `get_campaign_spec`, `preflight_campaign`, `validate_campaign_draft` | Check an account is launch-ready and dry-run a campaign against the platform's rules before anything is created |
| **When something fails** | `explain_platform_error`, `why_did_this_fail`, `diagnose_my_setup`, `verify_campaign_is_live` | Turn a cryptic platform error into a plain-language fix, run a full connection health check, and confirm a campaign is actually serving — a **real live check against all four platforms** |
| **See your value** | `whats_changed_since_last_visit`, `weekly_opportunities`, `usage_value_summary` | What moved since you were last here, 1–3 concrete optimization opportunities, and what your plan delivered |

`diagnose_my_setup` is especially useful when you're not sure whether a problem is your AI-client connection or your ad-platform sign-in — it tells them apart. → [Full Diagnostic & Helper reference](https://www.adspirer.com/docs/agent-skills/diagnostic-helper-tools.md)

### Answers render as interactive cards

In **ChatGPT and Claude**, these tools now render as branded, interactive cards — setup checklists, usage meters, opportunity lists, an account switcher — instead of a wall of text. The cards adapt to light/dark themes and fall back gracefully to plain text on any client that doesn't render widgets.

### OpenClaw plugin v2026.5.30

The OpenClaw plugin now bundles the diagnostic & helper tools too (tool count 139 → 140). Reinstall with `openclaw plugins install openclaw-adspirer` to pick them up.

**May 30, 2026**

Google Ads reliability

## Google Ads: Clearer Bidding Errors, Reliable Keyword Metrics, Full Ad Extensions

### Bid-strategy changes explain themselves

Changing a campaign's bid strategy when it's attached to a **shared (portfolio) bid strategy** used to fail with Google's opaque "operation not allowed for the given context." Adspirer now detects the portfolio strategy up front and tells you exactly what to do — detach it from the campaign, or edit the shared strategy itself. Smart Bidding errors (Target CPA / Target ROAS) now include the conversion-tracking prerequisites you're missing.

### Keyword research metrics reach your AI reliably

`research_keywords` now surfaces **per-keyword search volume, competition, average CPC, and top-of-page bid range** in the structured data your assistant reads — so it stops claiming "per-keyword data isn't available" when Google Keyword Planner returned it all.

### Ad copy edits stop failing on duplicates

Editing a Responsive Search or Display ad no longer fails with "Assets are duplicated across operations" — Adspirer automatically de-duplicates identical headlines/descriptions before submitting, and if that leaves you short of Google's minimum, it tells you exactly how many more unique lines to add.

### Full ad-extension control

Sitelinks, callouts, and structured snippets now have complete add / remove / list coverage, including the new `remove_structured_snippets` tool for clearing out stale snippet values. Sitelinks also accept natural field names (`text`/`headline`, `url`/`link`) and are now suggested whenever you ask about "extensions" or "making my ads better" — you don't have to know the word "sitelinks."

**May 29, 2026**

Meta conversions & creatives

## Meta Ads: Conversion Reporting You Can Trust, Plus Creative & Agency Fixes

### Conversions Meta actually reports now count

If your campaigns showed real conversions in Meta Ads Manager but **zero in Adspirer**, this fixes it. Adspirer now counts:

* **Pixel custom-event conversions** (e.g. a Calendly booking) — the most common "0 conversions" cause
* **Lead-form submissions** and **Messenger conversations**
* **Offline conversions**, with a **per-event-name breakdown** ("5 *invitee\_select\_time* events", not "5 custom conversions")

Lead-gen and sales campaigns are now correctly treated as conversion campaigns in wasted-spend, anomaly, and budget analysis — no more "Meta is optimizing blind" when it isn't.

> [!NOTE]
>
> This applies to newly collected performance. Historical numbers for affected accounts backfill separately as data is re-collected.

### Creating ads with fewer dead ends

* **Carousel ads** accept your existing assets (the same `existing_image_hash` Adspirer's discovery returns) and validate each card up front — needs an image, headline, and landing URL — with a clear message instead of an opaque Meta rejection.
* **Dynamic creative (DCO)** ads now accept multiple headlines and body texts directly, and Adspirer auto-enables dynamic creative on the target ad set for video as well as image.
* **Conversion ad sets** now warn you about a **missing pixel** before Meta rejects the campaign with "promoted object fields missing."

### Agency-grade cross-account safety

If you manage multiple ad accounts and ask the agent to add an ad to an ad set that belongs to a *different* account, Adspirer now catches the mismatch, names both accounts, and points to the right tool — instead of a misleading "missing image" loop. Deselected (inactive) accounts can no longer be written to until you re-activate them.

**May 29, 2026**

ChatGPT App Store

## Adspirer Is Now in the ChatGPT App Store

Adspirer is now an **official ChatGPT app** — no more Developer mode, custom connectors, or pasted server URLs. Open **Apps** in ChatGPT, search **"Adspirer,"** click **Connect**, and sign in. Setup takes under a minute, and you invoke it in any chat by mentioning **@adspirer**.

* **One-click install** — find Adspirer in the ChatGPT App Store and connect with OAuth; ChatGPT manages the connection for you.
* **No elevated-risk warning** — the old Developer-mode + "I understand and want to continue" flow is gone for ChatGPT users.
* **Same account, same tools** — all 190+ tools across Google Ads, Meta Ads, LinkedIn Ads, and TikTok work exactly as before. If you previously added Adspirer as a custom connector, remove it and reconnect through the App Store; your account and ad platform connections carry over.

[ChatGPT App Store setup guide →](https://www.adspirer.com/docs/ai-clients/chatgpt.md)

**May 26, 2026**

v2.23.1

## Platform Hardening & Resilience Fixes

* **MCP base image hardening** — all six MCP sub-servers (hub + Google + Meta + TikTok + LinkedIn + Monitoring) pinned to `python:3.11-slim-trixie` with audit-pass cryptography and authlib dependencies.
* **Container scanning by digest** — vulnerability scans resolve images to their content digest instead of the floating `:latest` tag, so the report can't drift between scan time and image promotion.
* **Tool routing resilience** — tighter input handling on Google Ads tool routing and a longer hub timeout for slow Meta calls.
* **Watch Agent stability** — finding classifier no longer cascades a stuck SQL transaction into a noisy false-positive.

**May 25, 2026**

v2.23.0

## Multi-Google-OAuth, Meta Account Improvements & Per-Platform Cap Messaging

### Connect Multiple Google Logins to One Adspirer Account

A single Adspirer account can now hold **multiple Google OAuth grants**, each with its own non-overlapping set of Google Ads customer IDs. Agencies and consultants who manage Google Ads across separate Google identities no longer need a second Adspirer account.

* Adds a second (or third) Google login from the **Connections → Google Ads → Add another Google login** flow.
* Each grant tracks its own customer IDs; the agent routes tool calls to the right OAuth based on the customer you reference.
* Available on **Max annual** today; rolling to the rest of the paid tiers behind a feature flag.

### Meta Ads — Account Discovery & Asset Handling Overhaul

A set of improvements to how Adspirer works with Meta Business Manager and ad-account-scoped assets.

* **Business Manager-wide import** — when you connect Meta, Adspirer discovers **every ad account inside the Business Manager** you grant access to, not just the one you happened to click during OAuth. The Manage Accounts modal lists them all so you can pick which ones to activate.
* **Per-account asset scoping** — image, video, and creative discovery is now scoped to the specific ad account you're targeting. Eliminates the "this asset was discovered but Meta says it's not in this ad account" error class.
* **Opt-in auto-copy of creatives** — when you reuse a creative from a sibling ad account, Adspirer offers to copy it into the target account before launching the campaign (opt-in per call) so the launch doesn't stall on asset placement.
* **Clearer "no account" error** — when a tool call can't find a Meta account, the response distinguishes a stale token from a missing-row state so you (or your AI client) know whether to reconnect or just re-select.

### Per-Platform Active-Account Messaging

The active-account cap is **per platform** — every plan card across pricing and the Manage Accounts modal now states up front how many active accounts you get per platform (Google + Meta + LinkedIn + TikTok each counted independently). When you're at the cap, the modal shows an inline upsell that links directly into the Adspirer plan picker.

### Smaller Improvements

* **Sidebar rename** — "Account Setup" is now **Home**. Same page, more accurate label for users past initial setup.
* **Brief coverage** — scheduled performance briefs are scoped to your selected accounts (not just the primary), with full multi-OAuth coverage so a second Google identity's accounts no longer show up empty.
* **Live-tail merge** for Google Ads in the brief data fetchers so spend that hit the API after the nightly sweep still lands in your brief.

**May 24, 2026**

v2.22.0

## Plan Limits, Cap Rework & Connections Panel Refresh

### Active-Account Caps — New Per-Tier Limits

The big change: **annual plans now activate up to 5 accounts per platform**, not 1. Monthly plans (except Max) still cap at 1 per platform. Full table:

| Plan | Monthly | Annual |
| - | -: | -: |
| Free | 1 | 1 |
| Plus | 1 | **5** |
| Pro | 1 | **5** |
| Max | **5** | 5 |

* "Account" means an ad account on a single platform — Plus annual customers can activate up to 5 Google Ads accounts **and** 5 Meta accounts **and** 5 LinkedIn accounts **and** 5 TikTok accounts.
* Every Stripe webhook now reconciles down-tier moves automatically: if you downgrade from Max monthly to Plus monthly, excess actives demote to inactive (deterministically — primary-set-first, then most-recently-synced).
* Caps live in a new `subscription_plan_limits` table so we can adjust without redeploys, and every change is written to a `tier_limit_changes` audit log.
* **Defense in depth:** the MCP hub also truncates account lists at the tier cap before returning them, so any reconciliation gap can't accidentally let a downgraded user keep agent access to more accounts than their plan allows.

### Onboarding & Connections — Smoothed Out

* **Onboarding Step 5 stays put** — fixed an issue where the Congrats screen would bounce users back to Step 1 if their AppUser stub hadn't finished writing after Stripe checkout. You always land on Step 5 post-payment now.
* **Connections panel — unified stacked rows** — Available Platforms restyled to compact rows that match the Pipedream integration cards below. The Google Analytics + Klaviyo cards no longer hide below the fold.
* **OAuth modal always opens** — after a successful OAuth, the account-selection modal opens regardless of how many accounts are under your OAuth identity. No more silent auto-pick when you have multiple accounts and didn't realize.
* **Tier-aware Manage Accounts modal** with an inline Edit button and a Connections-panel mirror so the active-account picker shows the same state in both surfaces.
* **Admin: Plan Limits page** with a dry-run preview that counts affected users before you commit a cap change.

### Bug Fixes

* "Add another Google login (coming soon)" placeholder is replaced with a Max-annual upsell that explains how to unlock it today.
* `get_ad_accounts` now filters out deselected (inactive) accounts so they stop rendering as green Active in the Connected Platforms UI.

**May 22, 2026**

v2.21.0

## Google Analytics & Klaviyo Integrations

Adspirer's first non-ad-platform integrations are live. Plus, Pro, and Max users can now connect **Google Analytics 4** and **Klaviyo** alongside their ad accounts, and the agent can read and act on those properties through chat.

### What You Can Do

| Integration | Tool | What it does |
| - | - | - |
| Google Analytics (GA4) | `google_analytics` | Read property data — sessions, conversions, traffic sources, landing-page performance — so the agent can correlate paid ad spend with site behavior. |
| Klaviyo | `klaviyo` | Read campaigns, flows, segments, profiles, and metrics so the agent can pull email/SMS performance alongside paid media. |

Each is a **router tool** — `action="list_tools"` first to discover what's available, then `action="execute"` with the specific Pipedream tool name to call it. The agent handles this two-step automatically.

### How It Works

* Connect from the **Connections** tab at [adspirer.ai](https://adspirer.ai/connections) — each integration has its own OAuth popup powered by Pipedream Connect.
* Gated to **Plus and above**. Free users see the integration card with a "Upgrade" prompt that links into the Adspirer plan picker.
* Disconnect anytime from the same panel; idle connections (>90 days) get pruned automatically to keep the integration list tidy.

### Self-Serve Account Deletion in the Chat Widget

Free-tier users can now ask the in-app chat widget to delete their account end-to-end — no email round-trip required. The widget confirms before executing and runs the full GDPR delete (hard-delete + pseudonymize + retain per Article 17(3)(b)).

### OpenClaw Plugin v2026.5.12

Bumped to expose the new integration tools plus 9 additional Google Ads tools (PMax search themes, audience signals, ad group management) and 3 monitoring tools.

**May 21, 2026**

v2.20.1

## Watch Agent Polish & Support Widget UX

### Watch Agent Briefs

* **Conversion-tracking caveat** — briefs now include a "conversion data is reported through your platforms" caveat so anomalies in conversion volume aren't read as Adspirer numbers.
* **Paused vs active classification** — briefs no longer call a paused campaign "underperforming" — paused campaigns are explicitly flagged as paused.
* **Account names cleaned** — fixed a template placeholder that was occasionally showing up in account labels.
* **Dead dashboard link replaced** — the in-brief "open dashboard" link is now a copy-paste AI prompt you can run in your AI client to drill into the finding.
* **Recommendations de-alarmed** — toned down "URGENT" language on routine recommendations so high-severity callouts read as actually high severity.

### Monitors & Alerts

* **`create_monitor` returns 409** when you try to create a duplicate alert instead of silently writing two.
* **Digest email values corrected** — the daily digest now reports the same value the alert evaluated against, not a stale snapshot.

### Support Chat Widget

* **Address by name** — the in-app support widget greets you by name from turn 1.
* **Panel state persists** — the widget stays open across page navigations and refreshes, with a time-aware "welcome back" greeting when you return.

**May 20, 2026**

v2.20.0

## Watch Agent, Monitors & Alerts Web UI, and 8 New MCP Tools

### Watch Agent — Proactive Signal

The **Watch Agent** is a server-side AI agent that scans your connected ad accounts every 15 minutes, identifies issues, and emails you a copy-paste re-entry prompt so you can act immediately inside your AI client. No more waiting for weekly reviews to catch a broken campaign.

**What the Watch Agent does:**

* Analyzes ROAS, CPA, CTR, spend, and conversion rate across all connected platforms
* Distinguishes true anomalies from normal variance (noise suppression built in)
* Stages pre-validated fix actions (pause campaign, adjust bid, add negatives) alongside each finding
* Sends a finding email with a ready-to-paste prompt when severity ≥ medium is detected

**MCP tools for the Watch Agent:**

| Tool | Type | Description |
| - | - | - |
| `run_watch_now` | Read | Trigger an on-demand Watch Agent scan immediately — don't wait for the next scheduled run |
| `get_signal_briefing` | Read | Pull the advisory briefing and pre-staged fixes for a specific Watch Agent finding |
| `apply_signal_actions` | Write | Apply the pre-staged fixes from a finding — approve with one call |
| `list_pending_actions` | Read | See all actions staged by the Watch Agent waiting for your approval |
| `manage_action` | Write | Approve or reject an individual staged action |

**Example:**

```
"Run the watch agent on my accounts now"
→ run_watch_now

"Show me the briefing for signal abc123"
→ get_signal_briefing(signal_id="abc123")

"Apply the staged fixes"
→ apply_signal_actions(signal_id="abc123")
```

The Watch Agent runs automatically for all connected accounts — no setup required.

### Monitors & Alerts — Web UI

A new **Monitors** page at [adspirer.ai/monitors](https://adspirer.ai/monitors) lets you create and manage performance alerts without opening your AI client. Every alert you create on the web goes to the same backend as the MCP `create_monitor` tool — the Watch Agent reads from one unified table regardless of which surface created the alert.

**What you can do on the Monitors page:**

* Create alerts for CPA, ROAS, CTR, CPC, spend, conversions, impressions, clicks, cost per lead, conversion rate, or budget utilization
* Set thresholds with "goes above" or "drops below" operators
* Optional: trigger only after N consecutive days (1–14) — filter out one-off noise
* Scope to specific platforms (Google Ads, Meta, LinkedIn, TikTok) or all connected
* Edit, pause, resume, test (dry-run), and delete alerts in the dashboard

**Supported alert metrics:**

| Metric | Example threshold |
| - | - |
| CPA | Alert when CPA goes above \$50 |
| ROAS | Alert when ROAS drops below 2x |
| CTR | Alert when CTR drops below 1% |
| Spend | Alert when daily spend goes above \$500 |
| Budget utilization | Alert when pacing exceeds 110% |
| Conversions | Alert when conversions drop below 1 |
| Clicks, Impressions | Volume monitoring |

### 3 More New Monitoring Tools

| Tool | Type | Description |
| - | - | - |
| `get_monitor_history` | Read | See all past trigger events for a specific alert — when it fired, what values triggered it |
| `test_monitor` | Read | Dry-run a monitor against today's data — see whether it would fire without waiting |
| `manage_scheduled_task` | Write | Unified pause, resume, or delete for any brief, monitor, or scheduled task |

### PDF Reports for Scheduled Briefs

Scheduled performance briefs now **attach a PDF** to the email. The PDF contains the same tables and charts as the email body — useful for sharing with stakeholders who don't have Adspirer access.

**Monitoring tool count: 8 → 16**

**May 16, 2026**

v2.19.0

## Annual Plans & Max Quota

### Annual Quota Pooling

Annual subscribers now get a **single pooled allowance for the full year** instead of per-month caps. No monthly resets — use your calls whenever you need them.

| Plan | Annual Price | Annual Pool | Monthly Equivalent |
| - | - | - | - |
| Plus | \$485/year | 1,800 calls | \~150/month |
| Pro | \$999/year | 7,200 calls | \~600/month |
| Max | \$2,000/year | 50,000 calls | \~4,167/month |

* Pool renews on your subscription anniversary date. Unused calls do **not** roll over.
* Annual subscribers are **never charged overage** — the yearly pool is your total budget for the year.
* Max annual (50,000) is intentionally higher than 12× monthly (36,000) as the upgrade incentive for high-volume months.

### Max Plan: 3,000 calls/month

The Max plan monthly limit is now formalized at **3,000 calls/month** (previously displayed as "unlimited"). This aligns with the Stripe product metadata and all enforcement layers. Max annual subscribers retain the 50,000/year pool with no monthly cap.

See the updated [Pricing & Tool Calls](https://www.adspirer.com/docs/knowledge-base/pricing.md) page.

**May 15, 2026**

v2.18.2

## GDPR Article 17 — Right to Erasure

Account deletion requests (submitted via **[support@adspirer.com](mailto:support@adspirer.com)**) now correctly pseudonymize all associated audit log rows, satisfying GDPR Article 17 right-to-erasure requirements. A bug in the deletion pipeline previously left historical audit rows intact. A one-time backfill also pseudonymized rows from prior deletion requests that had been processed without full erasure.

> [!NOTE]
>
> Account deletion is handled by the Adspirer support team. To request account deletion, email **[support@adspirer.com](mailto:support@adspirer.com)**.

**May 14, 2026**

v2.18.1

## TikTok: 3 Customer-Blocking Fixes

Three bugs from live tool call logs that were causing TikTok campaign creation failures.

### Local Currency for Budget Floors

TikTok campaign budget pre-flight checks were using USD as the hardcoded currency regardless of the advertiser's local currency. This caused incorrect minimum budget enforcement for non-USD accounts. The fix fetches the correct currency and timezone from TikTok's API at OAuth connect time, and backfills existing accounts. A one-time database backfill corrected 167 of 170 affected accounts (3 had expired tokens).

### Disclaimer Text Format

Ad disclaimer text must be passed as a structured object (`{"text": "..."}`) rather than a plain string per TikTok's API requirements. Campaigns with a `disclaimer_text` were silently failing at TikTok's server even though the tool accepted the input. The fix wraps string input into the correct object format automatically. Disclaimer text is also now enforced at a max of 90 characters (TikTok's hard limit).

### CTA Autocorrect & Full Whitelist

The `call_to_action` field on TikTok ads previously accepted stale values that TikTok's API would reject at campaign creation time. The field is now backed by:

* **30-value authoritative whitelist** extracted from TikTok's rejection response
* **14-alias autocorrect map** for commonly used old values:

| Old (accepted, now autocorrected) | New (correct) |
| - | - |
| `DOWNLOAD` | `DOWNLOAD_NOW` |
| `BUY_NOW` | `SHOP_NOW` |
| `INSTALL` | `INSTALL_NOW` |
| `WATCH` | `WATCH_NOW` |
| `GET_OFFER` | `GET_QUOTE` |
| `BOOK` | `BOOK_NOW` |

Autocorrect applies to all 4 CTA schema fields (campaign creation, video ads, `add_tiktok_ad`, carousel). Invalid values that don't map to an alias return a clear error with the full allowed list.

**May 12, 2026**

v2.18.0

## Google Ads: Campaign Control Expansion

18 new capabilities across campaign management, search campaign creation, and asset tools, resolving the top customer-reported gaps from production.

### Ad Group Pause / Resume

Two new tools give you ad group-level control without touching the parent campaign:

* **`pause_ad_group`** — Pause an individual ad group while leaving the campaign running
* **`resume_ad_group`** — Resume a paused ad group

### `update_campaign` — Expanded Controls

`update_campaign` now accepts 6 new parameters:

| Parameter | What it does |
| - | - |
| `search_partners` | Enable or disable the Google Search Partners network |
| `display_expansion` | Enable or disable Display Expansion for Search campaigns |
| `language_codes` | **Replace** the campaign's language targeting (ISO-639-1 codes like `"en"`, `"es"`, `"fr"` or `languageConstants/<id>` resource names from `list_google_languages`) |
| `locations_to_add` | Append geo targets (free-text or `geoTargetConstants/<id>` resource names) |
| `locations_to_remove` | Remove geo targets by criterion resource name |
| `audience_targeting_mode` | Set `OBSERVATION` (bid adjustments only) or `TARGETING` (targeting restriction) |
| `ai_max_enabled` | Enable or disable AI Max for eligible Search campaigns |

### `create_search_campaign` — Per-Keyword Match Types

Initial keywords in `create_search_campaign` now accept a mixed format:

* Plain strings default to BROAD (backward compatible)
* Objects like `{"text": "running shoes", "match_type": "PHRASE"}` set EXACT or PHRASE on individual keywords

Previously, all initial keywords were forced to BROAD match — requiring a separate `add_keywords` call to set correct match types.

### New Asset Tools

Three new tools for attaching assets to Search campaigns:

* **`add_business_name_asset`** — Attach a business name text asset (max 25 characters) at the campaign level
* **`add_call_asset`** — Attach a phone number call asset with country code. Accepts an optional `call_conversion_action` resource name to enable call conversion tracking.
* **`add_search_campaign_image`** — Attach image assets to Search campaigns (logo, landscape, square, portrait). Accepts HTTP URLs or base64-encoded data URIs.

### `get_campaign_structure` — Expanded Fields

`get_campaign_structure` now surfaces `network_settings` (Search Partners, Display Expansion), EU political content eligibility, and geo target type for each campaign. `get_campaign_targeting` responses now include `resource_name` on each criterion row so you can pass exact IDs to `locations_to_remove`.

### Callout Extension Policy

CTA words in callout extensions (e.g., "Learn More", "Sign Up") were previously silently dropped. They now generate a **warning** in the tool response instead of being removed — giving you visibility into which callouts were affected without blocking campaign creation.

**Google Ads tool count: 89 → 92**

**May 9, 2026**

v2.17.3

## TikTok Deep Overhaul, Google Ads Conversion Tools, and Meta Adset Performance

### TikTok Ads — Full SDK Overhaul + Layer 2

The TikTok integration received its largest overhaul since launch — every customer-blocking bug from production logs was closed and the platform's full API depth is now accessible.

**Phase 0 — bug fixes (all customer-blocking):** Ad group spec re-architected to 86 fields; creative spec to 59 fields. Image direct-path skips base64 conversion. Slideshow (unsupported by TikTok) removed from code paths. ffmpeg added to Cloud Run for video frame extraction. 5 prod-harness-discovered bugs (pause schema, ValueError hints, image path, envelope, deletes) fixed.

**Phase 1 — full SDK depth:** All 86 ad-group fields and 59 creative fields from TikTok's marketing API are now surfaced through `add_tiktok_ad_group` and `add_tiktok_ad`. Previously only a subset was accessible.

**Layer-1 — validity matrix:** 6 common error classes are now caught *before* the API call — saving tool call quota and eliminating confusing API rejection messages.

**Layer-2 — new tool and rich targeting:**

| Tool | Type | Description |
| - | - | - |
| `explain_tiktok_objective` | Read | Given your goal (leads, sales, traffic, app installs), returns the correct TikTok campaign objective, recommended ad format, and validity constraints — eliminating trial-and-error |

**Rich targeting** for `add_tiktok_ad_group` now supports interest filters, behavioral keywords, action categories, carrier/device targeting, and language filters — all available through `search_tiktok_targeting`.

**Atomic rollback:** If campaign creation fails at any sub-step (ad group or ad level), previously-created resources are automatically rolled back. No more partial campaigns left in your account.

### Google Ads — Conversion Tracking Tools

Two new tools for conversion analysis — separate from the existing `audit_conversion_tracking` health check:

| Tool | Type | Description |
| - | - | - |
| `list_conversion_actions` | Read | List all conversion actions in your Google Ads account (purchases, form fills, phone calls, etc.) with status and tracking method |
| `get_conversion_action_performance` | Read | Pull conversion metrics (volume, value, CPA) broken down by conversion action — see which actions are actually driving results |

`get_campaign_targeting` is also expanded: it now returns all criterion types (location, language, audience, device, ad schedule, topic, content label) instead of just locations and languages.

### Google Ads — Ad-Group Extensions

`add_sitelinks`, `add_callout_extensions`, and `add_structured_snippets` now accept an optional `ad_group_id` parameter. Extensions attached at the ad-group level override campaign-level extensions for that specific ad group — useful for ad groups targeting different products or audiences.

### Meta Ads — Ad Set Performance

A new middle-layer analytics tool between campaign and ad level:

| Tool | Type | Description |
| - | - | - |
| `get_meta_adset_performance` | Read | Pull spend, clicks, CTR, CPA, ROAS, and conversions broken down by ad set within a campaign — see which audience segments and placements are driving results before going to individual ad level |

Previously, Meta performance tools showed either campaign-level (too broad) or ad-level (too granular) data. Ad set performance fills the gap for budget allocation decisions.

### Billing — Plan Management UI

The **Billing** page now supports plan changes without contacting support:

* **Downgrades** — Switch from Pro → Plus or Plus → Free directly from the billing page
* **Interval switching** — Toggle between monthly and annual billing mid-cycle
* **Max plan visibility** — Max plan capabilities and tool call limits are now shown inline on the billing page

All plan changes go through Stripe Checkout (same flow as upgrades) for consistent billing history.

**April 30, 2026**

v2.17.2

## Reconnect now resumes metric collection

Fixed an issue where reconnecting an ad account after an authentication error wouldn't actually resume background metric collection. Previously, if Adspirer auto-paused an account because the platform returned a 401/403 (expired token, revoked permissions), reconnecting through the connections page issued a fresh OAuth token but left `metrics_collection_enabled` set to false — so daily collection kept skipping the account. Customers were effectively reconnecting for nothing.

Reconnect flows for **Meta Ads, Google Ads, TikTok Ads, and LinkedIn Ads** now automatically clear auth-error pauses on the same user and platform once the new token is saved, restoring daily metric collection without manual intervention. Admin pauses, free-tier pauses, and other auto-pause types are untouched.

**April 29, 2026**

v2.17.1

## Sequential sub-agents for Max plan

Max plan users can now run sequential sub-agents across multiple active ad accounts in a single conversation. Instead of switching primary accounts one at a time, mark multiple accounts as active and let Adspirer fan out tool calls across each — perfect for agencies running cross-account audits, weekly briefs, or bulk optimizations from a single prompt.

### What's new

* **Active accounts model** — Max users can have multiple ad accounts marked active per platform simultaneously. Lower tiers continue with the primary-account model.
* **`list_connected_accounts`** — New system tool that returns every active account across platforms with IDs, names, and status. Reads directly from the database (zero API calls, doesn't count against your quota).
* **Cross-account workflows** — A single prompt like "run last week's performance brief across all my Google Ads accounts" now triggers per-account sub-agents that aggregate into one consolidated response.
* **Active set management** — Add or remove accounts from your active set at [adspirer.ai/connections](https://adspirer.ai/connections).

### Who this is for

Agencies, portfolio managers, and anyone managing 3+ ad accounts who currently bounces between primaries. See the updated [Multi-Account Management guide](https://www.adspirer.com/docs/knowledge-base/multi-account.md#sequential-sub-agents-max-plan).

**April 23, 2026**

v2.17.0

## Google Display Ads — end-to-end CRUD

Full Google Display Network support joins Search, PMax, YouTube, and Demand Gen. Ships with 27 new MCP tools verified live against Google Ads API v21. Standard Display (full manual control) and Smart Display (Google-managed) are both supported. [Display Ads guide →](https://www.adspirer.com/docs/ad-platforms/google-display-ads.md)

### What's new

* **`create_display_campaign`** — Standard Display (channel=DISPLAY) and Smart Display (sub\_type=DISPLAY\_SMART\_CAMPAIGN) with a single flag. Creates campaign + default ad group + Responsive Display Ad, all PAUSED.
* **5 targeting surfaces — GET / ADD / REMOVE on each:**
  * `add_display_audiences` — In-market, affinity, custom audiences, user lists, combined audiences
  * `add_display_topics` — Google content categories
  * `add_display_placements` — Specific websites, apps, YouTube channels, YouTube videos
  * `add_display_keywords` — Contextual (always BROAD match on Display)
  * `update_display_demographics` — Age, gender, parental status, income exclusions
  * `remove_display_criteria` — Unified removal across all 5 surfaces
* **Full CRUD:** `add_display_ad_group`, `add_display_ad`, `update_display_ad_creative` (colors, CTA, images, videos, promo, format\_setting), `update_display_ad_group`, `update_display_campaign_schedule`, `update_display_frequency_caps`, plus remove variants
* **Geo + language resolvers** — `resolve_google_locations` and `list_google_languages` reject ambiguous inputs ("Baja" surfaces 5 candidates) instead of silently falling back to US. All Google campaign types benefit.
* **RSA + RDA dispatch** — `update_ad_headlines`, `update_ad_descriptions`, and `update_ad_content` now dispatch on ad type. Responsive Search Ads (3–15 headlines, 2–4 descriptions) and Responsive Display Ads (1–5 headlines, 1–5 descriptions, plus `long_headline`) work side-by-side.
* **`select_google_campaign_type`** — Now includes `'display'` and `'demandgen'` alongside `'search'`, `'pmax'`, and `'youtube'` with full decision-tree workflows.

### OpenClaw plugin update

OpenClaw bumps to **v2026.4.13**. Tool count goes from 95 → 119 — adds all 22 Display Ads tools + 2 helpers. [OpenClaw agent guide →](https://www.adspirer.com/docs/agent-skills/openclaw-agent.md)

### Regressions

None. RSA users see identical behavior plus clearer validator errors. PMax, Demand Gen, and YouTube still hit the same unchanged paths.

**April 22, 2026**

v2.16.0

## REST API Reference now live

Every Adspirer tool is now callable over plain HTTP and documented at [adspirer.com/docs/api-reference](https://www.adspirer.com/docs/api-reference/introduction.md). Same 178 endpoints as the MCP server — same auth, same quota, same write-guards — but over request/response JSON so consumers that can't speak SSE (n8n, Zapier, Make, cron jobs, GitHub Actions, your own backend) can use them.

### What's included

* **178 auto-generated endpoint pages** grouped by platform: Google Ads (51), Meta Ads (36), LinkedIn Ads (45), TikTok Ads (29), monitoring (13), general (3), audit (1)
* **Interactive "Try it" playground** — authorize once with your `sk_live_...` key, call any endpoint from the browser against the real API
* **REST API overview** with use-case patterns for Slack ChatOps, daily account briefings, portfolio rollups, alert / auto-pause, SaaS product embedding, and headless CI
* **Architecture sequence diagrams** for each pattern showing how ingress → Adspirer → egress wires up

### Base URLs

| | |
| :- | :- |
| Endpoints | `https://api.adspirer.ai/api/v1/tools/<tool_name>/execute` |
| Swagger UI | [api.adspirer.ai/docs](https://api.adspirer.ai/docs) |
| OpenAPI spec | [api.adspirer.ai/openapi.json](https://api.adspirer.ai/openapi.json) |

### Auth

Pass your API key as `Authorization: Bearer sk_live_...` — same keys you already use for headless MCP. Generate one at [adspirer.ai/keys](https://adspirer.ai/keys). Free tier includes 15 calls / month.

### Idempotency

Write operations accept an `Idempotency-Key` header. Strongly recommended for n8n, Zapier, and any retry-prone client — a repeated call with the same key returns the cached result instead of creating duplicates.

**April 20, 2026**

v2.15.5

## Pay-as-you-go overage for Plus subscribers

Plus plan subscribers no longer hit a hard stop at 150 tool calls. After your included calls are used, you can keep working at **$0.50 per additional call**, capped at **$50/month** in overage charges.

### How it works

* Overage billing is **auto-enabled** for all Plus subscribers
* Your first 150 calls are included in your \$49/month subscription
* After 150 calls, each additional call is billed at \$0.50 through Stripe
* Monthly overage is capped at $50 — your maximum bill is $99/month
* Disable overage anytime from your billing page to revert to the previous behavior (hard stop at 150 calls)

### Usage notifications

* At **135 calls** (90%): one-time notification that overage billing kicks in after 150
* At **151 calls**: one-time notification that you're now on usage-based billing
* All other overage calls: no interruptions — just keep working

### Tier-specific messaging

* **Plus:** Minimal notifications during overage — you're paying for usage, so no nagging
* **Pro:** Usage stats shown without upgrade prompts
* **Max:** No usage hints — high included limit, don't worry about it

See the updated [Pricing & Tool Calls](https://www.adspirer.com/docs/knowledge-base/pricing.md#overage-billing-plus-plan) page.

**April 16, 2026**

v2.15.4

## Raw data mode for all performance tools

All 29 performance and analytics tools across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads now accept a `raw_data` parameter. When set to `true`, tools return a compact JSON code block with only raw metrics (spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, ROAS) — stripped of severity labels, suggested bids/budgets, industry benchmarks, and optimization recommendations.

**Default behavior is unchanged.** Existing markdown output with recommendations is returned unless you explicitly pass `raw_data=true`.

### When to use raw data mode

* You run your own attribution model and want raw numbers only
* You want to minimize token usage in AI client responses
* You're piping metrics into a spreadsheet, dashboard, or external tool

### Supported tools

| Platform | Tools with `raw_data` support |
| - | - |
| Google Ads | `get_campaign_performance`, `analyze_wasted_spend`, `optimize_budget_allocation`, `analyze_search_terms`, `explain_performance_anomaly` |
| Meta Ads | `analyze_meta_campaign_performance`, `analyze_meta_ad_performance`, `analyze_meta_wasted_spend`, `optimize_meta_budget`, `analyze_meta_audiences`, `detect_meta_creative_fatigue`, `optimize_meta_placements`, `explain_meta_anomaly`, `get_meta_audience_insights` |
| LinkedIn | `get_linkedin_campaign_performance`, `analyze_linkedin_engagement`, `get_linkedin_audience_insights`, `analyze_linkedin_wasted_spend`, `optimize_linkedin_budget`, `explain_linkedin_anomaly`, `analyze_linkedin_creative_performance` |
| TikTok | `get_tiktok_campaign_performance`, `get_tiktok_ad_performance`, `analyze_tiktok_wasted_spend`, `optimize_tiktok_budget`, `detect_tiktok_creative_fatigue`, `explain_tiktok_anomaly`, `get_tiktok_audience_insights`, `analyze_tiktok_geo_performance` |

### Example

```
"Show me last 30 days campaign performance with raw data"
```

The tool returns a fenced JSON block like:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "campaigns": [
    {
      "name": "Brand Search - US",
      "spend": 1250.00,
      "clicks": 3400,
      "impressions": 45000,
      "conversions": 85,
      "cpa": 14.71,
      "cpc": 0.37,
      "ctr": 0.0756,
      "roas": 4.2
    }
  ]
}
```

### Free tier access fix

Free-tier users who previously had a failed or paused Stripe subscription attempt were incorrectly blocked from using MCP tools. This is now fixed — free-tier users are gated only by their usage quota, as intended.

**April 16, 2026**

v2.15.3

## TikTok Ads: correct optimization event values

The `optimization_event` parameter on `create_tiktok_campaign`, `add_tiktok_ad_group`, and `add_tiktok_ad` previously listed invalid values (`SUBMIT_FORM`, `ADD_TO_CART`, `VIEW_CONTENT`, `COMPLETE_REGISTRATION`, `DOWNLOAD`, `CONTACT`, `BUTTON_CLICK`) that TikTok's API would reject.

**Correct values you should use:**

| Old (invalid) | New (correct) | Meaning |
| - | - | - |
| `SUBMIT_FORM` | `FORM` | Form submission |
| `ADD_TO_CART` | `ON_WEB_CART` | Add to cart |
| `VIEW_CONTENT` | `ON_WEB_DETAIL` | View content / product page |
| `COMPLETE_REGISTRATION` | `ON_WEB_REGISTER` | Registration |
| `DOWNLOAD` | `DOWNLOAD_FINISH` | App or file download |
| `CONTACT` | `CONSULT` | Contact / consultation |
| `BUTTON_CLICK` | `CLICK_LANDING_PAGE` | Landing page click |

Additional supported values: `COMPLETE_PAYMENT`, `CONVERSION_LEADS`, `PAGE_VISIT`, `PHONE_CONNECT`, `SEARCH`, `SUBSCRIBE`, `INITIATE_ORDER`, `ON_WEB_SUBSCRIBE`.

If you were passing the old values and getting TikTok API errors, update to the new values above.

**April 13, 2026**

v2.15.2

## TikTok Ads: campaign creation reliability

5 fixes to TikTok campaign creation from production testing.

* **Spark Ads now work with `create_tiktok_campaign`** — creating campaigns with a `tiktok_item_id` (Spark Ads) or `card_id` (Carousel) no longer fails with "Unknown error". Spark and Carousel ads are now created directly without requiring an image upload.
* **All TikTok CTAs accepted** — previously, only 6 call-to-action values (like LEARN\_MORE and SHOP\_NOW) were allowed. Now any CTA supported by TikTok works — including CONTACT\_US, BOOK\_NOW, GET\_QUOTE, and others. TikTok validates CTAs server-side.
* **Automatic placement fix** — campaigns using automatic placement no longer fail with "Missing required field(s): placements."
* **TikTok page URL detection** — passing a TikTok page URL (e.g., `https://tiktok.com/@user/video/123`) as a video URL now returns a clear error explaining you should use `tiktok_item_id` for Spark Ads or provide a direct MP4/MOV link.
* **CTA auto-default** — when creating an ad with a `landing_page_url` but no `call_to_action`, Adspirer now defaults to LEARN\_MORE instead of failing with "External\_URL and Call\_to\_action must exist together."

## Meta Ads: disclaimer acceptance before connecting

When connecting your Meta Ads account, you now see a disclaimer checkbox after entering your email. You must accept the disclaimer — confirming you understand that Adspirer operates independently from Meta's account enforcement systems — before the Connect button becomes available. Acceptance is recorded for compliance purposes. See [Connecting Meta Ads](https://www.adspirer.com/docs/ad-platforms/meta-ads.md#connecting-meta-ads).

The Meta Ads page and [Security](https://www.adspirer.com/docs/knowledge-base/security.md#what-this-means) page also now confirm Adspirer has Meta approved **Ads Management Standard Access**, so users know the app is verified by Meta to use the Marketing API.

## Platform Terms & Conditions

New users now accept Platform Terms & Conditions as part of onboarding before connecting ad accounts. The terms cover account authorization requirements, rate limit safeguards, platform enforcement policies, financial responsibility, and liability. This replaces the previous per-platform disclaimer prompts with a single, comprehensive agreement.

## Faster email support

Email support response time improved from 1 business day to **2–4 hours** (San Francisco / PST). Reach us at [support@adspirer.com](mailto:support@adspirer.com).

**April 8, 2026**

v2.15.1

## Meta Ads: expanded tool coverage (21 → 36)

Meta Ads now has **36 tools** (up from 21), covering the full campaign lifecycle — from browsing and creation to ad set management, creative rotation, and lead form submissions.

### New tools

* **Ad set & ad management:** `add_meta_ad_set`, `add_meta_ad`, `update_meta_ad_set`, `update_meta_ad`, `list_meta_ad_sets`, `list_meta_ads`
* **Campaign management:** `list_meta_campaigns`, `get_meta_campaign_details`, `duplicate_meta_campaign`, `resume_meta_campaign`
* **Creative & lead gen:** `create_meta_dco_ad` (Dynamic Creative Optimization), `get_meta_ad_creatives`, `list_meta_lead_forms`, `get_meta_lead_form_submissions`
* **Account discovery:** `list_meta_instagram_accounts`, `list_meta_pixels`
* **Analytics:** `analyze_meta_wasted_spend`, `get_meta_audience_insights`

### Monitoring improvements

* `create_monitor` now lists all 15 supported metrics (roas, ctr, cpc, cpa, cpm, cpv, spend, conversions, impressions, clicks, cost\_per\_lead, conversion\_rate, budget\_utilization, video\_views, engagement\_rate)
* Advanced monitoring: AND/OR logic across multiple conditions, consecutive-day triggers, relative thresholds, percentage change detection, campaign-level targeting, and auto-actions (pause campaign, adjust budget)

## Meta Ads: ad set parity and custom audience reliability

### `add_meta_ad_set` now supports all campaign-level features

When adding ad sets to existing Meta campaigns, you can now use the same parameters that were previously only available at campaign creation:

* **Lifetime budgets** — set `budget_lifetime` on individual ad sets
* **End dates** — set `end_time` on ad sets (required when using lifetime budgets)
* **Multi-advertiser opt-out** — control `multi_advertiser` per ad set
* **Granular placements** — set `publisher_platforms`, `facebook_positions`, and `instagram_positions` per ad set

### Custom conversion tracking fix

`custom_conversion_id` is now properly decomposed into its underlying pixel and event configuration before being sent to Meta. Previously, passing a custom conversion ID could cause a Meta API error on campaign or ad set creation. Adspirer now automatically resolves the conversion via the Meta API and applies the correct pixel ID and event type.

### `list_meta_custom_audiences` reliability

* Timeout increased from 30 seconds to 90 seconds — accounts with 1,000+ audiences no longer time out
* Audience status now displays as clean labels ("Active", "Paused") instead of raw SDK objects

**April 7, 2026**

v2.15.0

## TikTok Ads: full performance analytics

8 new performance analytics tools bring TikTok to parity with Google and Meta for campaign analysis. Total TikTok tools: 4 → 31.

### New analytics tools

| Tool | Description |
| - | - |
| `get_tiktok_campaign_performance` | Campaign summary with TikTok-specific video and engagement metrics |
| `get_tiktok_ad_performance` | Ad-level analysis with hook rate, video completion, and engagement |
| `analyze_tiktok_wasted_spend` | ROAS-based waste detection with campaign status awareness |
| `optimize_tiktok_budget` | LP-based budget allocation recommendations |
| `detect_tiktok_creative_fatigue` | Hook rate decline as the primary fatigue signal |
| `explain_tiktok_anomaly` | Statistical deviation detection with TikTok-specific metrics |
| `get_tiktok_audience_insights` | Age/gender breakdown with CPA ranking |
| `analyze_tiktok_geo_performance` | Country-level performance analysis |

### TikTok now fully available

TikTok Ads is no longer marked "Coming Soon" during onboarding. You can connect your TikTok Ads account directly from the setup flow.

**April 5, 2026**

v2.14.1

## TikTok campaign management and creation

19 new tools for full campaign lifecycle management on TikTok — from campaign creation through ad group and ad management, including Spark Ads, Carousel, and APP\_PROMOTION support.

### New campaign management tools (12)

* `list_tiktok_campaigns` — List all campaigns with status, objective, and budget
* `get_tiktok_campaign_details` — Detailed campaign info
* `pause_tiktok_campaign` / `resume_tiktok_campaign` — Control campaign status
* `update_tiktok_campaign` — Update name, budget, budget mode
* `list_tiktok_ad_groups` / `pause_tiktok_ad_group` / `resume_tiktok_ad_group` / `update_tiktok_ad_group` — Full ad group management
* `list_tiktok_ads` / `pause_tiktok_ad` / `resume_tiktok_ad` — Ad-level management

### New campaign creation tools (7)

* `add_tiktok_ad_group` — Add ad groups with full targeting to existing campaigns
* `add_tiktok_ad` — Add ads to existing ad groups (image, video, Spark Ads, Carousel)
* `create_tiktok_carousel_card` — Create carousel cards from multiple images
* `upload_tiktok_images` — Upload images to TikTok Asset Library
* `search_tiktok_targeting` — Search interests, keywords, regions, languages, action categories, carriers, and device models

### New ad formats

* **Spark Ads** — Boost existing TikTok organic posts as ads
* **Carousel Ads** — Multi-image carousel format
* **APP\_PROMOTION** — App install campaign objective with app ID configuration

### Campaign Budget Optimization (CBO)

TikTok campaigns now support `budget_optimize_on` for campaign-level budget optimization. TikTok CBO is on by default — set to `false` to manage budgets per ad group manually.

### Google Ads fixes

* `get_campaign_targeting` — New tool to view location targeting on existing campaigns
* `get_campaign_structure` — Now paginated for large accounts
* `analyze_search_terms` — New `raw_report` mode shows actual search terms users type into Google
* Keyword removal now validates IDs before attempting deletion, with per-keyword error reporting

**April 3, 2026**

v2.13.1

## LinkedIn Ads overhaul + Meta Ads gaps closed

### LinkedIn campaign hierarchy and targeting

Complete overhaul of LinkedIn campaign tools with campaign group support, rollback logic, and 14 new targeting facets.

* **Campaign groups** — `campaign_group_id` and `campaign_group_name` on all create tools. New `add_linkedin_campaign_to_group` tool for adding campaigns to existing groups.
* **Carousel creatives** — New `add_linkedin_carousel_creative` tool
* **Creative naming** — `creative_name` field added to all 4 campaign creation tools
* **14 new targeting facets** — skills, job functions, interests, degrees, fields of study, employers, groups, age ranges, genders, schools, member behaviors, years of experience, followed companies, and buyer groups. All facets work on both create and update.
* **Video discovery** — Now finds videos uploaded via LinkedIn Campaign Manager UI, not just API uploads
* **Rollback logic** — Failed campaigns are automatically archived to prevent duplicates on retry
* **Campaign filtering** — `list_linkedin_campaigns` now filters by campaign group

### Meta Ads: 6 critical gaps

* **Lifetime budgets** — Set `budget_lifetime` at campaign creation (mutually exclusive with daily budget)
* **End dates** — `end_time` support on campaigns and ad sets
* **Custom audiences** — New `list_meta_custom_audiences` tool for viewing database lists, lookalikes, website, and engagement audiences
* **Granular placements** — Control `publisher_platforms`, `facebook_positions`, and `instagram_positions` at campaign creation
* **Multi-advertiser opt-out** — New `multi_advertiser` field to opt out of Meta's multi-advertiser ads
* **Custom conversion tracking** — Fixed `custom_conversion_id` being silently dropped on image and carousel campaigns

### Monitoring

* New `delete_monitor` tool — Previously, deleting monitors required knowing about `manage_scheduled_task`, which AI clients couldn't discover

**April 3, 2026**

v2.13.0

## Gemini CLI Extension

Adspirer is now available on the [Gemini CLI Extensions Gallery](https://geminicli.com/extensions/?name=amekalaads-mcp). Google's terminal-based AI tool can now manage your ad campaigns across all 4 platforms.

### Install

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
gemini extensions install https://github.com/amekala/ads-mcp
```

### What's Included

* **MCP Server** — 100+ tools across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads
* **5 Slash Commands** — `/adspirer:setup`, `/adspirer:performance-review`, `/adspirer:write-ad-copy`, `/adspirer:wasted-spend`, `/adspirer:refresh`
* **OAuth authentication** — browser opens automatically on first use

See the full [Gemini CLI Setup Guide](https://www.adspirer.com/docs/ai-clients/gemini-cli.md).

**March 30, 2026**

v2.12.0

## Official Claude Plugin

Adspirer is now an **official plugin** in the Claude plugin marketplace (`claude-plugins-official`). Available on both [Claude Code](https://www.adspirer.com/docs/ai-clients/claude-code.md) and [Claude Cowork](https://www.adspirer.com/docs/ai-clients/claude-cowork.md).

### What Changed

* **No more custom marketplace setup.** Previously, you had to manually add the `amekala/ads-mcp` marketplace before installing. Now just search for "adspirer" in the plugin browser.
* **Claude Code:** Type `/plugin`, search "adspirer", and install `adspirer-ads-agent` directly. Or run `/plugin install adspirer-ads-agent`.
* **Claude Cowork:** Go to Customize → Browse Plugins and search for "adspirer" — install with one click.
* **Plugin page:** [claude.com/plugins/adspirer-ads-agent](https://claude.com/plugins/adspirer-ads-agent)

### What's Included

The official plugin bundles everything in a single install:

* **MCP Server** — 100+ tools across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads
* **5 Slash Commands** — `/setup`, `/performance-review`, `/write-ad-copy`, `/wasted-spend`, `/refresh-brand-context`
* **2 Skills** — Ad campaign management and best practices
* **1 Agent** — Performance marketing agent with safety rules

Updated setup guides for [Claude Code](https://www.adspirer.com/docs/ai-clients/claude-code.md) and [Claude Cowork](https://www.adspirer.com/docs/ai-clients/claude-cowork.md) to reflect the simplified installation flow.

**March 25, 2026**

v2.11.0

## Lead Gen Campaign Support

Full lead generation support across Google Ads and Meta Ads — performance analysis, wasted spend, and audience tools now handle lead gen campaigns correctly.

### Google Ads Lead Gen

* Performance analysis, wasted spend, and audience tools now work for campaigns optimized for leads. Previously, tools could crash or show incorrect metrics for lead gen campaigns.
* Conversion metrics now use primary conversions only (`metrics.conversions`), matching what you see in the Google Ads UI. Previously, Adspirer reported all conversions including secondary actions, which inflated numbers.
* PMax search themes now correctly apply to the specified asset group, not the first one found.

### Meta Ads Lead Gen

* All performance tools — `analyze_meta_campaign_performance`, `analyze_meta_ad_performance`, `get_meta_wasted_spend`, and audience analysis — now support lead gen campaigns (OUTCOME\_LEADS optimization).
* CPA calculation now uses the ad set's optimization event instead of dividing by total conversions. If you're optimizing for leads, CPA reflects cost-per-lead, not cost-per-all-actions.
* Audience CPA sort order now shows lowest CPA first for lead gen campaigns.

### Audience Search Fix

* `search_audiences` now returns results for multi-word queries (e.g., "digital marketing" or "home improvement"). Previously, multi-word searches returned zero results, causing AI clients to fabricate audience IDs.
* DemandGen and YouTube tools now validate audience segment IDs against the API instead of accepting AI-generated IDs that don't exist.

### OpenClaw Plugin Fix

Fixed empty-argument bug affecting all 143 tools. The OpenClaw plugin now ships complete input schemas, so tools receive the parameters you provide instead of empty objects.

### Faster Tool Responses

* Google Ads account list cached in Redis (3-minute TTL) — subsequent tool calls skip the account discovery API call.
* All Google Ads data cache TTLs increased to 10 minutes — repeat queries (e.g., checking campaign performance twice) return instantly from cache.

**March 24, 2026**

v2.10.0

## Google Ads Rate Limit Fix & MCC Reliability

### Rate Limit Resolution (P0)

Fixed a critical issue where Google Ads API rate limits (HTTP 429) could block **all users** — not just the affected account. The system now caches account list responses and includes an emergency recovery endpoint. Users who were seeing "Resource has been exhausted" errors should no longer be affected by other accounts' API usage.

### MCC Account Fixes

* Child accounts under MCC (My Client Center) manager accounts now correctly resolve their `login_customer_id` during onboarding and tool calls. Previously, some MCC child accounts would fail with "The caller does not have permission" errors.
* Direct (non-MCC) accounts are no longer incorrectly mapped to an MCC manager, which caused "customer not found" errors for users with standalone ad accounts.
* `login_customer_id` is now stored in the database, eliminating a `ListAccessibleCustomers` API call on every tool call — faster and more reliable.

### Meta Ads CPA Fix

CPA for Meta campaigns now uses the ad set's optimization event (e.g., cost per lead, cost per purchase) instead of dividing spend by total conversions. This was especially inaccurate for lead gen campaigns where secondary events inflated the denominator.

**March 22, 2026**

v2.9.7

## Error Clarity, LinkedIn & Meta Fixes

### Google Ads Error Messages

* Centralized error parsing across all 18 Google Ads write operations. Errors now show the specific field and issue (e.g., "headline exceeds 30 characters") instead of raw API codes.
* `add_keywords` now detects policy violations (trademark, restricted content) and provides specific guidance.
* `update_bid_strategy` returns actionable error details when a strategy change fails, instead of just the strategy name.

### LinkedIn Improvements

* `search_linkedin_targeting` now uses LinkedIn's typeahead API for better, faster targeting search results. Facet names (job title, company, industry) are correctly mapped to LinkedIn's API format.
* Fixed parameter mismatches, null handling, and error parsing across LinkedIn Ads tools.

### Meta Ads Fixes

* `add_meta_ad` and `add_meta_ad_set` now honor the name you provide. Previously, the user-provided name was silently ignored.
* `add_keywords` routing fix — calls now use the correct code path with policy violation detection.

### OAuth Fix

Fixed a 500 error on the OAuth authorization page. Users connecting via ChatGPT or Claude would see a server error instead of the consent screen.

**March 21, 2026**

v2.9.6

## LinkedIn Creatives & Campaign Enhancements

### LinkedIn Creatives

* Fixed `list_linkedin_creatives` returning empty results for large accounts (22,000+ creatives). Pagination now handles all account sizes correctly.
* Fixed duplicate creatives appearing in results due to pagination overlap.
* Rewrote creative filtering to use LinkedIn's server-side FINDER API, eliminating timeouts on campaign-level creative lookups.
* Fixed LinkedIn metrics silently dropping to zero, MCP timeout on large result sets, and pagination breaking on no-match scenarios.

### Google Ads Campaign Extensions

* Added `MAXIMIZE_CONVERSION_VALUE` as a supported bidding strategy for all campaign types.
* Extensions (sitelinks, callouts, snippets) are now added in a single batch operation instead of individually, reducing API calls and errors.
* Automatic retry on `CONCURRENT_MODIFICATION` errors when multiple operations target the same campaign.

### PMax, Demand Gen & YouTube

Your business logo is now automatically injected into PMax, Demand Gen, and YouTube campaigns during creation — no need to provide it manually if one exists at the account level.

### Monitoring

Fixed `create_monitor` using a 30-minute default check interval, which was below the API minimum of 1,440 minutes (24 hours). Monitors now default to a valid interval.

**March 21, 2026**

v2.9.5

## Perplexity Computer Support

### New AI Client: Perplexity

Adspirer now supports [Perplexity](https://www.adspirer.com/docs/ai-clients/perplexity.md) as an AI client via MCP connector. Connect Adspirer to Perplexity Computer — the autonomous AI agent — and combine real-time web research with 100+ advertising tools.

* **OAuth setup** — Add Adspirer as a custom connector in Perplexity Computer → Connectors. OAuth auto-discovery means zero configuration beyond the URL.
* **Search + ads** — Perplexity's native web search lets you research competitors and market trends, then immediately act on that research using Adspirer tools. No other client combines real-time search with ad management this seamlessly.
* **Perplexity Computer** — Max subscribers get autonomous multi-step workflows: research → create → optimize, all from a single prompt.
* **Requires** Perplexity Pro ($20/mo), Max ($200/mo), or Enterprise.

Updated all documentation pages, Knowledge Base, and cross-references to include Perplexity as a supported AI client.

**March 21, 2026**

v2.9.4

## Audience Targeting Fixes for Demand Gen, YouTube & PMax

### Custom Interest Audiences Now Work in Demand Gen & YouTube

Custom interest audiences (custom segments) were not being applied when creating Demand Gen or YouTube campaigns — even though the tool response showed them as set up. Remarketing audiences worked correctly, but custom interest targeting was silently dropped. This is now fixed. All audience segment types (in-market, affinity, custom audiences, and remarketing lists) work consistently across PMax, Demand Gen, and YouTube campaigns.

### PMax: No More Unwanted Search Themes on Remarketing Campaigns

When creating a PMax campaign with only remarketing audiences and no search themes, the system was auto-generating search themes from your ad headlines. If you only ask for audience targeting, search themes will no longer be added automatically.

**March 19, 2026**

v2.9.3

## Stable MCP Sessions

### No More Intermittent "Invalid Token" Errors

Fixed an issue where some tool calls would randomly fail with "Invalid or expired token" — especially after being idle for a while. Sessions are now resilient to Clerk session expiry. If a session token becomes stale, the system automatically recovers without requiring you to reconnect.

**March 18, 2026**

v2.9.2

## Billing & Onboarding UX

### Billing Page

* Fixed pricing display and plan comparison layout
* Fixed broken navigation between billing sections
* Improved upgrade/downgrade CTA logic

### Onboarding

* Fixed layout and scroll issues on onboarding screens
* Plan tier messaging now accurately reflects current pricing
* Save badge visibility fixed

**March 17, 2026**

v2.9.1.1

## Automation Tools: Multi-Platform Fix

Scheduled briefs, monitoring alerts, and on-demand reports now work correctly for **all platforms** — Meta Ads, LinkedIn Ads, and TikTok Ads. Previously, automation tools only worked reliably for Google Ads. Monitors set to track "all platforms" were silently resolving to zero accounts.

**March 16, 2026**

v2.9.1

## Persistent MCP Sessions & Faster Auth

### No More Frequent Reconnects

MCP access tokens now last **1 week** instead of 1 hour. Claude, ChatGPT, Codex, and Cursor sessions stay authenticated much longer — no more "Error occurred during tool execution" after stepping away for an hour.

Diagnostic tools (`get_usage_status`, `get_connections_status`) remain available even when your quota is exhausted, so you can always check your account status.

### Faster Tool Responses

Added an in-process auth cache that eliminates repeated token verification overhead. Subsequent tool calls in the same session resolve authentication instantly instead of re-verifying on every request.

### Manus AI Client Support

New setup guide for connecting Adspirer to [Manus](https://www.adspirer.com/docs/ai-clients/manus.md) — the autonomous AI agent. Manus connects via API key authentication with Streamable HTTP transport. Import Adspirer skills directly from GitHub for campaign management workflows.

### Meta Ads Fix

Meta tools now always pass the correct connected ad account ID. Previously, some Meta tools could fail with "No ad account found" even when an account was connected.

### LinkedIn Ads Fix

Fixed currency formatting for LinkedIn campaign metrics. Campaigns with non-USD currencies now display correctly instead of showing raw API values.

### Faster Google Ads Account Loading

Google Ads account connections now load with lazy pagination and parallel processing. The connections page loads instantly instead of waiting for all accounts to resolve.

**March 15, 2026**

v2.9.0

## Quota Experience & Error Clarity

Completely overhauled how Adspirer communicates quota limits and errors across all AI clients.

### Usage Warnings Before You Hit the Wall

Tool responses now include a visible usage footer when you're approaching your quota limit:

* **75%+ usage** — `📊 12/15 free calls used (80%) — 3 remaining. Upgrade: ...`
* **90%+ usage** — `🚨 2 calls remaining! Upgrade now to avoid interruption: ...`

Previously, usage warnings were only visible in ChatGPT's widget. Now they appear on **all clients** — Claude, Claude Code, Cursor, Codex, and ChatGPT.

### Diagnostic Tools Always Available

`get_usage_status`, `get_connections_status`, and `echo_test` now work even when your quota is exhausted. You can always check your usage and connection status regardless of your remaining calls. These tools don't count against your quota.

### Clear Error Messages

* **Quota exceeded** — shows a clean upgrade message with pricing and payment link (previously showed a generic "Error occurred during tool execution" on Claude)
* **Session expired** — now tells you exactly what happened and how to reconnect (previously showed the same generic error)
* **Server errors** — include the actual error details and retry guidance

**March 14, 2026**

v2.8.2

## Demand Gen: Multi-Region Ad Groups

Add ad groups to existing Demand Gen campaigns with `add_demandgen_ad_group`:

* Each ad group can target **different locations** (e.g., US cities vs India cities vs UAE cities)
* Each ad group can have its own **audience signals** (in-market + affinity segments)
* Reuse existing account images and YouTube videos across ad groups
* Different creative variations per ad group

### Meta Ads: City Targeting & Placement Creatives

* **City-level targeting** — target specific cities in Meta campaigns with `search_meta_targeting`
* **Placement-specific creatives** — upload different images for Feed, Stories, and Reels placements
* **Emoji support** — use emoji in Meta ad headlines and descriptions

### AI Client Input Resilience

Adspirer now handles common input mistakes from AI clients automatically:

* JSON strings sent as text instead of objects are auto-parsed
* Integer IDs sent instead of strings are auto-coerced
* Extra whitespace and unknown fields are silently handled
* Works across all 100+ tools — no more validation errors from formatting issues

**March 12, 2026**

v2.8.1

## PMax: Multiple Asset Groups & Bidding Control

* **Multiple asset groups per campaign** — create campaigns with distinct asset groups for different product lines or audiences
* **Bidding strategy control** — your explicit bidding choice (Maximize Conversions, Target ROAS, etc.) is now always honored
* **Auto-derived search themes** — search themes are automatically suggested from your headlines and descriptions
* **Post-creation nudge** — after creating a PMax campaign, you're prompted to add search themes and audience signals

**March 10, 2026**

v2.8.0

## Demand Gen Campaign Creation

Full support for Google Demand Gen campaigns — reach users across YouTube, Discover, Gmail, Display, and Maps from a single campaign.

Create Demand Gen campaigns with `create_demandgen_campaign`:

* **Multi-asset format** — landscape, square, and portrait images with headlines and descriptions
* **Video responsive format** — YouTube videos with text overlays
* Automatic sitelink, callout, and structured snippet extensions
* Location and language targeting at the campaign level
* All bidding strategies supported: Maximize Clicks, Maximize Conversions, Target CPA, Target ROAS

### Audience Targeting

* In-market and affinity audience segments via `search_audiences`
* Reuse existing audiences from Google Ads UI
* Per-ad-group audience customization

### Meta Ads Fixes

* Fixed lead form handling for OUTCOME\_LEADS and OUTCOME\_ENGAGEMENT campaigns
* Fixed Meta page and Instagram account lookup for business accounts
* Wasted spend analysis now respects learning phase and minimum spend thresholds

**March 11, 2026**

v2.7.0

## PMax Search Themes & Audience Signals

Added 7 new tools for managing search themes and audience signals on Google Ads Performance Max campaigns. These PMax-only features give you direct control over how Google's automation targets search queries and audience segments.

### New Tools

| Tool | Type | Description |
| - | - | - |
| `add_pmax_search_themes` | Write | Add search themes to guide PMax targeting (max 50 per asset group) |
| `get_pmax_search_themes` | Read | View current search themes on a PMax campaign |
| `remove_pmax_search_themes` | Write | Remove specific search themes |
| `add_pmax_audience_signal` | Write | Add audience signal combining in-market, affinity, custom audiences, and user lists |
| `get_pmax_audience_signals` | Read | View current audience signals |
| `remove_pmax_audience_signal` | Write | Remove an audience signal |
| `search_audiences` | Read | Search for audiences by keyword across all Google Ads audience types |

### Search Themes

Short phrases (max 50 per asset group) that tell Google which search queries your PMax campaign should target. They supplement Google's automated targeting with explicit intent signals. Supports add and remove operations — to update, remove and re-add.

### Audience Signals

Tell Google which audience segments are most likely to convert. Combine multiple segment types in a single signal:

* **In-market audiences** — users actively researching products in a category
* **Affinity audiences** — users with sustained interests and habits
* **Custom audiences** — account-level custom audience segments
* **User lists** — first-party data (website visitors, customer lists, CRM uploads)

Only one audience signal per asset group. Signals are suggestions, not hard targeting — Google uses them as starting points and expands.

### Agent Skills Updated

The Ad Campaign Management skill and Performance Marketing Agent now include search themes and audience signals in the PMax campaign creation workflow (steps 9-10). The agent will automatically recommend search themes based on keyword research and suggest relevant audience segments.

### Bug Fixes

* Fixed GAQL query syntax for asset group signals (`campaign.id` instead of `asset_group.campaign.id`)
* Fixed audience search returning zero results (replaced case-sensitive GAQL LIKE with client-side filtering + `taxonomy_type` enum)
* Added `user_list_ids` support for remarketing lists in audience signals
* Increased max search themes from 25 to 50 (Google's actual limit)

**March 7, 2026**

v2.6.0

## API Key Authentication (Personal Access Tokens)

Adspirer now supports **Personal Access Tokens** for headless and remote server authentication. Generate API keys from the dashboard and use them on remote servers, Docker containers, and CI/CD pipelines where browser-based OAuth isn't available.

### What's New

* **API Key Management UI** — Generate, name, and revoke API keys from [adspirer.ai/keys](https://adspirer.ai/keys)
* **OpenClaw `--token` flag** — `openclaw adspirer login --token sk_live_...` for headless authentication
* **`ADSPIRER_API_KEY` env var** — Set the environment variable for zero-config server authentication
* **Tier-based key limits** — Free: 2 keys, Plus: 5, Pro: 10, Max: 20
* **Key expiration** — Optional expiration (30 days, 90 days, 1 year, or never)
* **Admin controls** — Admin dashboard for API key analytics, per-user key management, and emergency revocation
* **Auth method tracking** — Tool call logs now track whether each call used OAuth or an API key

### Security

* Keys use `sk_live_` prefix for easy identification
* SHA-256 hashed storage — raw tokens never stored server-side
* Instant revocation with audit trail
* Keys cannot be used to create other keys (prevents privilege escalation)

### Documentation

* [OpenClaw Remote Server Setup](https://www.adspirer.com/docs/ai-clients/openclaw.md#remote-server-setup) — Step-by-step guide
* [Security — API Key Authentication](https://www.adspirer.com/docs/knowledge-base/security.md#api-key-authentication) — Security model and comparison
* Updated [How MCP Works](https://www.adspirer.com/docs/mcp.md) — Authentication section
* Updated [FAQ](https://www.adspirer.com/docs/knowledge-base/faq.md) — Remote server and API key questions

**March 5, 2026**

v2.5.0

## Claude Cowork Setup Guide

New documentation page with step-by-step visual guide for connecting Adspirer to [Claude Cowork](https://www.adspirer.com/docs/ai-clients/claude-cowork.md). Includes 9 annotated screenshots covering the full flow: plugin install from marketplace, connector setup, OAuth authentication, and brand folder workspace.

### Claude Connector Simplified

[Claude Chat setup](https://www.adspirer.com/docs/ai-clients/claude.md) no longer requires manual OAuth configuration. Just paste the URL — Claude auto-discovers the server name and authentication settings.

### ChatGPT Setup Updated

[ChatGPT setup](https://www.adspirer.com/docs/ai-clients/chatgpt.md) updated to match current UI: new field names, OAuth advanced settings callout, "I understand and want to continue" checkbox, and the new **Reference memories and chats** preferences screen.

**March 3, 2026**

v2.4.0

## LinkedIn Exhaustive Campaign Features

Extended LinkedIn campaign tools with exhaustive targeting and management capabilities. Fixed Google `list_campaign_extensions` returning incorrect data.

### Database Performance

Phase 1 database performance improvements for faster query execution across campaign metrics and user analytics.

### Documentation: Agent Pages & Support

Added 8 new documentation pages:

* **[Claude Code Agent](https://www.adspirer.com/docs/agent-skills/claude-code-agent.md)**, **[Cursor Agent](https://www.adspirer.com/docs/agent-skills/cursor-agent.md)**, **[Codex Agent](https://www.adspirer.com/docs/agent-skills/codex-agent.md)**, **[OpenClaw Agent](https://www.adspirer.com/docs/agent-skills/openclaw-agent.md)** — per-client agent architecture docs
* **[How It Works](https://www.adspirer.com/docs/how-it-works.md)** — 5-layer architecture page
* **[FAQ](https://www.adspirer.com/docs/knowledge-base/faq.md)**, **[Glossary](https://www.adspirer.com/docs/knowledge-base/glossary.md)**, **[Support](https://www.adspirer.com/docs/knowledge-base/support.md)** — knowledge base expansion
* Added Support tab to top navigation

**February 28, 2026**

v2.3.0

## Pricing V2

Updated pricing across all tiers:

| Plan | Price | Tool Calls |
| - | - | :-: |
| **Free** | \$0/mo | 15/month |
| **Plus** | \$49/mo | 150/month |
| **Pro** | \$99/mo | 600/month |
| **Max** | \$199/mo | 3,000/month |

* Annual pricing option now available with savings
* Tool call counter resets to 0 on tier upgrade
* Fixed subscription cancellation on upgrade to prevent double-billing
* Stripe webhook handlers now sync quota correctly

### MCC/Manager Account Warnings

Connections page now warns users attempting to connect MCC (Google) or Business Manager (Meta) accounts instead of individual ad accounts.

### OpenClaw Plugin Updates

* `openclaw adspirer uninstall` CLI command added
* OAuth retry logic improved
* Skill metadata updated with security section and privacy policy

**February 27, 2026**

v2.2.1

## Skill Reference & Performance Marketing Agent Docs

Added 2 new pages to the Agent Skills section:

* **[Skill Reference](https://www.adspirer.com/docs/agent-skills/skills.md)** — Complete reference for all 5 Adspirer skills with invocation commands per IDE (Claude Code, Cursor, Codex), step-by-step execution details, and example prompts
* **[Performance Marketing Agent](https://www.adspirer.com/docs/agent-skills/agent.md)** — How the agent orchestrates skills with brand knowledge, strategy persistence, and memory across sessions

### Strategy-Aware Execution

Skills now read `STRATEGY.md` before executing — a persistent file where strategic decisions (AVOID, PREFER, CONSTRAINT, REQUIRE directives) survive across sessions:

* **Campaign creation** loads strategy directives at Step 0 and flags conflicts with research results
* **Keyword research** cross-references results against AVOID/PREFER directives
* **Performance review** flags "Strategy Drift" when campaigns violate active directives
* **Wasted spend** prioritizes campaigns violating strategy as waste sources

### Agent Documentation Highlights

* Mermaid architecture diagram showing Agent → Context + Strategy + Memory → Skills → Tools → Platforms
* IDE comparison table for agent features across Claude Code, Cursor, and Codex
* Brand Workspace setup flow and context file structure
* Cursor Rules and Codex Safety Rules explained with before/after examples

**February 26, 2026**

v2.2.0

## Asset Discovery & PMax Validation

* Fixed asset discovery across platforms
* YouTube logo upload support for PMax campaigns
* Mandatory extensions enforcement for Google Ads
* PMax logo validation improvements

### CLI OAuth Fix

Resolved OAuth failures for CLI clients (Claude Code, Codex). Loopback redirect now correctly routes web vs CLI authentication flows.

### Cross-Domain Attribution

Added referrer-based UTM fallback for cross-domain tracking between adspirer.com and adspirer.ai.

### Help & Contact Page

Added in-app Help page with documentation link and contact options.

**February 22, 2026**

v2.1.0

## YouTube Ads Campaign Support

Added YouTube Ads campaign creation to the Google Ads toolset. Create video ad campaigns targeting YouTube viewers with budget controls and audience targeting.

### Automation Tools

Launched 8 automation tools:

* **Scheduled briefs** — automated performance summaries on a recurring schedule
* **Performance monitors** — alerts when campaigns cross KPI thresholds
* **Cross-platform reports** — unified reporting across Google, Meta, and LinkedIn

### UI Redesign

Mobile dropdown and desktop tab redesign for the main app. Removed trial language from onboarding flow.

### Documentation Updates

* Enhanced Mintlify components: Frame, Badge, Check, Info, Tooltip across all pages
* Tabbed install methods for Claude Code setup
* Resend-style navbar redesign
* GA4 tracking added to docs site
* 6 new Knowledge Base articles, MCP explainer page, Mermaid workflow diagrams
* UTM tracking on all CTA links

**February 16, 2026**

v2.0.1

## Expanded Onboarding Setup Guides

Onboarding now includes 6 platform-specific setup tabs with step-by-step instructions for connecting Adspirer to each AI client.

### OpenClaw Plugin v0.3.0

Fixed OpenClaw OAuth client registration and plugin authentication flow.

**February 2026**

v2.0.0

## Documentation Site Launch

Launched comprehensive documentation at [adspirer.com/docs](https://www.adspirer.com/docs/introduction.md) with 24 pages covering all AI clients, ad platforms, agent skills, and in-depth guides.

* **AI client guides** for ChatGPT, Claude, Claude Code, Cursor, Codex, OpenClaw, and Windsurf
* **Ad platform guides** for Google Ads (39 tools), Meta Ads (20 tools), LinkedIn Ads (28 tools), and TikTok Ads (4 tools)
* **Agent skills documentation** with workflows, tool catalog, and safety rules
* **7 in-depth guides** covering keyword research, automation, and strategy
* Auto-generated `llms.txt`, `llms-full.txt`, and `skill.md` for AI agent discovery
* Contextual sharing to ChatGPT, Claude, Cursor, and VS Code

## ChatGPT MCP Connector

Added native MCP connector support for ChatGPT Plus and Pro users. Connect Adspirer directly in ChatGPT Settings with OAuth 2.1 authentication.

## Claude MCP Connector

Added native MCP connector for Claude Pro, Max, Team, and Enterprise. Includes progress streaming for real-time updates during campaign creation.

## Codex Agent Support

Added autonomous agent setup for OpenAI Codex with YAML configuration and skill files.

## OpenClaw Plugin

Released zero-configuration OpenClaw plugin with bundled 14.4KB skill file. Install with `openclaw plugins install openclaw-adspirer`.

**January 2026**

v1.9.0

## ChatGPT MCP Connector Fix

Fixed dynamic client registration to correctly detect Claude vs ChatGPT during OAuth. Claude clients now receive the correct redirect URIs instead of ChatGPT credentials.

### OpenAI Apps SDK Integration

Added domain verification, OAuth protected resource endpoints, MCP annotations for tool hints, and OpenAI Platform redirect URI for app submission.

### LinkedIn Campaign Fixes

Fixed LinkedIn campaign creation and update workflows. Resolved API version errors.

### Conversion Tracking

Set up end-to-end conversion tracking infrastructure for measuring signup-to-paid funnel. Multiple fixes to Google Ads metrics accuracy.

### Onboarding Revamp

Redesigned onboarding flow with mobile-responsive screens, auto-completion logic, and MCP OAuth gating to prevent onboarding bypass.

### Enterprise Readiness

Account lifecycle management, metrics pause for inactive accounts, and sign-in/sign-up page revamp.

### Meta Ads Traffic Management

Added Meta video and carousel campaign creation, ad management workflows, and traffic management tools.

### GTM Cross-Domain Tracking

Added Google Tag Manager (GTM-PQGBFK5Q) to frontend. GA4 sessions now persist across domains via the `_gl` parameter.

**December 2025**

v1.8.0

## LinkedIn Ads Full Integration

Complete LinkedIn Ads integration across 8 phases:

* LinkedIn account setup and OAuth
* Single image sponsored content campaigns
* Campaign performance analytics
* Unified tools for cross-platform management

### Meta Video & Carousel Campaigns

Added video campaign creation and carousel ad support for Meta Ads.

### Local Currency Support

Fixed currency handling across all MCP tools and backend APIs. Campaigns now display metrics in the user's local currency.

### Smart Metric Collection

Automated background metric collection for historical performance tracking.

**November 2025**

v1.7.0

## Asset Reuse & PMax Improvements

* Smart asset discovery and reuse for Performance Max campaigns
* Domain filtering for sitelinks
* Location targeting fix for MCP/ADK PMax campaigns

### Account Tier System

Account tier infrastructure with 120-day metric backfill for new users. Accurate daily metrics via `segments.date` in queries.

### ChatGPT Apps SDK Widgets

In-app quota widget and account management tools for ChatGPT users. OAuth improvements for API routes.

### Custom GPT Support

Added ChatGPT Actions support with OAuth compatibility for Custom GPT configurations.

### MCP Protocol Improvements

* Progress streaming (MCP 2025-03-26) for real-time updates during campaign creation
* False success message elimination
* OAuth token rotation on reconnect
* JWT expiry fix and performance routing improvements

**October 2025**

v1.6.0

## TikTok Ads Integration

Complete TikTok Ads platform integration:

* OAuth setup and multi-platform architecture
* In-feed video campaign creation
* Image upload and asset validation
* Session handling and location targeting

### MCP Server Launch

Initial MCP server deployment at `mcp.adspirer.com`:

* OAuth 2.1 with PKCE authentication
* Complete PMax campaign creation via ChatGPT
* Modular architecture for multi-platform support

### Creative Canvas

Multi-image upload UX improvements and character limit enforcement for PMax campaigns.

**September 2025**

v1.0.0

## Adspirer Launch

Initial release with 100+ tools across Google Ads and Meta Ads.

### Google Ads (39 tools)

* Keyword research with real CPC data from Google Keyword Planner
* Search and Performance Max campaign creation
* Wasted spend analysis, budget optimization, and ad extensions
* Asset discovery, validation, and ad copy generation

### Meta Ads (20 tools)

* Image, video, and carousel campaign creation
* Audience targeting and creative fatigue detection
* Placement optimization and performance analysis

### Core Features

* OAuth 2.1 authentication with PKCE
* Multi-platform account management
* Agent skills system with SKILL.md instruction files


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.