AdLevel Documentation

AdLevel is an AI-powered Meta advertising platform that automates the entire campaign lifecycle. A team of specialized AI agents handles everything from launching campaigns with AI-generated creatives to ingesting real-time metrics, optimizing spend, detecting creative fatigue, and scaling winners.

At its core, AdLevel replaces the manual, time-consuming work of media buying with intelligent automation. Rather than spending hours adjusting bids, rotating creatives, and analyzing performance data, AdLevel's agents do this continuously, running optimization cycles around the clock.

The platform is built around the concept of Mission Control, your central command dashboard. From here you can see all active campaigns, monitor agent activity, review performance KPIs, and manage your advertising operations in one place.

AdLevel connects directly to Meta's Marketing API to read campaign data and push optimization changes. This means your campaigns are always managed with the most up-to-date performance data available, without any manual data syncing required.

Whether you're a solo operator running a single campaign or an agency managing multiple accounts, AdLevel scales to fit your workflow. The AI agents apply the same rigorous optimization logic regardless of your spend level.

Understanding a few key concepts will help you get the most out of AdLevel. These concepts underpin how the platform works and why it delivers results.

AI Agents are the engine of AdLevel. Each agent is specialized for a specific task: Athena handles campaign strategy and creation, Zenith ingests and processes live metrics, Stratos makes optimization decisions, and Vortex monitors creative health and fatigue. Together they form an automated media buying team.

Campaigns in AdLevel correspond directly to Meta campaigns. When you launch a campaign through AdLevel, it creates the campaign, ad sets, and ads in your connected Meta ad account. AdLevel then continuously manages these campaigns on your behalf.

Credits are the resource unit for AI operations. Every time an agent performs an action (analyzing metrics, making an optimization decision, or generating content) it consumes credits. Credits come in monthly refill packs included with your subscription, and permanent credit packs you can purchase separately.

Mission Control is your home dashboard. It provides real-time visibility into all active campaigns, recent agent actions, and urgent issues requiring your attention. Think of it as the bridge of a ship where everything important is visible at a glance.

The Meta Connection is required to use AdLevel. You connect your Meta Business Manager account via OAuth, which gives AdLevel the permissions it needs to read your campaign data and push optimization changes. The connection can be revoked at any time from Meta Business Settings.

This guide walks you through the fastest path from signing up to having a live, AI-managed campaign on Meta.

Step 1: Create Your Account Sign up at adlevel.ai and complete the onboarding flow. You'll be prompted to choose a subscription plan and provide billing information. Once your subscription is active, you'll land in Mission Control.

Step 2: Connect Your Meta Account Navigate to Settings and open the Ad Accounts tab. Click Connect Meta to begin the OAuth flow. You'll be redirected to Facebook to grant AdLevel the requested permissions. These are required to read your campaign data and manage your ads. After authorizing, select the specific ad account you want AdLevel to manage.

Step 3: Launch Your First Campaign Click Launch Campaign in the sidebar to open Athena, the AI campaign assistant. Athena guides you through a conversational setup flow: choosing your objective (Leads or Sales), selecting your Facebook Page and Pixel, setting your targeting and budget, and choosing or generating ad creatives.

Step 4: Review and Confirm Athena will present a campaign summary for your review before anything goes live. Once you confirm, the campaign is created in Meta and the AI agents begin their first optimization cycle within minutes.

Step 5: Monitor in Mission Control Return to Mission Control to watch the campaign come to life. You'll see real-time KPIs, agent activity, and campaign health indicators. The agents run optimization cycles regularly, so you'll start seeing data-driven adjustments quickly.

Your campaign is now live and being continuously optimized by AI. From here, explore Ads Manager for detailed campaign management, or check the Analytics section for deeper performance insights.

Creating an AdLevel account is straightforward. Visit adlevel.ai and click Get Started to begin the signup flow.

Email and Password Enter your email address and choose a strong password. AdLevel uses secure authentication with email verification. After signup, check your inbox for a confirmation email and click the link to verify your address.

Onboarding Flow After email verification, you'll complete a brief onboarding survey. This helps AdLevel understand your advertising goals and configure initial settings appropriately. The onboarding typically takes 2-3 minutes.

Subscription Activation AdLevel requires an active subscription to use. After onboarding, you'll be directed to choose a plan. Select the plan that matches your needs. All plans include a monthly credit refill. Enter your payment information to activate your subscription.

First Login Once your subscription is active, you'll land in Mission Control. At this point, your account is ready. The next step is connecting your Meta ad account. See the Connecting Meta guide for instructions.

If you encounter any issues during signup, email support@adlevel.ai with your account email and a description of the problem. Our team typically responds within 24 hours.

AdLevel requires a Meta Business Manager connection to manage your ad campaigns. This connection is established via Meta's OAuth flow, which is secure and can be revoked at any time.

Starting the Connection Navigate to Settings in the sidebar, then open the Ad Accounts tab. Click Connect Meta to begin the OAuth flow. You'll be redirected to Facebook.

Meta Permissions AdLevel requests the following Meta permissions: ads_management (to create and manage campaigns), ads_read (to read campaign metrics), business_management (to access your Business Manager), and pages_read_engagement (to read your Page data). All permissions are required for full functionality.

Selecting Your Ad Account After granting permissions, you'll be returned to AdLevel and prompted to select which ad account to manage. If you have access to multiple ad accounts under your Business Manager, all eligible accounts will be listed. Select the one you want AdLevel to manage.

Multiple Ad Accounts You can connect multiple ad accounts and switch between them using the account selector in the sidebar. Each account's campaigns are managed independently by the AI agents.

Revoking Access To revoke AdLevel's access to Meta, go to your Meta Business Settings, find Apps, and locate AdLevel in the list. Click Remove to revoke all permissions. Note that this will stop all AI agent activity on your campaigns.

Mission Control is the central hub of AdLevel. It gives you a real-time view of everything happening across your campaigns and AI agents, all from a single screen.

KPI Cards At the top of Mission Control are four KPI cards: Active Campaigns (total campaigns currently running), Agent Actions Today (number of optimization actions taken in the last 24 hours), Agents Online (how many AI agents are currently active), and Urgent Issues (campaigns requiring your attention).

Campaign Status Bar Below the KPI cards is a visual distribution bar showing the breakdown of your campaigns by status: Active, Paused, Needs Attention, and Completed. This gives you a quick health check of your entire portfolio.

Campaign Table The main section of Mission Control is the live campaign table. Each row represents one campaign and shows its name, status, budget, key performance metrics, and a health indicator (green/yellow/red traffic light). Click any campaign row to expand a detail panel.

Detail Panel The expanded campaign detail panel shows the campaign's latest metrics, recent optimization history (what actions agents took and when), and live agent activity. This is where you can see exactly what the AI is doing and why.

Auto-Refresh Mission Control refreshes automatically. You don't need to manually reload the page to see the latest data. A subtle pulse indicator in the top bar shows when a refresh occurred.

The Campaign Dashboard provides a deep dive into individual campaign performance. Access it by clicking on any campaign in Mission Control and then clicking View Full Campaign.

Performance Charts The dashboard displays time-series charts for your most important metrics: spend, results (leads or conversions), cost per result, CTR, and ROAS. Charts default to the last 7 days but can be adjusted to show 24 hours, 30 days, or a custom date range.

Ad Set Breakdown Below the charts, a table shows performance broken down by ad set. This lets you identify which targeting configurations are performing best and which need adjustment. Each ad set row expands to show its constituent ads.

Creative Gallery The creative gallery shows all ads in the campaign with their performance metrics. Active ads are shown with their current status, spend share, and key metrics. Paused ads show why they were paused (agent decision, manual pause, or creative fatigue).

Agent Activity Log A full chronological log of every agent action taken on this campaign is available at the bottom of the dashboard. Each entry shows the timestamp, agent name, action taken, and the data that triggered the action. This transparency lets you understand and learn from how the AI manages campaigns.

Export Campaign data can be exported to CSV for use in external reporting tools. Click the Export button in the top right of the dashboard to download a full data export including all metrics and agent actions.

AdLevel provides comprehensive analytics across all your campaigns. The Analytics section aggregates data from Meta's API and enriches it with insights from the AI agents.

Metrics Overview AdLevel tracks the following metrics for all campaigns: Spend, Impressions, Reach, Frequency, Clicks, CTR (Click-Through Rate), CPC (Cost Per Click), CPM (Cost Per Thousand Impressions), Results (leads or conversions), CPR (Cost Per Result), ROAS (Return on Ad Spend), and Landing Page Views.

Cohort Analysis Group campaigns by date range, objective, or performance tier to identify patterns. The cohort view helps you understand what types of campaigns perform best for your business and when.

Attribution AdLevel uses Meta's default attribution settings (7-day click, 1-day view) for all reporting. These can be adjusted in campaign settings to match your preferred attribution model.

Scheduled Reports Set up scheduled reports to receive performance summaries via email on a daily, weekly, or monthly basis. Reports include an executive summary, top performers, and any urgent issues identified by the agents.

Data Retention AdLevel retains all campaign data and agent activity logs for the lifetime of your account. Historical data is always accessible, even for campaigns that are no longer active.

Creating a campaign in AdLevel is done through Athena, the AI campaign assistant. Athena guides you through every decision with context-aware suggestions based on your goals.

Starting a Campaign Click Launch Campaign in the sidebar to open Athena. Athena will greet you and ask about your campaign objective. Choose Leads if you want to collect contact information, or Sales if you're driving direct purchases or app events.

Campaign Configuration After setting your objective, Athena walks you through: selecting your Facebook Page, choosing your Meta Pixel (required for conversion tracking), defining your target audience (location, age range, interests, and exclusions), and setting your daily or lifetime budget.

Creative Selection You can upload existing creatives or ask Athena to generate AI creatives for you. Having multiple creative angles from day one gives the AI agents maximum flexibility for testing and optimization.

Review and Launch Before anything goes live, Athena presents a full campaign summary for your review. You can edit any setting before confirming. Once confirmed, AdLevel creates the campaign in Meta and the AI agents begin monitoring it immediately.

Campaign Naming AdLevel automatically names your campaign, ad sets, and ads according to a consistent naming convention. This keeps your Meta Business Manager organized and makes it easy to identify AdLevel-managed campaigns.

Campaign creation in AdLevel is a conversational experience powered by Athena. It transforms the typically complex campaign setup process into a guided conversation.

Conversational Flow Unlike traditional form-based campaign creation, Athena uses natural language. She asks questions, interprets your answers, and proactively fills in campaign settings based on your responses. You can ask Athena questions at any point in the flow and she will provide context-appropriate explanations.

Intelligent Defaults Athena applies intelligent defaults based on your campaign objective, budget, and target audience. For example, if you're running a lead generation campaign for a service business, Athena will recommend appropriate audience ages, bid strategies, and creative formats based on what performs well for similar campaigns.

Budget Recommendations Based on your target audience size and competition in your niche, Athena provides a recommended budget range. These recommendations are based on Meta's estimated reach data and internal benchmarks from similar campaigns.

Creative Generation The creative generation feature uses AI image generation to create Meta-compliant ad images. Athena generates variations across multiple psychological hooks, ensuring you start with a diverse creative set.

Campaign Preview Before launch, Athena renders a preview of exactly how your ads will appear in the Facebook News Feed, Stories, and Reels placements. This helps you catch any creative issues before spending budget.

Budget management is one of AdLevel's most powerful features. The AI agents can automatically scale budgets when performance warrants it, but always within defined guardrails.

Budget Scaling AI agents can increase a campaign's daily budget up to a defined cap based on the original launch budget. This prevents runaway spend while still allowing meaningful scaling of winners.

Performance Requirements Before scaling a budget, the system requires multiple consecutive days of strong performance. This prevents premature scaling based on a single good day.

Gradual Increases Budget increases happen gradually, never in a single jump. The AI increases budgets in measured increments to avoid resetting Meta's learning phase. Rapid budget changes can disrupt Meta's delivery optimization, so AdLevel takes a conservative approach.

Budget Approval Certain budget changes require your explicit approval. These are shown as budget approval requests in Mission Control. You'll see the current budget, proposed new budget, the performance data justifying the change, and approve/reject buttons. Approvals can also be managed via email notification.

Budget Decreases The AI will also decrease budgets when performance deteriorates. If key metrics decline below acceptable thresholds, the system reduces spend to limit losses while the situation is investigated and addressed.

Effective audience targeting is critical to campaign performance. AdLevel provides flexible targeting options while the AI agents optimize delivery within your defined audience parameters.

Geographic Targeting Target by country, state/province, city, or a radius around a specific location. You can include multiple locations or exclude specific areas. AdLevel supports all geographic targeting options available in Meta Ads Manager.

Demographic Targeting Set age ranges and gender targeting for your campaigns. AdLevel recommends keeping age ranges broad (especially for cold audiences) to give the AI delivery algorithm more flexibility to find your best-performing segments.

Interest Targeting Add interests to target Facebook users who have shown interest in specific topics, brands, or activities. Athena suggests relevant interests based on your campaign objective and niche.

Custom Audiences Upload your own customer lists or connect your website pixel to create retargeting audiences. Custom audiences typically perform better than cold interest-based audiences and should be part of any mature advertising strategy.

Lookalike Audiences Create lookalike audiences based on your best customers or website visitors. Meta identifies users who share characteristics with your source audience. Lookalike audiences at 1-3% size tend to perform best for most advertisers.

Exclusions Exclude existing customers, recent converters, or specific demographics from seeing your ads. Proper exclusions prevent wasted spend on audiences unlikely to convert and reduce ad fatigue for users who have already taken action.

AdLevel is powered by Athena, a conversational AI that helps you with every aspect of advertising — from campaign creation and strategy to performance questions and optimization guidance. Behind the scenes, five specialized subagents run autonomously in Mission Control to manage your launched ads around the clock.

The five subagents are: Aurelius (Traffic Commander — launches and enrolls campaigns), Vortex (Creative Architect — reviews creative structure and detects fatigue), Nexus (Tracking Specialist — verifies ads are live), Zenith (Metrics Analyst — tracks performance data), and Stratos (Strategy Advisor — optimizes for results). They run on a continuous cycle: Zenith ingests the latest metrics from Meta's API, Stratos analyzes the data and makes decisions, Vortex checks creative health, and any approved actions are executed via Meta's API. This cycle runs 24/7.

The subagents share a common data layer so decisions are coordinated. Stratos considers Vortex's creative fatigue scores when making budget decisions, and Zenith's metric data informs the optimization cycle. All agent decisions can be reviewed and overridden by you at any time. Budget approval flows give you explicit control over significant spend changes, and you can pause agent activity on any campaign from Mission Control.

Athena is AdLevel's conversational AI that helps you with every aspect of advertising. She handles guided campaign creation, AI-powered creative generation, campaign strategy recommendations, and answering questions about your campaigns and ad performance.

When you launch a campaign, Athena orchestrates the entire creation process: collecting your requirements through conversation, validating your inputs, generating or processing your creatives, and creating all campaign objects in Meta's API. She is accessible via the chat interface in the Launch Campaign sidebar, where you can also ask questions, request performance summaries, and discuss strategy.

Aurelius is AdLevel's Traffic Commander, responsible for launching new campaigns and enrolling existing ones into the agent management system. When Athena finishes building a campaign, Aurelius handles the handoff — executing the launch sequence in Meta's API and confirming everything is live.

Aurelius also manages campaign enrollment, where existing Meta campaigns are brought under AdLevel's agent management. He handles alert notifications and agent takeover workflows, ensuring smooth transitions when campaigns move from manual to AI-managed.

Zenith is AdLevel's data ingestion agent, responsible for pulling live metrics from Meta and making them available to the rest of the agent system. On each cycle, Zenith collects spend, impressions, reach, frequency, clicks, CTR, CPC, CPM, results, CPR, ROAS, landing page views, and video metrics at the campaign, ad set, and ad levels.

Zenith maintains a rolling performance baseline for each campaign based on historical data. When current metrics deviate significantly from the baseline, Zenith flags the anomaly for Stratos to investigate. This helps distinguish normal day-to-day variance from genuine performance changes.

Stratos is the optimization decision engine that analyzes metric data from Zenith and determines what actions should be taken to improve campaign performance. Stratos handles analyzing performance data, deciding which ads to pause or activate, adjusting budgets within policy limits, and prioritizing high-performing ad sets.

When running multiple ad sets, Stratos reallocates budget toward the best performers. Rather than pausing underperforming ad sets (which resets learning), Stratos adjusts budget shares while maintaining data collection on all segments. Every Stratos decision is logged with the specific metrics that triggered it, making the optimization process fully auditable in your Campaign Dashboard.

Vortex is the creative health agent, specialized in monitoring ad creative performance over time and identifying when creatives are becoming fatigued. Vortex watches for fatigue signals including rising frequency, CTR decline over time, and cost per result degradation.

Each active creative receives a health score. When Vortex detects widespread creative fatigue in a campaign, it generates a creative refresh recommendation that appears in Mission Control and the Campaign Dashboard. Vortex also analyzes which creative hooks maintain performance longest, passing these insights to Athena to inform future creative generation.

Nexus is AdLevel's Tracking Specialist, responsible for verifying that ads are live and properly published on Meta. After Aurelius launches a campaign, Nexus confirms that all campaign objects — campaigns, ad sets, and ads — are active and delivering in Meta's system.

Nexus monitors the publishing pipeline to catch any issues that might prevent ads from going live, such as policy rejections, billing problems, or technical errors. When an issue is detected, Nexus surfaces it in Mission Control so you can take action quickly.

Following these best practices will help you maximize the effectiveness of AdLevel's AI agents and get better results from your ad campaigns.

Start with Sufficient Budget The AI agents need enough data to make good decisions. We recommend starting with at least $50/day per campaign. Campaigns with very low budgets collect data slowly, making it harder for the agents to identify patterns and optimize effectively.

Use Multiple Creatives Always launch campaigns with multiple creative variations. The more angles you test initially, the better the agents can identify what resonates with your audience.

Define Clear Conversion Goals Connect your Meta Pixel and ensure conversion events are firing correctly before launching. The AI agents optimize toward your conversion goal, so if conversions aren't being tracked properly, the agents are optimizing toward the wrong signal.

Give Campaigns Time to Learn The first 7 days of a campaign are a learning period. During this time, performance metrics are volatile and optimization decisions are exploratory. Avoid making manual changes during this window as it can interfere with the learning process.

Monitor, Don't Micromanage One of the biggest benefits of AdLevel is freeing you from constant campaign monitoring. Check Mission Control once or twice a day rather than hourly. Trust the agents to handle routine optimizations and save your attention for strategic decisions.

Refresh Creatives Proactively Don't wait for critical fatigue to be flagged. Schedule creative refreshes every 4-6 weeks for high-spend campaigns. Fresh creatives maintain engagement and give the agents new material to test.

Migrating existing campaigns to AdLevel management requires some planning to avoid disrupting their performance. Follow this guide for a smooth transition.

Before You Start Export a baseline performance report from Meta Ads Manager covering the last 30 days. This gives you a benchmark to compare against after migration. Note the campaigns' current CPR, CTR, daily spend, and ROAS.

Connecting Existing Campaigns AdLevel can import and begin managing existing Meta campaigns. Navigate to Campaigns and select the campaigns you want to import. AdLevel reads the campaign structure, ad sets, ads, and historical performance data.

Learning Period When AdLevel takes over management of an existing campaign, there's a calibration period where the agents learn the campaign's historical performance patterns before making optimization decisions. During this period, expect minimal automated changes.

Gradual Handover For high-spend campaigns, consider a phased approach: import the campaign but keep it in monitor-only mode for the first week (agents observe but don't take action). Review the agents' recommendations before enabling full automation.

Common Issues If performance drops after migration, check: (1) that all conversion events are still firing correctly on your pixel, (2) that the campaign's target CPR is set appropriately for your historical performance, (3) that no manual changes were made during the learning period.

Rolling Back If needed, you can disconnect a campaign from AdLevel management at any time. The campaign continues running in Meta, and AdLevel simply stops making optimization decisions. All historical changes made by AdLevel remain in place unless you manually revert them in Meta Ads Manager.

This guide covers the most common issues AdLevel users encounter and how to resolve them.

Meta Connection Issues If your Meta connection shows as disconnected or expired, navigate to Settings and click Reconnect Meta. Meta access tokens expire periodically and require re-authorization. This is normal and not a sign of a problem with your account.

Missing Conversion Data If conversions aren't appearing in AdLevel's analytics, check: (1) that your Meta Pixel is installed correctly on your website, (2) that the conversion event is configured in Meta Events Manager, (3) that the attribution window matches your campaign settings. Use Meta's Pixel Helper browser extension to diagnose pixel issues.

Agent Actions Not Appearing If the Agent Activity Log shows no recent actions, check: (1) that at least one campaign is active and has been running for more than 24 hours, (2) that your subscription is active and your credit balance is above zero, (3) that the campaign wasn't recently paused (agents only act on active campaigns).

Low Credit Balance If your credit balance is near zero, agents will stop taking actions. Purchase a credit pack from Settings to restore agent activity.

Performance Drops After Agent Action If performance drops after an agent takes action, give the campaign 24-48 hours to stabilize. Meta's delivery algorithm recalibrates after significant changes, causing short-term performance fluctuations. If performance hasn't recovered after 48 hours, review the specific action in the Agent Activity Log and consider reverting it manually.

Contacting Support If you can't resolve an issue using this guide, email support@adlevel.ai with: your account email, the affected campaign ID (found in the Campaign Dashboard URL), a description of the issue, and the approximate time the issue started.

Can I use AdLevel without a Meta Pixel? You can launch campaigns without a Pixel, but we strongly recommend installing one. Without a Pixel, the AI agents can only optimize toward click-based metrics (CTR, CPC) rather than true business outcomes (leads, purchases). This significantly limits the effectiveness of the optimization engine.

Does AdLevel work for Instagram ads? Yes. When you create campaigns in AdLevel, they run on both Facebook and Instagram by default (Meta's automatic placements). You can also configure placement-specific targeting to run on Instagram only or Facebook only from the campaign settings.

What happens if I run out of credits? When your credit balance reaches zero, the AI agents pause their optimization cycles. Your campaigns continue running on Meta, they just won't receive automated optimization updates. Purchase a credit pack to restore agent activity. You'll receive email notifications as your balance approaches zero.

Can I have multiple users on one AdLevel account? Team access is available on higher-tier plans. Each team member can have their own login with configurable permissions. Contact sales@adlevel.ai about team pricing if you need multiple seats.

How is AdLevel different from running campaigns directly in Meta Ads Manager? Meta Ads Manager requires manual optimization where you check performance, make decisions, and implement changes yourself. AdLevel automates this entirely. The AI agents run continuous optimization cycles versus the once-a-day (or less) frequency most advertisers manually optimize. This means faster learning, less budget waste, and more consistent performance.

What ad formats does AdLevel support? Currently AdLevel supports single image ads and video ads for Traffic, Leads, and Sales objectives. Carousel ads, Collection ads, and Stories-specific placements are on the roadmap.

AdLevel's support team is available via email and typically responds within 24 business hours. For urgent issues, flag your email as urgent and we'll prioritize it.

Email Support Send all support requests to support@adlevel.ai. Include the following information to help us resolve your issue quickly: your account email address, the campaign ID if relevant (found in the URL when viewing a campaign), a clear description of the issue, any error messages you're seeing, and the approximate time the issue started.

Providing Screenshots Screenshots are extremely helpful for UI issues. Include a screenshot showing the problem if possible. For performance issues, a screenshot of the Campaign Dashboard showing the metric in question is ideal.

Response Times Standard support requests: response within 24 business hours. Billing issues: response within 12 business hours. Service outages: check our status page at status.adlevel.ai for real-time updates.

Feature Requests We actively track feature requests. If you have a suggestion for improving AdLevel, include "Feature Request:" at the start of your email subject line. Popular feature requests are incorporated into our roadmap.

Billing Support For billing questions, subscription changes, or refund requests, email billing@adlevel.ai. Please include your account email and describe the billing issue or request.

March 2026

v1.0.0 - Official Launch - Athena conversational AI that helps with all aspects of advertising — campaign creation, strategy, performance questions, and optimization guidance - Five autonomous subagents in Mission Control: Aurelius (Traffic Commander), Vortex (Creative Architect), Nexus (Tracking Specialist), Zenith (Metrics Analyst), and Stratos (Strategy Advisor) - Conversational campaign creation powered by Athena with intelligent defaults and AI-generated creatives - Mission Control real-time dashboard with campaign health indicators and agent activity feed - Ads Manager with three-tier campaign/ad set/ad hierarchy, custom columns, and bulk operations - AI creative generation with multiple psychological hook categories - Automated budget scaling with approval flows and performance guardrails - Credit system for AI operations with monthly refills and purchasable packs - Impact calculator with niche benchmark library - Comprehensive analytics with time-series charts and exportable reports