Ad Configuration
API Configuration Method
The API configuration method provides direct integration with Meta's advertising platform, offering real-time ad creation with complete control over creative enhancements and flexible text options.
Overview
The API method:
- Connects directly to your Meta account
- Allows browsing and selecting existing ads
- Creates ads immediately in your account
- Provides full control over all ad settings
- Supports multiple headlines and descriptions
Step 1: Select Source Ad
Three-Column Navigation
The API selector presents your account structure in three columns:
-
Campaigns (Left)
- Shows all campaigns in your account
- Filter by name or status
- Active campaigns shown by default
-
Ad Sets (Middle)
- Displays ad sets for selected campaign
- Shows budget and status
- Filter by name or active status
-
Ads (Right)
- Lists ads in selected ad set
- Shows ad names and status
- Click to select as template
Finding the Right Ad
Best practices for template selection:
- Choose recently created ads (within 30 days)
- Select high-performing ads
- Ensure ad has desired settings
- Verify placement configuration
Using Filters
Each column has filter options:
- Search box: Type to filter by name
- Active only: Toggle to show/hide paused items
- Keyboard navigation: Use arrows and Enter
Step 2: Configure Campaign Structure
Campaign Options
Use Existing Campaign
- Adds new ads to the selected campaign
- Inherits all campaign settings
- Maintains budget and schedule
Create New Campaign
- Generates fresh campaign with custom name
- Copies objectives and settings
- Independent budget control
Ad Set Configuration
Single Ad Set
- All ads go into one ad set
- Specify custom name
- Shares budget across all ads
Ad Set Per Upload
- Creates individual ad sets per file
- Use
{FileName}
placeholder for naming - Pattern example:
{FileName} - Q4 Campaign
Group Variations
When enabled:
- Set variation identifier (e.g.,
-v
or_test
) - Files with same base name group together
- Creates organized ad set structure
Step 3: Configure Ad Text (Advanced Features)
Multiple Headlines, Primary Texts & Descriptions
Unlike XLSX, the API method supports flexible creative:
Adding Multiple Options
- Click the blue plus (+) button to add variants
- Enter up to 5 headlines
- Add up to 5 primary text options
- Include up to 5 link descriptions
Removing Options
- Click the red X to remove specific variants
- Minimum of 1 required for each field
How Meta Uses Multiple Texts
- Meta automatically tests combinations
- Optimizes for best-performing variants
- Provides more placement flexibility
Individual Text Customization
For unique messaging per ad:
- Select "Write unique ad text for each ad"
- Customize per upload:
- Headlines (5 variants each)
- Primary texts (5 variants each)
- Link descriptions (5 variants each)
- Use Advanced Edit modal for bulk operations
Advanced Edit Modal
Access by clicking the pencil icon:
Features:
- Edit all text fields in one view
- Set website URLs and display links
- Choose call-to-action buttons
- Apply changes across all ads
- Preview text combinations
Step 4: Creative Enhancements Control
Full Enhancement Management
The API method provides complete control over Meta's automatic optimizations:
Available Enhancements
-
Standard Enhancements
- Automatic creative optimization
- Dynamic experiences
- Music additions
-
Advantage+ Creative
- Image templates
- Text improvements
- Artistic filters
-
Media Enhancements
- Video cropping
- Image animation
- Brightness/contrast adjustments
Configuration
- Checkboxes reflect current ad settings
- Toggle on/off as needed
- Changes apply to all created ads
- Real-time validation of compatibility
Step 5: Publication Options
Status Control
Live Mode (Default)
- Ads go live immediately after creation
- Enter Meta's review process
- Start delivering once approved
Paused Mode
- Creates ads in paused status
- Review before activating
- Useful for campaign preparation
- Manual activation required
Step 6: Create Ads
Initiation
- Click "Create Ads" button
- Confirm settings in popup
- Monitor progress in the progress bar