Realize Plugin

accounts

Discover Realize accounts and capture the account_id required by every other Realize MCP tool. Must run before any campaign or report query.

campaigns

List and inspect Realize campaigns and their creatives/items. Use after an account_id is resolved.

diagnose-tracking

Diagnose whether the Taboola Pixel on an advertiser's site is installed correctly, actually firing, and feeding conversions into Realize — and route the fix. Covers both the base pixel ("pixel shows inactive") and specific conversion events and their rules ("make_purchase isn't tracking"). Activates on "my pixel isn't firing", "conversions aren't tracking", "is my pixel installed correctly", "purchases are double-counted", "check the pixel on this page". Works from the user's page URL plus evidence the user captures (a HAR recording, a window._tfa dump), cross-checks conversion rules and reports via the MCP, and hands rule fixes to manage-campaigns. Not for installing the pixel (web-fallback has the platform steps), campaign performance questions (optimize-campaign), or app-install campaigns landing on an app store — no web pixel runs there (S2S/MMP territory).

discovery

Look up Realize targeting metadata, audiences, publishers, conversion rules, time zones, and CTA types. Use when the user asks "what X is available" or needs an opaque ID before going to the Realize UI. Read-only — no campaign or item state is changed.

manage-campaigns

Create and update Realize campaigns, native + display items, and account-level conversion rules via the Realize MCP write tools. Activates on any write-intent request — create, edit, pause/resume, launch, budget changes, bid changes, targeting edits, creative swaps, conversion-rule creation, attribution-window changes, retiring a conversion rule. Enforces a tiered preview-then-confirm pattern with a mandatory account-identity header on every confirmation so the user always sees which account is being mutated. Falls back to a UI reference for actions the MCP does not currently expose (delete, duplicate, bulk operations, pixel installation, codeless-conversion setup, pixel test-fire). Grounded in the realize-toolkit's setup guidance and Taboola's official setup guide for the input-validation heuristics (Marketing Objective enum, Bid Strategy × budget minimums, learning-phase defaults).

optimize-campaign

Diagnose a Realize campaign that's underperforming or had a discrete performance event, and prescribe fixes. Walks 5 mandatory pre-checks then routes to RCA (when something broke on a specific date) or general optimization (ongoing review). Activates on questions like "why is this campaign underperforming?", "CPA spiked yesterday", "what should I pause?", "how do I improve CPA?", "campaign isn't spending", "lead quality is bad", "performance has plateaued".

realize-guardrails

Apply the shared Realize account-resolution, user-facing output, privacy, and preview-then-confirm safety rules before answering Realize questions or performing writes.

reports

Pull Realize performance reports (CSV) and interpret them. Covers the metamodel-driven dynamic report (any dimension × metric combination — e.g. campaign, ad, site, day/week, country, platform, browser, OS), the classic campaign-breakdown report that still serves GROUP and admin-network accounts, and the campaign-history change log, with the mandatory settings-first workflow, filter/sort rules, and pagination.

support

Package the current conversation into a single Markdown file the user can email to Taboola Support so Professional Services can debug what happened. Activates on /realize-plugin:support, and whenever the user wants to escalate to a human, report that the plugin gave a wrong or suspicious answer, or file a bug. Writes one local file after an explicit confirmation — never transmits anything.

web-fallback

Answer in-scope Realize questions the plugin's own knowledge base does not cover, by looking the topic up in Taboola's public advertiser help documentation. Activates only after a real miss — no knowledge file, no MCP tool, and no other skill answers the question as asked. Read-only. A fallback rather than a supplement — when the knowledge base has the answer, or when a web source contradicts it, the plugin's own guidance wins and no lookup happens.