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
| String | Explanation |
|---|---|
| not found | The ad did not enter the selection process at all (due to targeting rules, pacing, etc.) |
| not selected | The required number of winners were filled so the ad could not serve. |
| excluded by no-duplicates rule | The 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 limit | This ad cannot serve because the maximum number of ads for this advertiser have already been selected for this decision. |
Updated 3 months ago