Skip to main content
GET /api/v2/buyer/campaigns/{campaignId}/seller-scorecard Answers “how did each seller do in this campaign?” Every seller you bought from in the campaign gets four scores, each judged on its own: delivery, price, performance and quality. Each score carries its value, the seller’s rank among the campaign’s sellers on that score alone, and who counted it. There is no blended score. A seller that costs more but performs better should read as exactly that, two different answers, and a single number would hide the trade-off. The scorecard uses only your own media buys in the campaign. It never uses other buyers’ results, so it needs no minimum number of buyers behind a figure. For how sellers are judged on the goal itself, see Goal-seeking campaigns.
V3 beta. The scorecard is open to buyers enrolled in the V3 beta. Any other account is refused with 403 FEATURE_NOT_ENABLED.

​
Request

​
Parameters

Without dates, the scorecard covers the campaign’s whole reported life.

​
Response

Each entry in sellers: Every score has the same shape. Here it is under delivery; price, performance and quality carry the same fields: A score with no data is not reported. It is never zero. It has no value and no rank, and the seller is not counted in rankedAmong, so a missing score never drags a seller down or pushes another seller up.

​
Delivery

Did the seller deliver what you booked, on time? Delivery ranks on how far ratio is from 1, so under-delivery and over-delivery both rank lower than delivery on pace.

​
Price

What you paid per unit of the campaign’s primary goal: per click for a click goal, per completed view for a completed-view goal, and so on. When the goal names something delivery cannot price, such as a purchase event, a viewable rate or a vendor’s metric, or when the campaign has no goal, the price is per thousand impressions (eCPM). Every seller in one scorecard is priced in the same unit. Price ranks cheapest first. A seller that delivered fewer units than goal progress needs to give a verdict (for example 100 clicks or 20 leads) shows its price but is not ranked on it. A seller that did not report the unit has no price.

​
Performance

Did the seller’s media buys meet your goal? The value is the seller’s goal progress, judged over all its media buys in the campaign together, with the same rules as the campaign’s own goal progress. When your measurement records count a vendor-measured goal, only records that name one of the seller’s media buys count toward it. A record for the whole campaign cannot be split between sellers. Performance ranks only sellers whose goal was judged: a lower cost ranks higher for a cost target, and a higher rate ranks higher for a rate target. When the goal’s metric was not reported, the goal progress is still returned so that verdictWithheld and freshness.missingMetrics say why, and the rank is withheld as not_reported.

​
Quality

Was the delivery viewable, valid and brand safe? Quality is not judged yet, so it always reads as not reported.

​
Errors

  • 400 VALIDATION_ERROR: a malformed or impossible startDate or endDate (such as 2026-02-31), or a startDate after endDate.
  • 403 FEATURE_NOT_ENABLED: the account is not enrolled in the V3 beta.
  • 404 NOT_FOUND: no live campaign with this id on your account.
  • 422 SPEND_DENOMINATION_UNRESOLVED and 503 FX_RATE_UNAVAILABLE: as for Get reporting metrics, which reads the same delivery.
See Errors for the full error contract.

Get reporting metrics

The same delivery and goal progress, per media buy and campaign

Goal-seeking campaigns

How goals are stated, answered and judged