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

Optional Parameters

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

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

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": [...]
  }
}