Auction Logs

An Auction Log contains a record of an auction conducted while making a Selection. The log contains data for all bids (eligible ads) in the auction as well as pricing data and the Ad ID of the winning bid.

📘

Fields with null values may be omitted from the log.

Name

Description

Sample Data

Type

AuctionId

A unique ID generated for this auction.

9fcd9ecf6a07456dbde293125d00e684

string

Bids

All the bids (ads) that participated in the auction.

See table below

array of objects

DecisionId

The Decision in which the auction took place. Can be correlated with Decision logs.

75a6018c58744c96980eae90a44052a1

string

FloorPriceCpc

The CPC Floor Price of the auction. Defaults to 0 if not set.

0

float

FloorPriceEcpm

The Floor Price of the auction (in ECPM units).

0

float

IsSecondPriced

If the auction uses Second Pricing

true

boolean

Meta:schema

The type of log - will always be auction

auction

string

Meta:version

The version of the Auction Logs feature

2.0

float

MinBidIncrement

If a Second Price auction, the amount the winner bids over the next highest priced bid. Default is 0.01.

0.01

float

NetworkId

The network ID of the auction.

12345

integer

PriorityId

The priority ID of the auction.

123456

integer

PriorityType

The type of priority. One of auction, auction-chain, or lottery-with-outbid.

auction

string

RemainderPercentage

The remainder percentage of the priority.

10

float

RequestId

The Request in which the auction took place. Can be correlated with Request logs.

aaa5c51a3b5611ecbed0347df66a4708

string

SecondPriceExclusion

If the auction is a second price auction, where the pricing exclusion rules are applied.

advertiser

string

SelectionId

Id for each selection within the auction. The value will be 'null' for bids which are not selected. For selected bids it is the same as the ID for the bid in the selection logs, and the same as the ImpressionID.

“7fb50ca376064d9ba5
0005e24535f4c9”

string

SelectionsRequested

The count parameter of the Decision API request, i.e. how many placements were requested.

2

integer

SiteId

The site ID of the auction.

12345

integer

UserKey

The identifier associated with the user record in UserDB

ue1-9040e0cc7c6a45afbf2ca1f40a67b75c

string

Timestamp

The time when the auction was run as a Unix timestamp

1748736000245

integer

Bids

Name

Description

Sample Data

Type

AdId

The ad ID of the bid.

12345678

integer

AdvertiserId

The advertiser ID of the bid.

123456

integer

BurnIn

Whether the ad was in burn-in mode when the auction was conducted.

true

boolean

CampaignId

The campaign ID of the bid.

1234567

integer

ClearPriceEcpm

The Clear Price of the winning bid (in eCPM units). If a bid was not a candidate during the auction, the value will be null and Excluded will contain the reason.

1000.01

float

DecisionIdx

The Decision Index. If the Decision generates only one Selection (i.e. it does not originate from a multi-winner placement) then the DecisionIdx will always be 0. For multi-winner placements, the DecisionIdx will be the order of the Selection within the Decision (zero indexed).

0

integer

Ecpm

The eCPM of the ad at the time it competed in the auction.

2000

float

EcpmMultiplier

Value used to artificially inflate eCPM value.

2

integer

EcpmPartition

The eCPM Partition if applied to the bid.

landing-page

string

Excluded

The reason for the exclusion if a bid was not a candidate for the auction. See the "Excluded Reasons" table below.

not selected

string

FlightId

The flight ID of the bid.

12345678

integer

IsRtb

Whether the ad originated from an RTB advertiser/bidder.

false

boolean

Price

The Price of the ad, sourced from the ad's flight.

2000

float

Rank

Ecpm * RelevancyScore. The bid with the highest Rank will win the auction.

1000000

integer

RateType

The RateType enum of the ad's flight.

3

integer

RelevancyScore

The Relevancy Score of the ad. The default is 500. Ranges from 1 to 1000.

500

integer

RemainderWeight

The likelihood that an ad will be selected as part of the Remainder Percentage. The Remainder Weight starts large and drops linearly as an ad gets more impressions. It reaches a minimum when an ad completes its burn-in impressions.

Ranges from 0 to 100M.

100000000

integer

SelectedAsRemainder

If the selected ad was chosen as part of the Remainder Percentage.

true

boolean

Excluded Reasons

StringExplanation
not foundThe ad did not enter the selection process at all (due to targeting rules, pacing, etc.)
not selectedThe required number of winners were filled so the ad could not serve.
excluded by no-duplicates ruleThe ad could not be selected because it is in conflict with a no-duplicates rule configured on another ad that was already selected for this decision.
advertiser placement limitThis ad cannot serve because the maximum number of ads for this advertiser have already been selected for this decision.