Skip to main content

​
Auction Result Schema

​
Overview

Winning bid response returned to AI platforms, including reservation info so platforms understand committed spend.

​
Required Fields

FieldTypeDescription
auction_idstringAuction identifier
serve_tokenstringToken used to track downstream events
ttl_msintegerResult time-to-live in milliseconds

​
Winner Object

FieldTypeDescription
brand_agent_idstringWinning Brand Agent
preferred_unitstringRequested billing unit (CPX, CPC, CPA)
reserved_amount_centsintegerAmount placed on hold at auction time

​
Render Object

FieldTypeDescription
labelstringDisclosure label ([Ad])
titlestringCreative title
bodystringCreative description
ctastringCall-to-action text
urlstringTracking/deep link URL

​
Optional Fields

FieldTypeDescription
no_bidbooleanSet to true when no bidder responded
extobjectVendor extensions

​
Example

{
  "auction_id": "auc_981",
  "serve_token": "stk_abcxyz123",
  "winner": {
    "brand_agent_id": "ba_451",
    "preferred_unit": "CPA",
    "reserved_amount_cents": 500
  },
  "render": {
    "label": "[Ad]",
    "title": "Scale your CRM",
    "body": "Built for founders.",
    "cta": "Try for free",
    "url": "https://admesh.click/stk_abcxyz123"
  },
  "ttl_ms": 60000
}

​
Validation Rules

  • ttl_ms must be between 1,000 and 300,000
  • preferred_unit must be CPX, CPC, or CPA
  • reserved_amount_cents must be an integer ≥ 0
  • When no_bid is true, winner and render should be omitted