AdnovaDocs
Ad Launcher

Multi-placement ad

Supply placement-specific creatives so each surface (feed, story, reel) gets the right aspect ratio.

A multi-placement ad lets you provide different creatives tuned to different Meta placements — e.g. a 1:1 feed image and a 9:16 story video — within one ad.

When to use this

You have placement-optimised creatives (feed, story, reel) and want each surface to render its best-fit asset rather than a cropped one.

Example body

POST /meta/launches

Every key applicable to a multi-placement ad, with sample values. Required: adName, adSets, creatives[]._id, adProfiles, cta, webLink.

{
  "adAccountId": "01H8Y4...",
  "platform": "meta",
  "ads": [
    {
      "adName": "Spring Multi-Placement",
      "adSets": ["123456789012345"],
      "creativeDetails": {
        "groupType": "multi_placement",
        "creatives": [{ "_id": "01H8YA..." }, { "_id": "01H8YB..." }]
      },
      "adProfiles": {
        "facebook_page_id": "123456789012345",
        "instagram_account_id": "987654321098765",
        "page_backed_instagram_account_id": null
      },
      "cta": "SHOP_NOW",
      "defaultPrimaryText": "Spring, everywhere you scroll.",
      "primaryTextVariations": ["Feed, story, reel — all spring", "Spring on every surface"],
      "defaultHeadline": "Spring Sale",
      "headlineVariations": ["40% off", "New season"],
      "adDescription": "Free shipping on orders over $50.",
      "webLink": "https://example.com/spring",
      "displayLink": "example.com/spring",
      "utm": "utm_source=facebook&utm_medium=cpc&utm_campaign=spring",
      "leadGenFormId": null,
      "adSchedule": { "startDate": "2026-06-01T00:00:00Z", "endDate": "2026-06-30T23:59:59Z" },
      "promoCodeDetails": { "type": "manual", "manualCodes": ["SPRING40", "EARLYBIRD"] },
      "aiMediaDisclosure": true
    }
  ]
}

Full schema: Create a launch.

Required fields

  • adName, adSets
  • creativeDetails.creatives[]._id
  • adProfiles — at least one of facebook_page_id / instagram_account_id
  • cta
  • webLink

The server mints ads[].id and creativeDetails.groupId.

Optional fields

defaultPrimaryText, primaryTextVariations, defaultHeadline, headlineVariations, adDescription, displayLink, utm, adSchedule, promoCodeDetails, leadGenFormId, aiMediaDisclosure.

Field notes

  • creatives[] — one asset per placement aspect ratio. The launcher maps assets to placements by each creative's dimensions.

Gotchas

  • Placement mapping follows the ad account's placement configuration in Adnova. Creatives whose aspect ratio matches no configured placement may be skipped.
  • Not supported on App-promotion ad sets (app-install campaigns) — they allow only single image/video, carousel, and flexible. See Ad set compatibility.