Documentation

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:

  1. Campaigns (Left)

    • Shows all campaigns in your account
    • Filter by name or status
    • Active campaigns shown by default
  2. Ad Sets (Middle)

    • Displays ad sets for selected campaign
    • Shows budget and status
    • Filter by name or active status
  3. 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:

  1. Set variation identifier (e.g., -v or _test)
  2. Files with same base name group together
  3. 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

  1. Click the blue plus (+) button to add variants
  2. Enter up to 5 headlines
  3. Add up to 5 primary text options
  4. 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:

  1. Select "Write unique ad text for each ad"
  2. Customize per upload:
    • Headlines (5 variants each)
    • Primary texts (5 variants each)
    • Link descriptions (5 variants each)
  3. 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

  1. Checkboxes reflect current ad settings
  2. Toggle on/off as needed
  3. Changes apply to all created ads
  4. 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

  1. Click "Create Ads" button
  2. Confirm settings in popup
  3. Monitor progress in the progress bar