Optionaladcp_The AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.
Client-generated unique key for this request. If a request with the same key has already been accepted, the server returns the original response without re-processing. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request. Prevents duplicate billing on retries.
One or more usage records. Each record is self-contained: it carries its own account, allowing a single request to span multiple accounts.
Optionalmedia_buy_id?: stringSeller-assigned media buy identifier. Links this usage record to a specific media buy.
Amount owed to the vendor for this record, denominated in currency.
ISO 4217 currency code.
Optionalpricing_option_id?: stringPricing option identifier from the vendor's discovery response (e.g., get_signals, list_content_standards). The vendor uses this to verify the correct rate was applied.
Optionalimpressions?: numberImpressions delivered using this vendor service.
Optionalmedia_spend?: numberMedia spend in currency for the period. Required when a percent_of_media pricing model was used, so the vendor can verify the applied rate.
Optionalsignal_agent_segment_id?: stringSignal identifier from get_signals. Required for signals agents.
Optionalstandards_id?: stringContent standards configuration identifier. Required for governance agents.
Optionalrights_id?: stringRights grant identifier from acquire_rights. Required for brand/rights agents. Links usage records to specific rights grants for cap tracking, billing verification, and overage calculation.
Optionalcreative_id?: stringCreative identifier from build_creative or list_creatives. Required for creative agents. Links usage records to specific creatives for billing verification.
Optionalproperty_list_id?: stringProperty list identifier from list_property_lists. Required for property list agents. Links usage records to specific property lists for billing verification.
OptionalcontextOptionalext
Reports how a vendor's service was consumed after campaign delivery. Used by orchestrators (DSPs, storefronts) to inform vendor agents (signals, governance, creative) what was used so the vendor can track earned revenue and verify billing. Records can span multiple accounts and campaigns in a single request.