Auction & Impression Tracking
Auction π
Price model is always first-price, indicated via the at:1
field in bid requests.
Impression Trackers π
Impression tracking URL requests are sent immediately upon rendering the impression. There are two options to provide these URL(s) in bid responses: 1) as a URL in the bid.burl
field, or 2) as an array of URL(s) in the bid responseβs seatbid[].bid.ext.imptrackers
field. There is no difference between the options functionally, so you may use whichever suits your requirements.
POST
method with a query string (no body); later SDKs are sent as standard GET
method with the same query string. Therefore, please ensure your impression tracking endpoint supports receiving a POST
method request with query string parameters.
Impression Pixels π
Bidders are free to include impression tracking pixels in their ad markup. These are fired only when the ad gets rendered on the screen, as we do not support any pre-caching of ad content. However, for billable impression tracking, DSPs must use the burl
or ext.imptrackers
URLs. Pixels embedded in ad markup should not be relied upon as a primary tracking method and may lead to discrepancies.
Supported ext.imptrackers and burl macros π
${AUCTION_ID}
${AUCTION_BID_ID}
${AUCTION_IMP_ID}
${AUCTION_SEAT_ID}
${AUCTION_AD_ID}
${AUCTION_PRICE}
${AUCTION_CURRENCY}
${AUCTION_LOSS}