Taboola Campaign Launcher

End-to-end Taboola native ad campaign creation with AI-generated creative assets.

Quick Start

/launch-taboola vertical:mortgage brief:"Florida homeowners paying 7%+ rates" everflow-offer-ids:"654"

Result: PAUSED campaign with 100 ad items (10 headlines × 10 images), 3 landing page styles, full RedTrack tracking.

Workflow Overview

5-phase orchestrator pattern with parallel subagent execution:

Phase 1: Creative Generation (PARALLEL)
├── headline-generator    → 10 headlines from proven formulas
├── image-generator       → 10 images via Gemini
└── lander-generator      → 3 styles via Presales

Phase 2: Asset Upload (PARALLEL)
├── taboola-uploader      → Images to Taboola CDN
└── ftp-uploader          → Landers to FTP

Phase 3: Tracking Setup (SEQUENTIAL)
└── redtrack-setup        → Offers + landers + campaign → trackback_url

Phase 4: Campaign Creation (SEQUENTIAL)
├── taboola-campaign      → Create PAUSED campaign
└── item-matrix           → 100 items (headlines × images)

Phase 5: Save & Report
└── manifest + summary with unpause instructions

IMPORTANT: Campaigns are ALWAYS created PAUSED. Run /taboola-unpause {id} to activate.

Required Parameters

| Parameter | Description | Example | |-----------|-------------|---------| | vertical | Target vertical | mortgage | | brief | Creative angle/targeting | "Florida homeowners paying 7%+" | | everflow-offer-ids | Offer ID(s), comma-sep | "654" or "654,655" |

Optional Parameters

| Parameter | Default | Description | |-----------|---------|-------------| | --daily-cap | 50.0 | Daily budget cap in USD | | --cpc | 0.35 | Cost per click | | --num-variations | 10 | Headlines and images to generate | | --landing-ids | (generate) | Use existing RedTrack lander IDs | | --dry-run | false | Preview without creating |

Execution

Read workflows/orchestrator.md for the complete 5-phase workflow.

Phase 1: Creative Generation

Dispatch 3 subagents IN PARALLEL using Task tool:

1. headline-generator - See workflows/subagents/headline-generator.md
2. image-generator - See workflows/subagents/image-generator.md
3. lander-generator - See workflows/subagents/lander-generator.md

Timeout: 5 minutes. Minimum: 1 headline, 1 image.

Phase 2: Asset Upload

Dispatch 2 subagents IN PARALLEL:

1. taboola-uploader - tb_upload_image_from_url for each image
2. ftp-uploader - presales_ftp_upload for landers

Phase 3: Tracking Setup

SEQUENTIAL - requires lander URLs from Phase 2:

1. Look up existing offers with rt_lookup_offer
2. Create offers if needed with rt_setup_regular_offer
3. Register landers with rt_create_lander
4. Create campaign with rt_create_campaign_v2
5. Get trackback_url for Taboola items

Phase 4: Campaign Creation

SEQUENTIAL:

1. Create campaign PAUSED with tb_create_campaign
2. Create item matrix with tb_create_items_batch (headlines × images)

Phase 5: Save & Report

1. Save manifest to outputs/taboola-campaigns/{campaign_id}.json
2. Return summary with all URLs and IDs
3. Include: "Run /taboola-unpause {campaign_id} to activate"

Configuration

Media Buyers

Read config/media-buyers.json for Everflow affiliate mappings.

Vertical Config

Read config/mortgage.json for:

• Default CPC, daily cap, bid strategy
• Proven headline angles and formulas
• Image templates for Gemini
• Compliance rules

Related Commands

| Command | Purpose | |---------|---------| | /taboola-unpause {id} | Activate paused campaign | | /taboola-pause {id} | Pause running campaign | | /taboola-status {id} | Get performance metrics |

MCP Tools Reference

See references/mcp-tools.md for complete tool documentation.

Key Tools:

• tb_create_campaign, tb_create_items_batch, tb_upload_image_from_url
• rt_setup_regular_offer, rt_create_lander, rt_create_campaign_v2
• presales_generate, presales_ftp_upload
• gemini_batch_generate

Error Handling

| Phase | If Fails | Action | |-------|----------|--------| | Headline gen | Retry once | Continue with fewer headlines | | Image gen | Retry once | Continue with fewer images | | Lander gen | Retry once | Skip landers, direct to offer | | Upload | Retry once | Flag failed assets | | Tracking | Critical | Abort, save partial state | | Campaign | Critical | Abort, save partial state |

Output

Campaign manifest saved to outputs/taboola-campaigns/{campaign_id}.json:

{
  "campaign_id": "123456",
  "status": "PAUSED",
  "vertical": "mortgage",
  "brief": "...",
  "created_at": "2025-01-26T...",
  "taboola": {
    "campaign_id": "123456",
    "items_created": 100
  },
  "redtrack": {
    "campaign_id": "abc123",
    "trackback_url": "https://...",
    "offer_ids": ["..."],
    "lander_ids": ["..."]
  },
  "assets": {
    "headlines": [...],
    "images": [...],
    "landers": [...]
  }
}