Skip to content
Get started

Your first campaign

Paste one launch brief into your assistant, or follow the same steps in the dashboard. Either way it is the same account, the same prepaid balance, and the same review.

Updated
On this page

The path

  1. Add the connector URL to your assistant, or open the dashboard.
  2. Sign in with your email and allow the connection.
  3. Gather targeting, the ad, the budget, and the landing page.
  4. Fund, launch, rotate ads, measure, and subscribe to lifecycle webhooks.

Launch with your assistant

The launch brief

The full map in one message: the connector, the dashboard, the API, funding, ads, campaign setup, reporting, and webhooks. Add your own lines for the website, the one promise, the geography, and the daily budget. Shorter prompts for each app are in the launch prompts.

Launch brief
Help me use Adprime Zero to launch and manage an ad account.

Product links:
Dashboard signup: https://adprimezero.com/signup
Docs: https://adprimezero.com/docs
REST API reference: https://adprimezero.com/docs/quickstart
Tool reference: https://adprimezero.com/docs/reference/tools
Production API:
https://api.adprimezero.com

Connect (best first):
1. Remote MCP: add https://mcp.adprimezero.com/mcp as a connector or MCP server and sign in when asked. I approve it in my browser; there is nothing to install. Setup per client: https://adprimezero.com/docs/mcp
2. Scripts that cannot open a browser: send an API key from https://adprimezero.com/dashboard/settings/developers as "Authorization: Bearer ak_..." to the same URL, or call the REST API directly.
3. Dashboard for browser setup, account review, billing handoff, and human-facing status.

Collect the launch inputs:
- Company website and landing page.
- What I want to advertise and who should see it.
- Prepaid budget.
- Image ad or source image assets.
- Campaign name, geography, audience notes, and daily budget.

Use the account:
- Create or connect the account through the connector sign-in or the dashboard.
- If you use an API key, keep it in your secret store and never print it.
- Read account state, balance, funding intents, creative status, campaigns, and performance.
- Request a hosted prepay link when the account needs budget.
- Pre-check the landing page and destination summary.
- Submit creative assets with headline, description, click URL, expected content, and disclosure.
- Discover real audience segments with discover_segments or /targeting/reference/segments when I ask for audience targeting. Use returned ids, not names, and show estimated data CPM before creating targeting.
- Create targeting, create the campaign, review readiness, and activate when ready.
- Manage campaign creatives through the public surface when iterating: list campaign creatives, add approved variants, replace a primary creative, pause/resume one creative, remove a creative, or copy a campaign. Do not bypass the public surface with direct database or ad-platform writes.
- Set up conversion events when you care about downstream results: Dashboard Tracking or the conversion tools.
- Report spend, impressions, clicks, conversions, cost per conversion, and ROAS (as a multiple, like 2.5x) when events are linked. Judge results on conversions and cost per conversion, not on click-through rate.
- Reporting freshness: the time you read a report is not the time its numbers were last updated, and delivery reporting runs about two hours behind. list_campaign_performance and get_campaign_performance return freshness_status, metric_sources, and warnings; read them before concluding a campaign had no clicks.
- Conversion signal: get_campaign_conversion_signal gives goal conversions, cost per conversion, and attribution confidence for one campaign.
- Supply audit: get_supply_audit_status and list_supply_audit_flags show placements and sites that spent without bringing real visitors.
- Subscribe webhooks for account.funded, account.balance_low, creative updates, campaign.activated, campaign.paused, url.changed, conversion.received, and conversion.attributed.


Launch order (MCP tool names):
1. get_account; if the balance is zero, request_prepay_link and give me the link.
2. pre_check_creative, submit_creative, then get_creative until approved.
3. discover_segments when I ask for an audience, then create_targeting.
4. create_campaign, then activate_campaign.
5. list_campaign_performance to report, get_campaign_conversion_signal for conversions, list_supply_audit_flags for wasted supply; pause_campaign, resume_campaign, add_campaign_creative, replace_campaign_creative, and copy_campaign to iterate.

What your assistant does

  1. Reads the account with get_account and its own tool list.
  2. Gathers the campaign inputs: landing page, budget, audience, and the ad.
  3. Requests a payment link if the balance is empty. You pay in your browser; it checks the funding status and the new balance.
  4. Pre-checks the landing page, submits the ad, creates targeting, and creates the campaign.
  5. Activates with activate_campaign, which refuses and lists what is missing until the ad, the landing page, and the balance are ready.
  6. Reads performance and subscribes to webhooks for what happens next.

Launch in the dashboard

Prefer to click? Open the dashboard, enter your email code, and follow the same guided setup without an assistant.

  1. Open an account with a six-digit email code.
  2. Add your company profile and what you want to advertise.
  3. Add prepaid budget on the hosted payment page.
  4. Upload your ad and landing page, then launch when it is ready.

What you can do after that

  • Create or connect the account

    Add the connector URL to your assistant and sign in, or start in the dashboard. New emails get an account on the spot.

  • Add prepaid budget

    Request a hosted prepay link, open the browser handoff, then check the funding status and the account balance.

  • Run it from Claude, ChatGPT, or Cursor

    One connector URL gives your assistant every tool. Scripts can use an API key and the REST API instead.

  • Run the full ad workflow

    Prepare targeting, pre-check landing pages, submit ads, create campaigns, rotate ads, activate, measure, and subscribe to webhooks.

When a call fails

Read the error before rewriting anything. Each kind of refusal needs a different fix:

  • 401 or no tools. The connection was revoked or never finished. Sign in again. If the assistant cannot see tool names like get_account, fix the connection before you debug anything else.
  • A refusal about prepaid balance. A wallet problem, not an ad problem. Request a payment link.
  • Activation refused. The response lists what is missing: the ad's approval, the landing page's approval, or balance. Wait for review rather than retrying in a loop.
  • Anything else. Keep the request id from the response before you change targeting, so the cause can be traced.

The REST API reference lists the refusals in more detail.

Checklist

The connection works when the assistant can read the account, request a payment link, submit an ad, create targeting, and read performance with its freshness fields. Summarizing the homepage does not count.

Checklist
[ ] Connector added: https://mcp.adprimezero.com/mcp
[ ] Signed in with the emailed code and clicked Allow
[ ] Tool list visible (get_account, activate_campaign)
[ ] Assistant told: request payment links, never collect cards
[ ] Assistant told: use only the ids Adprime Zero returns