Publisher deal terms are in beta for Seller Accounts on the beta profile.
Elsewhere
dealTerms is refused with FEATURE_NOT_ENABLED, and every source
prices and books from its ad server as before. Apostra does not pay the
publisher: you pay your publishers yourself. Terms only set the price you sell
at and the cost your margin is measured against.Set terms
Terms belong to one managed source on your own storefront, such as a connected Google Ad Manager network. SenddealTerms with the source’s id and nothing
else.
publisherSharePercent is the share of its price the publisher is owed. It is
above 0 and at most 100, with up to four decimal places. A source at 70 leaves
you 30% of what the buyer pays. Send dealTerms: null to remove the terms. A
save that matches the current terms changes nothing. Read them back with get
or search on kind: "inventory_source": dealTerms holds the share, its
version and when it was set, and is null on a source with no terms.
The source’s own price stays the price it is today: the prices your ad server
reports, or the prices you upload.
What the terms change
- The price a product sells at. A product over a source with terms sells at the source’s cost divided by the share, rounded up to the currency’s smallest unit. A cost of 7.00 at 70% sells at 10.00; 7.33 sells at 10.48. This replaces the price the model would otherwise set for that product. A product takes the new price when it is next composed.
- The buy to the publisher. The buy is sent to the source at the publisher’s price: the budget the buyer sets is scaled down to the publisher’s share of it and rounded down to the currency’s smallest unit, so the source buys the impressions the buyer paid for and no more. The ledger books that same number as your cost, and your margin is what is left of the buyer’s budget.
- Buyer discounts. A discount comes out of your margin. It never takes the price below the source’s cost, so the publisher always gets its price. A seller price ceiling still caps the price, as it does for any product.
- Priced signals. A signal price the seller bills on top passes through at cost and is not marked up.
- Buyers never see the cost. A buy the terms cannot be applied to is refused
with
pricing_not_bookableand the buyer is told only that the product can’t be booked at that price. That happens when the package is not priced per thousand impressions, when its price can’t be worked out, or when a product composed before the terms was set is priced below its source’s cost.
Versions
Every change to a source’s terms is a new version. A buy keeps the terms it was booked under, so changing terms affects new buys only. A buy booked before you set terms has none, and stays that way. Terms you have set keep applying to new buys even if your account leaves the beta, so clear them first (savedealTerms: null
on each source) if you want those sources to book as they did before.
When you change or clear the terms
Products already priced under the earlier terms come off the catalog when you save, so no buyer is offered a product that would be refused. The save answer lists them underretiredProducts (a count, and up to fifty product ids). Each
returns, at the new price, the next time a buyer’s search composes it. A buyer
who already holds one of them is told the price can no longer be booked, and the
buy is refused before anything is sent to the publisher.
Limits in this beta
- Terms apply to managed (Google Ad Manager) sources only.
- A buy booked under terms can’t take changes to its budget, bids or packages
yet: such an update is refused with
pricing_not_bookable. On a buy that spans several sources, one source under terms refuses the whole update before anything is sent to any of them. - If your terms can’t be read while a buyer is searching, your managed sources are left out of that search and the rest of your inventory still answers. They come back as soon as the read succeeds.
- You can’t delete a source, or a storefront, that has a booking made under its terms. Without bookings, deleting the source removes its terms with it.
- Terms apply to packages priced per thousand impressions.
- An auction bid (
bid_price) is forwarded at the publisher’s price too: the buyer’s bid times the source’s cost over the price your product sells at, rounded down to the currency’s smallest unit. The forwarded bid is never below the source’s cost, so a cost with finer precision than that unit (a cost of 7.335 in a two-decimal currency) is forwarded as it is, unrounded. The publisher shares the upside when a buyer bids above the floor, in the same proportion as it shares the floor price.