AdnovaDocs
Ad Launcher

Collection ad

A cover creative over a product grid drawn from a catalog product set.

A collection ad shows a hero (cover) creative above a grid of products pulled from a Meta catalog product set. Tapping it opens an Instant Experience storefront.

When to use this

You have a product catalog and want a mobile storefront experience seeded from a product set.

Example body

POST /meta/launches

Every key applicable to a collection ad, with sample values. Required: adName, adSets, cover creatives[]._id, adProfiles, cta, webLink, productSetId, defaultHeadline.

{
  "adAccountId": "01H8Y4...",
  "platform": "meta",
  "ads": [
    {
      "adName": "Spring Collection",
      "adSets": ["123456789012345"],
      "creativeDetails": {
        "groupType": "collection",
        "creatives": [
          {
            "_id": "01H8YA...",
            "productHeadline": "Spring Collection",
            "productDescription": "Shop the full range"
          }
        ]
      },
      "adProfiles": {
        "facebook_page_id": "123456789012345",
        "instagram_account_id": "987654321098765",
        "page_backed_instagram_account_id": null
      },
      "productSetId": "678901234567",
      "productSetData": {
        "business_id": "1029384756",
        "catalog_id": "456789012345",
        "product_set_id": "678901234567"
      },
      "cta": "SHOP_NOW",
      "defaultPrimaryText": "Explore the spring collection.",
      "primaryTextVariations": ["Shop the spring range", "New season is live"],
      "defaultHeadline": "Spring Collection",
      "headlineVariations": ["Up to 40% off", "New arrivals"],
      "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 (the cover creative)
  • adProfiles — at least one of facebook_page_id / instagram_account_id
  • cta
  • webLink
  • productSetId (or full productSetData) — the product grid source
  • defaultHeadline — collection ads always require a headline

Missing productSetId or defaultHeadline is rejected (400). The server mints ads[].id and creativeDetails.groupId.

Optional fields

Per-creative productHeadline / productDescription; ad-level defaultPrimaryText, headlineVariations, adDescription, displayLink, utm, adSchedule, promoCodeDetails, leadGenFormId, aiMediaDisclosure.

Field notes

  • productSetId — required; the product set whose items fill the grid. Resolve it from List catalogs (each catalog row carries its product sets inline). Or pass the full productSetData object (business_id / catalog_id / product_set_id).
  • creatives[0] — the cover asset. productHeadline / productDescription label the storefront.

Gotchas

  • The catalog and product set must belong to a business the ad account can access — see List businesses.
  • Exactly one cover creative.
  • Not supported on App-conversion ad sets — see Ad set compatibility.