Sites reference
Every Basic info field of a site, the site-level cards and what each controls, the header actions and the REST calls — the companion to the Create and edit a site guide.
Reference network manager publisher admin Account → Publishers → site
The companion to Create and edit a site, which has the steps, the caveats and the fix-it checklist; this page holds every Basic info field, the site-level cards, the header actions and the REST calls.
Options and fields (Basic info)
| Field | What it does | Default | Notes |
|---|---|---|---|
| Name | Site display name across trees, grids, reports | — | Required, max 128. Not editable on masked shares |
| Status (Active/Inactive) | Master on/off for the whole site subtree | Active | Shown only if your role can switch sites on and off |
| Category | Publisher categories used by auto-linking and Rules | none | Changing it triggers the auto-link question (see caveats). With a read-only categorization grant the field is visible but locked |
| Inventory type | Website ⇄ App | Website | App adds the App bundle field and renames Site URL to Developer website |
| Site URL / Developer website, App bundle | The property address (for an app, the developer website from its store page) / package id | — | Max 255. A URL with spaces saves with a warning toast; a URL with no scheme (example.com) is rejected outright |
| Additional fields | Network-defined custom fields | — | Appear only if your network configured them |
| Private (Advanced settings) | Marks the site private | off | Shown only if your role allows it |
| Collect cookies (Advanced settings) | Per-site cookie collection toggle | off | Shown only if your role allows it; not a network switch |
| Email / Description | Contact and notes | — | Not rendered at all on masked shares |
| Monthly impressions / Monthly visitors | Traffic estimates picked from preset ranges | — | Informational |
| Supply chain (own section, before Additional information) | The site in your sellers.json and in the supply chain sent to buyers: Seller ID (empty = the generated ID, shown greyed out), Seller type (Publisher / Intermediary / Both), List in sellers.json (a switch, off by default — sites are opted in one by one), Confidential beside it (listed by seller ID and type only; ticked and locked on a site with masked inventory), and the site’s ads.txt block — the lines the publisher must publish, grouped by source, with Copy, Download, the nightly check result and Re-check now; the Header-bidding partners in the site’s active tags, one row each with its bidder code and whether the file has its line; and Additional ads.txt lines — the saved lines, then a box to paste more — for a partner that sells the site but is not an advertiser. Collapsed, the section’s header sums up whether the site is listed in sellers.json and the last ads.txt check | see each field | The seller ID is editable by anyone who can edit the site. The Site Supply Chain (sellers.json, ads.txt / app-ads.txt) permission, off for every role until granted, governs everything else, grouped under sellers.json & ads.txt: without it only the seller ID shows; read-only shows the group locked, marked Read-only. Header-bidding tags name you as the seller only when the seller ID is filled in; bid requests to DSPs carry it only once sellers.json is published. Not shown on a masked share, and a save or API update through one leaves the sellers.json fields as they were. See Supply chain and sellers.json |
| Created | Creation date | — | Read-only, last field in Additional information |
Site-level cards
The cards below Basic info follow the same pattern: a switch turns the feature on/off, and the Features rail on the side mirrors the switches.
| Card | What it controls |
|---|---|
| Pre-targeting | Traffic filters applied to every placement under the site — see Pre-targeting and blocking |
| OpenRTB integration | IAB categories, blocked IAB categories and the OpenRTB publisher id sent in bid requests — see how the site, zone and placement lists combine |
| Revenue share | Per-advertiser revenue-share percentages |
| Pricing | Publisher payment model and per-country prices |
| Bid floor | Minimum acceptable price, per country |
| Limits | Impression/click/conversion caps for the site — see Limits |
| Per conversion action limits | Caps per conversion action |
| CPM Threshold | Per-country minimum CPM the publisher is guaranteed — a revenue floor for reporting/payouts and the fallback RTB bid floor; direct campaigns still serve below it — see Site CPM threshold |
| Matching rules | Automatic banner-matching rules scoped to this site |
| Matched banners | Read-only cascade of the advertisers → campaigns → banners the rules currently match |
| Piggybacks | Third-party tracking pixels fired with site traffic — see Piggybacks |
| Video creative requirements | The publisher’s video spec: an uploaded video that misses it is not served on this site — see Check video creatives against a publisher’s spec |
| Payments | Read-only publisher payout history by year |
| Sharing settings | Give other users access to this site — see Shares |
Header actions
- Zones counter — the title shows
(zones: N)and links to the zones list. - Placements counter —
(placements: N)next to it opens every placement of the site in one list, across all its zones. It is the full placements grid narrowed to this site (with the Site column dropped), Filter by offering Zone and Placement, and a Zones | Placements switch above the grid. Both counts exclude deleted entities. There is no Add placement button — a placement belongs to one zone, so create it from the zone. - Approval badge — Pending or Rejected next to the eyebrow when your network reviews sites; an approved site shows no badge.
- Add new zone — hidden on masked or non-editable shares.
- Actions → Create user & share — creates a statistics-only user for this site: enter username, email and role. The address receives an invitation with a single-use set-password link, not a password. See Account users.
- Actions → Email ad tags — the site’s placement tree with one checkbox per available tag type for each placement (each placement’s default tag type pre-checked); recipients, subject and body; optionally as a single file. See Email ad codes on a site.
- Actions → Delete this site — cascades to zones and placements; restorable for 90 days (see caveats).
Over the API
The ads.txt block is GET /rest-api/sites/{siteId}/ads-txt (lines and last check) and
POST /rest-api/sites/{siteId}/ads-txt/check (queue a re-check). The Payments card is
GET /rest-api/site/{siteId}/payouts.do; booking and removing payouts is described in
Finances, fees and referral billing. A deleted
site is restored with POST /rest-api/deleted-entities/{type}/{id}/restore. The site itself is
created and edited with POST /rest-api/sites/update.do — see the
Sites API reference.
