Publishers

Create a zone and install the tag

Pick a format, set your net floor and your passback, then paste one line of code. How to check that the tag is detected.

4 min read Updated Markdown

What a zone is

A zone is one placement on one site. It has one format, one tag, its own net floor and its own passback. You can create up to 10 zones per site and 50 per account once the publisher terms are accepted. A zone only serves once its site is live.

Formats you can sell

  • Popunder: the advertiser's page opens in a new tab at the visitor's tap. No image.
  • Banners: 300x250, 320x50, 300x100, 300x500 and 320x100, shown where you paste the tag.
  • Corner slider (300x250): a fixed, closable box in the bottom right corner.
  • Interstitial (300x500): a full-screen layer at the visitor's first tap, never on page load and never right after a popunder. At most once per visitor per 24 hours.
  • In-page card (320x100): a fixed card at the bottom of the screen, after 3 seconds or the first scroll. At most once per visitor per 6 hours.

The Formats page shows each one and its public minimum price.

Create the zone

  1. Open Sites & zones and pick the site.
  2. Choose a format.
  3. Give the zone a name you will recognise in reports (optional, 60 characters at most).
  4. Set your net floor: the lowest amount you accept per 1,000 valid impressions, net, as you receive it. It is required, between 0.01 and 50 USD, and prefilled with a suggested net floor for the format.
  5. Paste your passback (optional, see below). Interstitial and in-page zones have no passback.
  6. Create the zone and copy its tag.

One net floor applies to every country. You can change it later in the zone settings, but a zone always keeps one.

Install the tag

Each zone has its own tag, one line:

<script src="https://fieldwren.com/t.js" data-z="z1a2b3c4d" async></script>

Paste it in your page HTML where the zone should show. Slider, interstitial and in-page zones need no placement: the tag builds its own box, so anywhere in the page works. Use the exact tag of the zone: the data-z value is the zone key.

After the first visit, the zone shows Tag detected, usually within 5 minutes. Every night we also look for the tag on your home page and record whether it was found.

Track your sources with sub-IDs

If you put the same zone in several places (header, footer, a landing page, a partner), add up to three labels to the tag and the Reports page will split your numbers by them:

<script src="https://fieldwren.com/t.js" data-z="z1a2b3c4d" data-s1="header" data-s2="landing-a" async></script>

  • data-s1, data-s2 and data-s3 are optional and free: you choose the words.
  • Each label is 64 characters at most, using letters, digits, _, . and -. Anything else is removed.
  • Do not put personal data in them (no emails, no user ids). They are only used to group your own numbers.
  • In Reports, break down by Sub ID 1, 2 or 3. The 200 labels with the most impressions are listed, the rest is added up as (other), and views without a label show as (none).

A label shows up in Reports from the next page view after you change the tag. Past views keep the label they had.

The passback

When we do not buy a visitor, the tag puts your passback in place of our ad, so the spot is never empty and your usual network keeps earning. The passback is plain HTML, up to 10,000 characters: use the tag of ONE spot of your usual network, with the size of the zone. The Developers page has examples.

If something goes wrong

  • Waiting for the first call: open a page that carries the tag on a phone, then wait a few minutes. Check that a cache or optimisation plugin did not strip or delay the script, and that your Content Security Policy allows fieldwren.com.
  • Not serving with a reason: the zone table always says why (paused by you, site under review, site paused). Fix that first.
  • Paused by our team: you cannot restart the zone yourself. Contact support.
  • The zone serves but shows nothing: read Why a zone shows nothing yet.

Frequently asked questions

Is my floor gross or net?

Net. It is what you receive per 1,000 valid impressions. We compare what each bid would pay you to it.

Can I put two zones on the same page?

Yes, one tag per zone. Only one slider shows per page, and interstitial and in-page zones of the same site share their frequency limit.

Does the tag slow my page?

The tag loads with async, so it does not block your page from rendering.

What happens when you do not buy a visitor?

The tag puts your passback in place of our ad, so the spot is never empty. Interstitial and in-page zones have no passback.