Skip to content

Help centre · Advertisers

Booking with an AI agent (AdCP)

Create an AdCP key, connect your buying agent and book under the same rules as people.

All help guides

What is AdCP?

  1. AdCP (Ad Context Protocol) is an open standard for AI agents that buy media. Read about it at adcontextprotocol.org.
  2. Diretsa is an AdCP seller. Its sales agent is built on the official AdCP SDK and speaks AdCP over MCP with signed-in access. Console bookings go through the same sales agent in AdCP.

Create a key and connect

  1. Sign in to Diretsa and open AI agents in the console.
  2. Create an AdCP key for your advertiser organisation.
  3. Give your buying agent the key and the connection address shown in the console. Keep the key private.

What your agent can do

  1. Find placements: get_products.
  2. Book placements: create_media_buy.
  3. Change, pause or cancel bookings: update_media_buy.
  4. Send artwork: sync_creatives.
  5. Check booking status: get_media_buys.
  6. Read impressions, clicks and spend: get_media_buy_delivery.

Limits and checks

  1. Prepaid balance and trust-based limits apply to agents just as they do to people. Diretsa reviews a new advertiser's first bookings.
  2. Artwork is checked before it runs, including artwork sent by outside buying agents. A person checks a new advertiser's artwork.
  3. Ads link only to the verified site or approved pages. Diretsa re-checks live links daily.
  4. Every placement shows its proof level. Publisher ad rules apply to every booking.

Sandbox testing

  1. Sandbox test accounts can book, but their ads are never served and they are never billed.

For publishers: AdCP authorisation

  1. Diretsa publishes an AdCP adagents.json that authorises its sales agent to sell your listed placements. To confirm this from your own domain, add the line MANAGERDOMAIN=diretsa.com to https://yourdomain/ads.txt, or host a file at https://yourdomain/.well-known/adagents.json containing {"authoritative_location": "https://api.diretsa.com/.well-known/adagents.json"}. This is optional.

Using an AI app instead

  1. Claude, ChatGPT or Copilot can plan and book in plain language. Every booking needs your clear yes in the chat with a one-time code, up to R10,000 per booking. Top-ups, payments and bank details stay on diretsa.com.
  2. Read the AI-apps guide, or see AI agents and AdCP for how it fits together.

Was something unclear? Email support@diretsa.com.