Skip to main content
A placement identifies where on a page an ad is displayed. ENS Ads uses placement slugs — short string identifiers — to connect campaigns to specific visual locations in your UI. When you fetch campaigns, you tell the API which placement you are filling, and the API returns campaigns that have been targeted to that slot.
The placement parameter is required on every call to GET /api/v1/campaigns/fetch. Requests that omit it will receive a 400 error with the message "placement parameter is required".

​
Available placements

The table below lists every supported placement, its slug (the value you pass in the placement parameter), and where it appears on a page.

​
Using placements in your request

Pass the placement slug as a query parameter when fetching campaigns:
You can fetch campaigns for one placement per request. If your page renders multiple placements, make a separate request for each one.

​
Placement categories at a glance

These placements sit in fixed regions of the overall page layout:
  • header_banner — top of the page, maximum visibility
  • footer_banner — bottom of the page
  • footer_top — directly above the footer block
  • sticky_bottom — fixed to the bottom of the viewport while the user scrolls
  • modal_overlay — appears over page content as an interstitial
These placements are tied to editorial content pages:
  • article_top — above the article headline
  • article_inline — embedded within the article body
  • article_bottom — below the article
Feed placements blend into content streams and listing pages:
  • feed_sponsored — styled as a native sponsored post
  • feed_carousel — a swipeable carousel/slider unit
  • feed_between — inserted between organic feed items
  • hero_section — overlaid on the main hero or featured image of the page; high-impact, often used on homepages or landing pages
Always render the campaign in the placement you requested. Displaying a campaign in a different slot than the one used to fetch it produces inaccurate targeting data and may violate advertiser campaign settings.