Ad Creative To Meta

Listing → Meta Ad Pipeline

End-to-end pipeline: App Store listing → Appeeky creative → Meta draft ad (PAUSED). User reviews tracking and creative before activation.

Automate the tedious steps. Never auto-activate without explicit user approval and verified MMP events.

Prerequisites Checklist

Copy code
meta_ads_credentials_status

If not connected:

Copy code
meta_ads_oauth_start

Pipeline Overview

Preferred path — one-shot PAUSED app-install draft:

Copy code
1. generate_app_ad_creative  →  imageUrl + copy
2. meta_ads_upload_ad_image_from_url  →  image_hash
3. meta_ads_list_advertisable_applications + meta_ads_list_pages
4. meta_ads_create_app_install_draft  →  campaign + ad set + creative + ad
5. User review  →  manual activate

Manual path (when you need a shared ad set for multiple variants):

Copy code
1. generate_app_ad_creative  →  imageUrl + copy
2. meta_ads_upload_ad_image_from_url  →  image_hash
3. meta_ads_create_campaign  →  campaign_id (if new)
4. meta_ads_create_adset  →  adset_id  (destination_type: APP)
5. meta_ads_create_creative  →  creative_id  (format: app_install, name required)
6. meta_ads_create_ad  →  ad_id
7. User review  →  manual activate

All entities created PAUSED. Writes cost 2 Appeeky API credits each.

Step 1 — Generate Creative

Single creative or batch from prior skills:

Copy code
generate_app_ad_creative
  app_url: "https://apps.apple.com/us/app/id123456789"
  mode: "generate"
  style: "ugc"
  image_preset: "person_holding_phone"
  quality: "medium"

Poll:

Copy code
get_app_ad_creative_job
  job_id: "<job-id>"

Save:

• result.ad.imageUrl
• result.ad.copy.primaryText
• result.ad.copy.headline
• result.ad.copy.description
• result.ad.copy.callToAction

For batches (ad-creative-variants), repeat upload + ad creation per variant.

Step 2 — Upload Image to Meta

Copy code
meta_ads_upload_ad_image_from_url
  ad_account_id: "act_1234567890"
  image_url: "https://cdn.appeeky.com/..."

Returns image_hash (or imageHash) — use in creative step.

Preferred path by monetization

MCP default for meta_ads_create_app_install_draft is APP_INSTALLS. That is wrong for subscription/IAP apps — Meta will optimize for cheap installs, not paying users.

The one-shot tool does not accept custom_event_type on promoted_object. Use the manual ad set when optimizing to Purchase or Subscribe.

Use the manual campaign → ad set → creative → ad steps when attaching multiple variants to one shared ad set.

Step 3 — Create Campaign (if new)

Skip if adding ads to existing test campaign — use known campaign_id.

Copy code
meta_ads_create_campaign
  ad_account_id: "act_1234567890"
  name: "FocusApp - App Installs - US"
  objective: "OUTCOME_APP_PROMOTION"
  status: "PAUSED"
  is_adset_budget_sharing_enabled: false

Campaign Settings Reference

List existing:

Copy code
meta_ads_list_campaigns
  ad_account_id: "act_1234567890"

Step 4 — Create Ad Set

Copy code
meta_ads_create_adset
  ad_account_id: "act_1234567890"
  campaign_id: "<campaign-id>"
  name: "US - iOS - Creative Test"
  daily_budget_minor: 5000
  billing_event: "IMPRESSIONS"
  optimization_goal: "OFFSITE_CONVERSIONS"
  destination_type: "APP"
  promoted_object: {
    "application_id": "<meta-app-id>",
    "object_store_url": "https://apps.apple.com/us/app/id123456789",
    "custom_event_type": "PURCHASE"
  }
  targeting: { "geo_locations": { "countries": ["US"] } }
  status: "PAUSED"

Use SUBSCRIBE if that is the primary MMP event. Meta rejects OFFSITE_CONVERSIONS without custom_event_type.

Ad Set Settings Reference

iOS 14+ Notes

• AEM + SKAN: expect delayed reporting
• Trust MMP over Meta dashboard for iOS CPA
• Do not pause winners at 24h on iOS alone

Android Notes

• Google Play URL in object_store_url
• Same structure; often faster conversion feedback

Step 5 — Create Ad Creative

Copy code
meta_ads_create_creative
  ad_account_id: "act_1234567890"
  format: "app_install"
  name: "FocusApp - VarA - Problem"
  page_id: "<facebook-page-id>"
  link_url: "https://apps.apple.com/us/app/id123456789"
  message: "<primaryText from Appeeky>"
  headline: "<headline from Appeeky>"
  description: "<description from Appeeky>"
  image_hash: "<from step 2>"
  call_to_action_type: "INSTALL_MOBILE_APP"

name is required. Default format is "link" — set "app_install" for store-install ads.

Creative Field Mapping

Step 6 — Create Ad

Copy code
meta_ads_create_ad
  ad_account_id: "act_1234567890"
  adset_id: "<adset-id>"
  creative_id: "<creative-id>"
  name: "FocusApp - VarA - Problem - 20250629"
  status: "PAUSED"

Repeat steps 2, 5, 6 for each variant in a batch (shared campaign + ad set).

Step 7 — User Review

Present summary. Do not activate until checklist complete.

Copy code
meta_ads_list_ads
  ad_account_id: "act_1234567890"

Output Template

markdownCopy code
# Meta Ad Draft Created — [App Name]

**Status:** All entities PAUSED — awaiting your approval

| Entity | Name | ID | Status |
|--------|------|-----|--------|
| Campaign | FocusApp - App Installs - US | [id] | PAUSED |
| Ad Set | US - iOS - Creative Test | [id] | PAUSED |
| Creative | VarA - Problem | [id] | — |
| Ad | FocusApp - VarA - Problem | [id] | PAUSED |

## Copy Used
| Field | Value |
|-------|-------|
| Primary text | ... |
| Headline | ... |
| Description | ... |
| CTA | INSTALL_MOBILE_APP |

## Creative
- **Image preview:** [imageUrl]
- **Image hash:** [hash]

## Budget & Targeting
- **Daily budget:** $50
- **Geo:** US
- **Optimization:** Purchase
- **Placements:** Advantage+

## Before Activating
- [ ] MMP Purchase/Subscribe events in last 7 days (mmp-setup)
- [ ] Meta Events Manager shows app events
- [ ] User reviewed creative + copy
- [ ] iOS SKAN delay expectations set
- [ ] Target CPA documented in app-ads-context.md

## Activate (user confirms)

meta_ads_update_ad ad_id: "" status: "ACTIVE"

meta_ads_update_adset adset_id: "" status: "ACTIVE"

meta_ads_update_campaign campaign_id: "" status: "ACTIVE"

Copy code

## 48h Follow-up
→ meta-campaign-audit

Batch Pipeline (5 variants)

Total write credits: ~(2 × 12) = ~24 API credits for full batch setup.

Error Reference

REST API Equivalents

Base: https://api.appeeky.com/v1/connect/meta-ads/

MCP tools hit the un-nested paths and pass ad_account_id. Nested aliases also exist.

See appeeky-meta-ads.md.

Common Mistakes

Pre-Flight Checklist

Copy code
Appeeky:
- [ ] Creative job completed
- [ ] imageUrl + copy extracted

Meta auth:
- [ ] credentials_status connected
- [ ] Default ad account set
- [ ] Page ID confirmed

Tracking:
- [ ] mmp-setup complete
- [ ] promoted_object application_id correct

Pipeline:
- [ ] All entities PAUSED
- [ ] User has summary + preview
- [ ] 48h audit scheduled

Related Skills

• meta-ad-creative — step 1 generation
• ad-creative-variants — batch before pipeline
• ad-creative-edit — fix creative before upload
• meta-campaign-setup — manual setup reference
• mmp-setup — prerequisite before activation
• meta-campaign-audit — 48h performance review
• meta-budget-optimizer — post-launch budget rules