AG Price Lists

An automated guaranteed campaign is not bid for. Its price comes from a grid the organization has published in advance: for a creative of this length, played this often, this much per ad play.

This page is for an organization’s owner, admin and manager employees, who write the grid, and for anyone reconciling an automated guaranteed campaign’s figures against it. A viewer reads the grid and changes nothing.

This grid lives on the automated guaranteed price list, which the client cabinet lists as Guaranteed and which is edited at /policies. RTB price lists are edited at /prices and programmatic guaranteed price lists at /rtb-prices: each way of selling keeps its prices on a screen of its own. RTB price lists has the overview.

The automated guaranteed price list

An automated guaranteed price list does for automated guaranteed campaigns roughly what an RTB price list does for the auction: it covers a set of faces and says what they cost.

It differs in three ways.

Which partners may book automated guaranteed campaigns is settled by the integration and by what the organization has enabled, and the price list names no partners.
It carries a grid of prices, because the campaigns it covers are priced in advance.
It also carries the two settings that decide how much can be booked at all — the overbooking ceiling, and a ceiling on how much of an ad block automated guaranteed campaigns may take up between them. Those two settings concern capacity; see Booking and capacity.

A face belongs to at most one AG price list. The first AG price list an organization creates becomes its default, and from then on the organization always has exactly one: the default covers every face no other price list names and cannot be deleted, and the way to change the default is to make a different price list the default. Removing a face from a non-default price list attaches it to the default one, so it stays covered.

A row in the grid

Each row is four things.

Creative length: Entered in seconds.
Frequency: A count and a period — 2 plays per 3600 seconds. Only the rate the two produce matters.
Price: An amount per ad play.
Default: Exactly one row in the grid is marked as the default.

Two rules are enforced when the price list is saved.

Exactly one row must be marked default. Zero rows or two rows are both refused.
No two rows may share a creative length and a frequency rate. Because the rule compares the rate of the two numbers, one play per hour and two plays per two hours collide, and the second one saved is refused. Write frequencies in a consistent form and this never comes up.

Which row a booking uses

When an employee reserves an automated guaranteed campaign, the platform looks up the row matching the face, the creative length and the frequency that has been set on that face — all three exactly.

All three must match exactly, and a combination the grid does not price cannot be reserved.

If the frequency asked for is more than the face can physically deliver over the campaign’s period, the reservation is refused, and the refusal names the highest frequency the grid prices that the face could actually have delivered. The capacity calculation behind it is in Booking and capacity.

What the number means where you see it

The price typed into the grid is the organization’s own, before the platform’s commission.

Everywhere the price is shown outside the price list itself — on the campaign, and in the grid quoted to a demand partner — the platform’s commission has already been added. The two numbers are supposed to differ, and by exactly the commission that applies to that face and that partner. See Fees and commission.

When a campaign is reserved, the price with commission is copied onto the campaign, per face. Editing the price list afterwards does not change a campaign that has already been reserved.

The campaign’s total for a face is its planned plays multiplied by that copied price. Planned plays come from the frequency, the campaign’s periods, its time windows and the screen’s expected downtime — not from anything on this page.

The grid a demand partner is sent also carries the organization’s tax rate, alongside the prices. The rate is transmitted for the buyer’s own calculation.

Writing a grid

Publishing prices for a set of faces

Open /policies and create an AG price list, or open the default one.
Add a price row for each combination of creative length and frequency you are willing to sell. Length and period are entered in seconds.
Mark one row as the default. That is the row a demand partner is shown as the headline price for these faces, and it should be the combination you expect to sell most of.
Save.
Select the faces this price list covers, and save. Any face you select stops being covered by whatever AG price list covered it before.
Confirm the outcome: a demand partner querying prices for one of those faces now receives the whole grid, with commission added, and the default row flagged.

A creative length or frequency that is not in the grid cannot be booked on the faces this price list covers. If a partner reports being unable to propose a campaign it should be able to propose, the grid is the first place to look.