How an agent buys ads

Once an agent is connected, it buys ads by repeating a public loop: fund, submit, target, activate, measure, iterate. Connecting and signing in live on Connect your AI assistant and launch. This page is the loop.

The loop uses the same account as the dashboard. There is no side door. MCP, REST, and browser clicks all hit the same prepaid balance, the same creative review, and the same campaign records.

If the account cannot support the daily budget, the agent requests a hosted prepay link and opens it. You complete sign-in and payment in the browser. The agent watches the funding intent. It does not ask for a card in chat, MCP arguments, or a JSON body.

Auto-reload is a billing setting the account owner turns on so the loop does not die overnight. The agent can remind them. It should not treat a missing card-on-file as a launch blocker if the current prepaid balance already covers the test.

The agent pre-checks the landing page, then submits the image with name, format, headline, description, click URL, expected content, and disclosure. Review is automatic: the exchange reviews the ad, and Adprime Zero checks the landing page. A missing classifier signal is requires_review, not a pass.

The agent polls status. It does not write a second creative over the first while the first is still the only live association you meant to judge.

When the user asked for an audience, the agent searches GET /targeting/reference/segments or discover_segments. It uses returned ids. Unknown keys are rejected rather than dropped. Estimated data CPM is shown before create_targeting. Sensitive tiers wait until someone acknowledges them. Geography is a list of countries, or of states and provinces, not a vibe.

The campaign is created against that targeting set, a daily budget, and at least one approved creative. Activation waits on prepaid balance, the daily cap, the exchange's approval of the ad, and the landing-page checks. The agent reads readiness instead of retrying activate in a tight loop.

If the user wanted conversions as the goal, a conversion event must already exist, have a successful test fire, and be linked. Otherwise the goal stays delivery.

The agent reads impressions, spend, clicks, and conversions as separate columns. Provider clicks are the plural field. Snapshot rows used for wallet checks store clicks as zero. generated_at is local response time. freshness_status and the reporting sync timestamp are what decide whether a zero is real.

Do not lead with click-through rate; traffic is judged on real visits. Read performance without fooling yourself is the checklist.

To change the message, add an approved creative or replace the primary. To pause a weak variant, leave at least one active. The API rejects pause or remove of the final active creative. To change targeting or the offer without mixing the test, copy the campaign.

Webhooks exist for funded, balance-low, creative updates, activated, paused, URL changed, conversion received, and conversion attributed. Subscribe if the agent should wake on those events instead of polling forever.

That is the buy. If you are still connecting the assistant, go back to Connect your AI assistant and launch.