ZuckerBot

ZuckerBotTool referenceStrategy & campaign build

Recommend Campaign Structure

zuckerbot_recommend_campaign_structure

Generate a campaign structure recommendation: audience tiers, budget allocation, creative mix. For accounts WITH history: uses Claude to generate data-driven recommendations. For NEW accounts (cold start): generates conservative defaults from industry benchmarks + safe 2-tier structure (broad 60% / interest 40%). Always returns comparable_historical_cpl with source (account_history or industry_benchmarks) and a disclaimer — NEVER a CPL projection. Lead campaigns default to Meta Instant Form; for leads driving to a website landing page rather than Meta Instant Form, set lead_destination='website'. Present the recommendation to the customer for approval before proceeding.

Parameters

NameTypeDescription
business_idstringoptionalBusiness ID (auto-resolved from API key if omitted)
objective"leads" | "sales" | "traffic" | "awareness" | "engagement"optionalCampaign objective. If omitted, defaults to 'leads' for most SMB use cases. Leads default to Meta Instant Form unless lead_destination is 'website'.
lead_destination"meta_form" | "website"optionalFor objective='leads': 'meta_form' uses a Meta Instant Form (default), 'website' optimizes for the Pixel Lead event on a landing page.
destination_urlstringoptionalOptional landing-page URL for this campaign. Required/recommended for lead_destination='website'; overrides the business website for ad links.
target_audiencestringrequiredTarget audience description (e.g., 'pool builders in Texas', 'plumbers in Brisbane')
daily_budget_audnumberoptionalDaily budget in AUD. If omitted, defaults to $50/day.
history_digeststringoptionalOptional JSON string of a prior zuckerbot_analyse_account_history result. If omitted, history is pulled automatically.
constraintsobjectoptionalOptional constraints on the recommendation

Example call

{
  "tool": "zuckerbot_recommend_campaign_structure",
  "arguments": {
    "target_audience": "<target_audience>"
  }
}

You never invoke this directly — describe what you want in plain English inside Claude, Cursor, ChatGPT or any MCP client with ZuckerBot connected, and the agent selects zuckerbot_recommend_campaign_structure and fills the arguments for you.

Related tools — Strategy & campaign build

Connect ZuckerBot to your AI agent in about two minutes: get started free, browse the full tool reference, or grab the lifetime deal.