> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Publisher deal terms

> Record the share of its price a managed inventory source's publisher is owed, so your products sell at a markup over the publisher's price and your margin reflects the deal you made.

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.

> [!NOTE]
>
> 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.

```json theme={null}
{
  "id": "encypher-gam",
  "dealTerms": { "publisherSharePercent": 70 }
}
```

`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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.