Both reads are in beta for Seller Accounts on the beta profile. Elsewhere a
product carries no
forecast, and include: ["price_paid"] is refused with
FEATURE_NOT_ENABLED.Forecast
Everywholesale_product you read with get or search carries forecast:
the product’s delivery forecast exactly as its source reports it, in AdCP’s own
shape (DeliveryForecast: points, method, currency and the rest). Apostra
does not forecast again for a brief’s flight or targeting. When the source
reports no forecast, forecast is null.
Version
Everywholesale_product you read also carries version: the version of the
product’s authored content as your sales agent reports it. It changes when the
product’s own fields change, such as its name, its formats or its price
options, and not when its forecast or pricing availability syncs. A catalogue
product, and a product from a sales agent that does not report one, reads with
version: null.
The agent answering a buyer’s request reads each product at the version it
first read in that request. If the product changes while the agent is still
answering, its next read of that product is refused with CONFLICT,
details.reason catalog_stale, so a proposal is never built on two versions
of one product.
Pricing across buyers
Addinclude: ["price_paid"] to get(kind: "wholesale_product") or
search(kind: "wholesale_product") to read what buyers paid for each product.
It is summed across buyers and never shows what any one buyer paid.
pricePaid is null when the product has no CPM or vCPM list price, because
a per-thousand average cannot be compared with any other kind of price.
A buyer counts as having bought a product when its package booked that
product through the product’s own inventory source, under the product’s own id
or the storefront’s id for it. Two sources can use the same product id, so a
buy through one source never counts toward another source’s product. Each
day’s delivery counts toward the product the package booked on that day, so a
buy that later moves a package to another product keeps its earlier delivery
on the product it was booked under then. A day on which no version of the buy
was live has no booking to count under and is left out.