Inventory Overview
Manage your ad placements and how they're organized across your site.
What is inventory?
Your inventory consists of:
- Ad slots — Individual ad placements (where ads appear)
- Layouts — Collections of ad slots (which slots load on which pages)
A typical setup for a single site:
- Homepage — layout
Homepageloadsheader,sidebar,footer - Articles — layout
Article Pagesloadsheader,sidebar,incontent_1,incontent_2 - Category pages — layout
Categoryloadsheader,sidebar
Key concepts
Ad slots
An ad slot is a single ad placement — one location where an ad appears.
| Property | Description |
|---|---|
| Name | Your identifier (e.g., article_sidebar_top) |
| Sizes | Allowed dimensions (e.g., 300x250, 300x600) |
| Settings | Lazy loading, refresh, floors |
Layouts
A layout is a collection of ad slots that load together on specific pages.
| Property | Description |
|---|---|
| Name | Your identifier (e.g., Article Pages) |
| Targeting | Which URLs this layout applies to |
| Slots | Which ad slots are included |
How inventory works
Managing inventory
| Task | Where | Link |
|---|---|---|
| View all ad slots | Inventory → Ad Slots | View slots → |
| Create ad slot | Inventory → Ad Slots → Add | Create slot → |
| View all layouts | Inventory → Layouts | View layouts → |
| Create layout | Inventory → Layouts → Add | Create layout → |
Best practices
Naming
Use consistent, descriptive names:
Ad slots: [page]_[position]_[number]
homepage_header_1
article_sidebar_top
category_incontent_1
Layouts: [page type] or [section]
Homepage
Article Pages
Sports Section
Organization
- Start simple — Begin with core page types and expand
- Group logically — Similar pages share layouts
- Document — Keep notes on your slot purposes
Performance
- Limit slots per page — 4-6 is typical
- Use lazy loading — For below-fold slots
- Reserve space — Prevent layout shift
Getting started
If you're setting up inventory for the first time:
Common questions
How many ad slots should I have?
There's no magic number. Consider:
- User experience — Too many ads annoys users
- Page layout — What fits naturally?
- Revenue goals — More slots = more potential revenue, but diminishing returns
Most sites do well with 4-6 slots per page.
Can one ad slot be in multiple layouts?
Yes. An ad slot can be included in any number of layouts. This is common for slots like headers that appear across page types.
What if no layout matches a page?
No ads will load. Create a catch-all layout with a Regex match: .* page-path rule as a fallback, or ensure your layouts cover all page types.