Auction Logs Schema

HeaderPositionDefinitionSQL DatatypeDDL Desc
ad_position1If applicable, ad position on pageVARCHAR(255)
app_bundle2Application bundle or package name (e.g., com.foo.mygame). This is intended to be a unique ID across multiple exchanges.VARCHAR(255)
app_id3Application ID on the exchange. For uniqueness, Uses ad exchange/SSP identifier as prefix e.g. pm/ representing pubmaticVARCHAR(255)
app_name4Mobile app nameVARCHAR(255)
auction_id5Unique ID for every auction in the system. A joining key for all the events associated with the auction, like impression, clicks, and activities.VARCHAR(255)
bid_time6Time of bid request sent, YYYY-MM-DD HH:MM:SS in ET timezoneTIMESTAMPYYYY-MM-DD HH24:MI:SS.MS in ET
category7CSV of IAB-defined content categories: http://www.iab.com/guidelines/iab-quality-assurance-guidelines-qag-taxonomy/; determine type of content associated with a particular slice of inventoryVARCHAR(255)
content_coppa_flag8Children’s Online Privacy Protection Act (COPPA) Flag; inventory with this flag carries several ad quality limitationsBOOLEAN
content_language9Language in which content associated to the impression is written (as declared by the publisher)VARCHAR(255)
content_rating10Content parental rating (as declared by the publisher)VARCHAR(255)
domain11Domain name from which a given impression originatedVARCHAR(255)
environment_type12Environment type (APP or WEB)VARCHAR(255)
geo_city13City geo code IP address. MaxMindDB Lookup dataVARCHAR(255)
geo_country14Country geo name IP address. MaxMindDB Lookup dataVARCHAR(255)
geo_metro15Metro geo code IP address. MaxMindDB Lookup dataVARCHAR(255)
geo_region16Geo region name IP address. MaxMindDB Lookup dataVARCHAR(255)
geo_zip17Zip code IP address. MaxMindDB Lookup dataVARCHAR(255)
inventory_interstitial18determines if ad tag responsible for the impression accepts interstitial creatives or not; 1 for yes, 0 for noBOOLEAN
inventory_source19Inventory source - exchange nameVARCHAR(255)
inventory_source_relationship20Inventory source relationshipVARCHAR(255)
ip_address21IP address provided by the exchange during the auction. When no IPv4 address is present, the value is set to '0.0.0.0'VARCHAR(255)
ip_range22IP address provided by the exchange during the auction (same as ip_address)VARCHAR(255)
placement23Placement ID/name, as provided by the publisher. Prefixed with exchange handle.VARCHAR(255)
platform_bandwidth24Shows whether the browser is using wifi or carrier to establish connection with internet to generate the impressionVARCHAR(255)
platform_browser25Name of browser used during the auction for the impression at handVARCHAR(255)
platform_browser_version26Version of browser used to during the auction for the impression at handVARCHAR(255)
platform_carrier27If the device is using a mobile carrier to establish internet connection, this field will identify which carrier is usedVARCHAR(255)
platform_device_didmd528Hardware device ID (e.g., IMEI); hashed via MD5VARCHAR(255)
platform_device_didsha129Hardware device ID (e.g., IMEI); hashed via SHA1VARCHAR(255)
platform_device_dpidmd530Platform device ID (e.g., Android ID); hashed via MD5VARCHAR(255)
platform_device_dpidsha131Platform device ID (e.g., Android ID); hashed via SHA1VARCHAR(255)
platform_device_idfa32iOS app ID; "Identifier for Advertisers"; deprecatedVARCHAR(255)
platform_device_ifa33ID sanctioned for advertiser use in the clear (i.e., not hashed)VARCHAR(255)
platform_device_make34Make of the device used to generate the impressionVARCHAR(255)
platform_device_model35Model of the device used to generate the impressionVARCHAR(255)
platform_device_screen_size36Screensize of the device used to generate the impressionVARCHAR(255)
platform_device_type37Type of the device used to generate the impressionVARCHAR(255)
platform_js38Indicates whether the browser supports JavaScript or notBOOLEAN
platform_os39Operating system of the device used to generate the impressionVARCHAR(255)
platform_os_version40Operating system version of the device used to generate the impressionVARCHAR(255)
segment_id41AIDEM segment IDVARCHAR(600)
segment_user_id42AIDEM segment user IDINT2
site_id43ID of the site that generated the impression, as provided by the publisher. Prefixed with exchange handle for uniqueness.VARCHAR(255)
site_name44Name of the site that generated the impression, as provided by the publisherVARCHAR(255)
time_of_week45Time of week in GPS weekly time during which the impression occurred; internalINT2
user_id46Device ID for mobile, cookie for desktop. Will populate with cookie on a desktop OR an iOS/Android ID for mobileVARCHAR(255)
video_boxing_allowed47Indicates if letter-boxing of 4:3 content into a 16:9 window is allowed, where 0 = no, 1 = yesBOOLEAN
video_companion_required48A banner companion ad is required to accompany the video ad: 0=false, 1=trueBOOLEAN
video_playback_method49Video playback method, as determined by the publisher.VARCHAR(255)
video_player_size50Video player sizeVARCHAR(255)
video_start_delay51Indicates the start delay in seconds for pre-roll, mid-roll, or post-roll ad placementsINT2
test52Indicator of test mode in which auctions are not billable, where 0 = live mode, 1 = test modeBOOLEAN
placement_type53Placement type, indicates whether the placement is meant for banner, video ads, or bothVARCHAR(255)
geo_lat54Latitude associated with the impressionVARCHAR(50)
geo_long55Longitude associated with the impressionVARCHAR(50)
video_min_duration56Minimum duration of the video creative, as allowed by the publisherINT4
video_max_duration57Maximum duration of the video creative, as allowed by the publisherINT4
video_player_width58Width of the video player that is responsible for generating the impressionINT4
video_player_height59Height of the video player that is responsible for generating the impressionINT4
banner_width60Width of the banner placement tagINT4
banner_height61Height of the banner placement tagINT4
banner_width_max62Maximum width of the banner placement, as allowed by the publisherINT4
banner_height_max63Maximum height of the banner placement, as allowed by the publisherINT4
banner_width_min64Minimum width of the banner placement, as allowed by the publisherINT4
banner_height_min65Minimum height of the banner placement, as allowed by the publisherINT4
dnt66Do Not TrackINT4
geo_type67LocationType, how the geographic information was determinedVARCHAR(20)
bid_time_epoch_in_usecs68bid timestamp(epoch) with microsecond precision. Allows the customer to calculate the bid_time in any timezone instead of relying on bid_time field which is ET timezoneINT8
page_url69URL of the page responsible for the auctionVARCHAR(255)
exchange_predicted_view_rate70Predicted Viewability Rate of the impression within the auction, as determined by the exchange-auctionerNUMERIC(18,6)
available_deal_ids71Comma-separated list of all the available deal IDs on the associated Bid RequestVARCHAR(255)
battrs72Creative attributes that are blocked by the publisher, as declared by the publisherVARCHAR(255)
exchange_auction_id73Auction ID generated by the auction host ; different to that of AIDEMVARCHAR(255)
rewarded74States whether the placement tag behind the impression is meant for rewarded adsINT2
ua75User agent header that is passed along by the browser to the auction host when an impression is generatedVARCHAR(255)
bid_floor_micros76The floor or lowest allowable clearing price of the auction. 1 USD = 1,000,000 microsINT8
bid_floor_currency77If the bid floor is specified and multiple currencies are supported per bid request, the currency of the bid floor using ISO-4217 codesVARCHAR(10)
display_manager78Name of the ad mediation partner, SDK technology, or player responsible for rendering ad (typically video or mobile). Used by some ad servers to customize ad code by partner.VARCHAR(255)
display_manager_ver79Version of display_managerVARCHAR(255)
exchange_device_make80Device make provided by the exchange, e.g. "Apple"VARCHAR(255)
exchange_device_model81Device model provided by the exchange, e.g. "iPhone"VARCHAR(255)
user_id_type82A string representation (enum) of the type of user ID. "BEESWAX" for cookie ID. e.g. AD_ID, IDFA, IDFA_SHA1, BEESWAXVARCHAR(20)
auction_type83If 1, first price auction. If 2, second price auction. Additional auction types cna be defined as per the exchange's business rulesINT4
publisher_id84Publisher ID on the exchange. Prefixed with the exchange handle for uniquenessVARCHAR(255)
ads_txt85Ads.txt status for the request. It is an enum field, and can be one of the following values: UNKNOWN - The request was not augmented by the ads.txt augmentor (should never happen) NO_DOMAIN - The request does not contain a domain, either because it is not a web request (ie it is an app or native request) or it is a web request but does not contain a domain NO_ADS_TXT_FILE - The request's domain does not have an Ads.txt file ADS_TXT_NOT_SCANNED - We have not looked up the Ads.txt file for the request's domain NO_ADVERTISING_ALLOWED - The request's domain does not allow any advertising MISSING_PUB_ID - The request is missing a publisher id so we cannot check its Ads.txt status NOT_AUTH - The request's domain does have an Ads.txt file, but it does not allow advertising from this exchange / publisher ID combination AUTH_RESELLER - The domain's Ads.txt file allows this exchange / publisher ID to resell advertising AUTH_DIRECT - The domain's Ads.txt file allows this exchange / publisher ID to advertise directlyVARCHAR(20)
matched_user_groups86Matched user IDs for match tables hosted by AIDEMVARCHAR(255)
ipv6_address87IPv6 address provided by the exchange during the auction. When no IPv6 address is present, the value is set to '0:0:0:0:0:0:0:0'VARCHAR(255)
user_id_hashed88GDPR-compliant hashed user_idVARCHAR(255)
ip_address_hashed89GDPR-compliant hashed ipVARCHAR(255)
ipv6_address_hashed90GDPR-compliant hashed ipv6VARCHAR(255)
is_gdpr91When this field is set to true, AIDEM has determined that this request needs to comply with GDPRINT2
gdpr_consent_string92The raw IAB GDPR consent string as provided in the bid requestVARCHAR(255)
request_id93Unique ID for every bid request in the system. A joining key for all the events associated with the bid request, like impression, clicks, and activities. Note that it is possible to have multiple auction_ids for a single request_idVARCHAR(255)
person_linked_ids94Deprecated; will not be populated.VARCHAR(600)
household_linked_ids95Deprecated; will not be populated.VARCHAR(600)
video_protocols96Comma-separated list of video protocols that are accepted by the publisherVARCHAR(255)
banner_top_frame97Indicates if the banner is in the top frame as opposed to an iframeINT2
user_time_of_week98Time of week in GPS weekly time during which the impression occurred using the user's timezone; internalINT4
bid_time_utc99Time of bid request sent, in UTC timezoneTIMESTAMPYYYY-MM-DD HH24:MI:SS.MS in UTC
inventory_source_user_id100Unique consumer ID of the user, as defined by the exchange.VARCHAR(255)
mccmnc101Mobile carrier as defined by the concatenated MCC-MNC code.VARCHAR(255)
us_privacy102US Privacy String as defined by the IAB CCPA Compliance Framework, and used to define the regulatory context governing the personal data contained within the associated bid request.VARCHAR(255)
video_placement103The placement of the video impression (e.g., In-Stream)VARCHAR(255)
experiment_user_index104Random number between 1-1000 assigned to a user. Used for test group assignmentINT4
publisher_name105Publisher Name as specified on the OpenRTB request.VARCHAR(255)
carrier106The device's carrier as specified via the OpenRTB protocolVARCHAR(255)
platform_device_ifa_type107The type of IFA in platform_device_ifa, per the IAB's IFA Guidelines.VARCHAR(255)
deal_bid_floors108Comma-separated list of the bid floors for the available deal IDsVARCHAR(255)
seller_id109The value of the corresponding seller in sellers.json files. Only populated when the exchange uses a different value for this than in Publisher ID.VARCHAR(255)
data_center110The data center the auction was received by.VARCHAR(255)
site_referrer111The referrer to the site the auction occurred on.VARCHAR(255)
video_api112List of supported API frameworks for this impression.VARCHAR(255)
require_native_video113Indicates whether the creative is native and requires a video creativeINT2
is_gdpr_consented114Whether the auction is regulated by GDPR AND the customer has been granted consent by the end user.INT2
qag_media_rating115If defined, contains the QAG Media Rating of the content as defined by OpenRTB spec.VARCHAR(255)
bcat116Blocked advertiser categories using the IAB content categories.VARCHAR(255)
platform_device_hwv117Hardware Version of the Device sent via OpenRTBVARCHAR(255)
platform_device_language118Browser language using ISO-639-1-alpha-2. Sent via OpenRTBVARCHAR(255)
platform_device_w119Physical width of the screen in pixelsINT4
platform_device_h120Physical height of the screen in pixelsINT4
platform_device_ppi121Screen size as pixels per linear inch.INT4
platform_device_pxratio122The ratio of physical pixels to device independent pixels.NUMERIC(18,6)
deal_ats123If the impression was purchased via a deal, this logs the auction type for all deals on the auction in the same order as the deal_ids column. 1 = First Price, 2 = Second Price, 3 = Fixed Price. Overrides "auction_type"
tmax124The required time in milliseconds for the bid to respond to the exchange to be considered in the auctionINT4
video_skippable125If the ad is a video ad, this field indicates whether the creative trafficked could have been skippable.INT2
is_skadnetwork126Flags whether the inventory is SKAdNetwork enabled.INT2
lmt127Limit Ad Tracking (LMT) is a device-level opt-out setting, that allows users to limit the amount of information sent from their device to ad exchanges (including omitting their device ID)INT2
banner_format128Comma-separated list of banner formats (wxh) that are accepted by the publisherVARCHAR(255)
content_id129ID uniquely identifying the contentVARCHAR(255)
content_episode130Episode numberVARCHAR(255)
content_title131Content titleVARCHAR(255)
content_series132Content seriesVARCHAR(255)
content_season133Content seasonVARCHAR(255)
content_genre134Genre that best describes the contentVARCHAR(255)
content_contentrating135Content rating (e.g., MPAA)VARCHAR(255)
content_keywords136Comma separated list of keywords describing the contentVARCHAR(255)
content_livestream1370 = not live, 1 = content is live (e.g., stream, live blog)INT4
content_len138Length of content in seconds; appropriate for video or audioVARCHAR(255)
content_network_id139ID of the network the content is on. This may not be a unique identifier across all supply sourcesVARCHAR(255)
content_network_name140Network the content is on (e.g., a TV network like “ABC")VARCHAR(255)
content_network_domain141The primary domain of the network (e.g. “abc.com” in the case of the network ABC).VARCHAR(255)
content_channel_id142ID of the channel the content is on. This may not be a unique identifier across all supply sourcesVARCHAR(255)
content_channel_name143Channel the content is on (e.g., a local channel like “WABC-TV")VARCHAR(255)
content_channel_domain144The primary domain of the channel (e.g. “abc7ny.com” in the case of the local channel WABC-TV)VARCHAR(255)
content_cat145Array of IAB content categories that describe the contentVARCHAR(255)