Advertising.chat Documentation¶
Advertising.chat is ad serving for conversational AI. Publishers and developers use it to deliver sponsored content and ads inside chat experiences — with the targeting, scheduling, and reporting you expect from a traditional ad server, adapted to conversations.
Your first ad — the whole path¶
The path from zero to a live, measured, revenue-earning ad is short:
- Get access. Advertising.chat is in private beta — request access at advertising.chat. Then sign in to the Console and copy your fetch key (new accounts get one automatically, shown on Get Started).
- Fetch an ad:
POST https://ads.advertising.chat/v1/fetch/v2with your fetch key and the conversationcontext. Your first fetch returns a real ad — there is nothing to set up. - Render the returned card, clearly labeled "Sponsored."
- Present the action URLs verbatim — they are click-tracking URLs, so clicks self-track when the user taps them.
- Report conversions when they truly happen.
That is the entire loop. Head to In-chat Ads and pick the quickstart that matches your bot:
-
Start with In-chat Ads
The publisher path — MCP for agents, a system-prompt path, a typed Node SDK, or plain REST. Zero to a served, clickable ad in minutes.
-
Connect your platform
Serve ads from Dialogflow agents or Twilio Studio flows by calling the fetch API.
-
Define your own inventory
Enterprise messaging teams target their own offers with ad units, line items, and detailed reporting.
-
Run a campaign
Advertisers reach people inside conversations across the network.
Three products under one network¶
Advertising.chat is a conversational ad network with three audience-scoped products. Most people need only the first.
- In-chat Ads (start here) — for publishers. Drop
a sponsored message into your chatbot or AI assistant and earn: a fetch key,
a
fetch, a "Sponsored" card. Includes AdKit (MCP, Ad Skill, Node SDK), conversational flow ads, and the web embed (beta). - Offer Manager (enterprise) — for messaging teams who want to define and target their own offers, with ad units, line items, creatives, and detailed reporting. A separate premium product for teams that want that level of control.
- Advertisers — for advertisers who pay to run campaigns across the network: campaigns, ad groups, creatives, budgets, flight dates, and targeting.
Every product runs on the same Ad Fetch API and event stream. Optional, additive capabilities — semantic selection and the appropriateness gate, decision traces, pacing, and operating your account from an agent — are grouped under Advanced.