Skip to main content
If you sell inventory that a publisher owns, the publisher is owed a share of its price under your deal. Publisher deal terms record that share on the managed inventory source. A product over the source then sells at the source’s cost marked up to the share, and your buy goes to the publisher at the publisher’s price. You keep the difference.
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. Send dealTerms 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_bookable and 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 (save dealTerms: 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 under retiredProducts (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.