Browse the help center

Work with zones

Create a zone to group a site's placements, what the five zone-level cards do for every placement in the group, how to move or copy zones and placements without breaking ad tags, and what deleting a zone takes with it.

How-to network manager publisher admin Account → Publishers → site → zone

A zone is the middle level of the supply tree: a named group of placements inside one site. It carries no ad tag of its own — it exists to organise placements, to give reports a grouping, and to hold the filters and rules that apply to every placement in the group, so you set them once instead of once per placement.

Example. dailynews.example.com has 4 article-page slots and 3 homepage slots. Two zones, Article Pages (4 placements) and Homepage (3 placements), let the publisher read revenue per page area in one report row each, and let the network manager ask DSP partners to keep the Gambling IAB category off all 4 article slots with one blocked category on the Article Pages zone instead of four.

Typical scenarios

You wantSetWhere
Revenue per page area in reportsOne zone per area: Homepage, Article Pages, Sports sectionSite → Add new zone
Premium vs. remnant pricing on the same siteZones Premium and Remnant; placements grouped by what they are sold asSite → Add new zone, then drag placements between them
Ask DSPs to keep adult or gambling ads off a whole sectionThe blocked IAB categories once on the zone’s OpenRTB integration card (programmatic demand only — see Keep unwanted ad categories off your inventory)Zone editor
Pair a section with the right advertisers automaticallyCategory or label Matching rules on the zone; check the result on Matched bannersZone editor
Retire a page area without losing its tagsMove the placements to another zone first (keys are kept), then delete the empty zonePublishers tree, drag and drop

Step by step

  1. Open the site (Account → Publishers → site) and click Add new zone in the header.

  2. Enter the Name (up to 128 characters). It is the only required field — a zone has no category and no size. If your role can switch zones on and off, the Active switch, on by default, sits under it.

    Create new zone form with the Name field and the Active switch

  3. Optionally open Additional information for a Description, and fill any additional fields your network has configured.

  4. Click Save. You get a Zone saved toast and land on the full zone editor. Until the zone has its first placement it shows the nudge “This zone has no placements yet — A placement is the actual ad slot — the zone serves nothing without one. Create the first placement and link banners to it.” with the same Add new placement… menu as the header.

    Zone editor with the placements counter, header buttons and the feature rail

  5. Click Add new placement… and pick a type — see Create a placement.

    Add new placement menu open on a zone

  6. Switch on the cards the zone needs from the Features rail and fill them in. They appear only after the first save, in this order:

    CardWhat it does for every placement in the zone
    Pre-targetingTraffic filters. See Pre-targeting and blocking.
    OpenRTB integrationIAB categories (sent as sectioncat) and blocked IAB categories (merged into bcat) in the bid requests for this zone. See how the levels combine.
    Matching rulesCategory/label rules that auto-pair this zone’s inventory with demand. See Rules and defaults.
    Matched bannersRead-only cascade of the advertisers → campaigns → banners the rules currently match.

The editor’s header carries the placements counter — the title reads Article Pages (placements: 4) and the count links to the zone’s placement list — the site / zone switchers in the breadcrumb and title for jumping to a sibling without going back to the tree, the Add new placement… menu, and Delete this zone.

Move or copy a zone or placement

Drag a zone onto another site, or a placement onto another zone, in the Publishers tree; the dialog asks whether to Move or Copy (with the number of copies, 1 to 20) and whether to Keep banners linked. The grid clipboard does the same: put zones or placements in it, open the destination site or zone, and choose Move or Paste a copy.

  • A moved placement keeps its placement key, and a zone moved to another site keeps the keys of every placement in it — so every ad tag already published for them keeps serving, unchanged.
  • A copy is a new placement with a new key: its tags have to be taken from the copy.
  • Keep banners linked on a move leaves the placement’s banner links as they are; cleared, it unlinks every banner and takes them out of the placement’s daisy chain. On a copy it decides whether the copy is linked to the same banners.
  • Moving needs update rights on both sites — the one the entity leaves and the one it joins.
  • Nothing is moved or copied into a deleted zone or site, or out of one: the move is refused with a message naming the deleted entity, and the placement or zone stays where it was. The same holds for campaigns and banners in the Advertisers tree.

Caveats and exceptions

  • Who sees what. A publisher gets the zone itself (Basic info and Add new placement…); the five cards belong to the network side. Which cards a network role sees depends on its grants — see User roles. On a Can View share the form is read-only and Add new placement… is hidden; ask the owner for Can Edit (deleting needs Is Owner). On a masked share the name shows as ZONE_<id> and is locked, Description is not rendered, Add new zone / Add new placement… are not rendered, and the placements under the zone are masked too.
  • Matched banners needs Matching rules. The Matched banners card renders only when the Matching rules card is visible too. A role that cannot see Matching rules never gets Matched banners, and nothing on screen says why.
  • Deleting a zone deletes every placement under it. The confirmation says so literally — “The zone will be deleted along with its placements. You can restore it within 90 days. Are you sure?” — and it means it: the delete cascades to each placement, and those tags stop answering. The cascade reaches the ad server almost immediately, not on the next cache reload: each deleted entity publishes an update that patches the ad server’s in-memory inventory, so a tag deleted “just to test” is dark within seconds. For 90 days Recently deleted (the box-with-arrow button in the Publishers tree’s action rail, and the link on the delete toast), the Undo on the toast of a delete made from the tree rail, or POST /rest-api/deleted-entities/{type}/{id}/restore brings the zone and those placements back — their tags answer again after the ad server’s next reload, see Restore something you deleted — but traffic is lost in between. Move the traffic first.
  • Zone pre-targeting is a filter, not a merge. A request must pass site and zone and placement pre-targeting, evaluated broadest-first and failing fast. A rule that allows traffic at placement level still loses if the zone blocks it.
  • Name length is checked by the server. The 128-character cap on Name is enforced on save, not by the input, and the over-length failure has no friendly message registered — you get the validation framework’s generic “size must be between…” text rather than something naming the field.
  • Some save errors arrive as a toast. A zone save can fail with an affiliate-related message shown as a toast rather than under a field. Nothing is highlighted on the form — read the toast.

Not working?

SymptomCheckWhere
No Add new zone button on the siteYour share is masked or view-only; the button is not rendered. Ask the owner for Can Edit.Site header; share settings on the owner’s side
A placement in the zone will not serve although its own pre-targeting allows the trafficThe zone or the site blocks it — all three levels must pass.Site → Pre-targeting, zone → Pre-targeting, placement → Pre-targeting
Matched banners card is missingYour role lacks the Matching rules card; Matched banners never shows without it.User roles
Save fails with “size must be between…”Name is over 128 characters.Zone → Basic info → Name
Save fails but no field is highlightedThe error came as a toast (affiliate-related).The toast in the corner of the screen
”You do not have permission to edit this zone” / “Access denied” / “Permission denied”Three different refusals: a zone edit, a zone delete, and a placement edit respectively. The exact wording tells you which action was refused.Role grants or share level on that entity
A tag went dark right after a deleteDeletes patch the ad server within seconds. Restore from Recently deleted or the toast’s Undo; tags answer again after the next ad-server reload.Publishers tree action rail → Recently deleted
Drag-and-drop move is refusedEither side is deleted (the message names it), or you lack update rights on the source or destination site.Publishers tree; share level on both sites

Reference

The whole zone form, in the order it renders.

FieldWhat it doesControlDefaultWhereNotes
NameZone display nameText, max 128—BothRequired. Locked (and skipped on save) on a masked share.
ActiveOn/off for the zone and every placement under itToggleOnBothShown only if your role can switch zones on and off.
Additional fieldsNetwork-defined custom fieldsVaries—BothOnly when your network has configured them.
DescriptionFree-text notesTextarea—BothUnder Additional information. Not rendered at all on a masked share.
CreatedCreation dateRead-only text—EditLast field in Additional information.
Role or shareGets
PublisherBasic info and placements; the five cards belong to the network side.
Network managerBasic info plus all five cards (per its grants).
Can View shareRead-only form; Add new placement… hidden.
Can Edit shareEdit; deleting needs Is Owner.
Masked shareName as ZONE_<id>, locked; Description hidden; placements masked.

Exact grants: see User roles.

Over the API

  • Matched Ads — GET /rest-api/matched/ZONE/{zoneId}.do?returnType=ADVERTISER|CAMPAIGN|BANNER (BANNER when omitted), with the card’s filters and start / limit; it needs the Matched advertisers permission. Sites and placements use the same endpoint.
  • Open RTB categories — GET / POST /rest-api/zones/{zoneId}/openrtb.do reads and sets iabCategories and blockedIabCategories (ids or IAB codes such as IAB1_2); only the lists sent change, and an empty list clears one. It needs the Open RTB permission. GET /rest-api/iab-categories.do lists the catalogue. A placement’s card is /rest-api/placements/{placementId}/openrtb.do, which also takes blockedBannerAttributes and customOpenRtbTagId — see Set a placement’s OpenRTB settings, which also explains how the zone’s lists combine with the site’s and the placement’s.
  • Custom fields — /rest-api/additional-fields/ZONE/{zoneId}.do.
  • Move — POST /rest-api/zones/update.do with the zone’s id and another siteId moves the zone; a placement moves the same way through its update endpoint with another zoneId. Both keep the placement keys (see Entities via API). From an AI assistant, entity_update with parentId does it.
  • Restore — POST /rest-api/deleted-entities/{type}/{id}/restore within 90 days of a delete.

Related pages

Please disable Adblock
Are you using adblock? Disable it and reload the page to proceed to the destination page.

A registration has already been submitted from this page. Please try again in 10 minutes.