Available Fields

The following table describes the data recorded in each client audit log. Each row in the file contains a record for a single event, and each column contains a piece of collected data. For example, each row of an impression client audit log file contains details about a single impression, within the hour for which data was collected.

The columns below are listed in the same order in which they appear in the client audit log file:

Field Data Type Description
auction_id String

Unique identifier of associated auction.

timestamp String Timestamp in UTC.
country String Two-character ISO country code.
  • unknown = unrecognized country.
state String Code = state and province.
dma String Designated market area (DMA).
zip_postal String Zip or postal code.
device_type String The type of device from which the impression originated (desktop, mobile, or other).
operating_system String 3-character device operating system (unknown = unrecognized operating system).
browser String 3-character browser code (unknown = unrecognized browser).
partner_id Long IX publisher identifier.
site_id Integer IX site identifier.
creative_type String The type of advert being requested (banner or video).
domain String

Populated by the domain used in the bid request. Returns the top level domain with a public suffix. Example: x.adwords.google.co.uk returns google.co.uk, since co.uk is a public suffix. Similarly, a bid request made from myblog.blogspot.com returns the same domain, myblog.blogspot.com, since blogspot.com is a public suffix. This does not apply to in-app traffic.

 

n/a= not applicable.

app_bundle String

A platform-specific mobile application ID intended to be unique to the application. This dimension does not apply to web or mobile web traffic.

  • Android ID = string, package name
  • iOS ID = numeric identifier
  • N/A = not applicable
inventory_channel String

The environment through which the advert is shown:

supply_source String

The source of the bid request upstream from IX. Where the bid actually comes from. Possible sources include the following:

  • Direct(tag-based)
  • Adapter = publisher is using IX inside a third-party wrapper
  • Wrapper = publisher is utilizing the IX Library™
  • EBDA = publisher is using Google's EBDA product
  • Enterprise = publisher is using IX's enterprise product
  • Other
slot_id String

Identifier for the slot.

size String

The size of the advert, in pixels, being requested:

  • Display = width by height
  • Video = player width by height
event_type String

Denotes the type of event shared in the log file. An impression event is logged when an auction is won in the ad server and a creative is served on a page. A bid event is logged with the DSP's response to the bid request. Possible values in your client audit logs for impression events and bid events are below:

event_opportunity Double Bid value/opportunity value for the event type (bid value for bids and impressions).
gross_revenue Double

All revenue is measured in USD. Gross revenue for the publisher before share.

 

Note: This field is only available for log files associated with impression event types.

net_revenue Double

All revenue is measured in USD. Net revenue for the publisher. Gross IX revenue accounting for transaction_type.

 

Note: This field is not available in buyer logs.

Note: This field is only available for log files associated with impression event types.

dsp_id Integer IX DSP identifier.
trading_desk_id Long IX Trade Desk identifier.
campaign_id Long

Identifier for the campaign.

Note: The data in this field may be anonymized in some bid event log types, in which case the value will be -1.

campaign_name String

Campaign name mapping.

Note: This field is not available in bid event logs. Please refer to our Campaign Mappings service for name mappings.

brand_id Long

Identifier for the brand.

brand_name String

Brand name mapping.

Note: This field is not available in bid event logs. Please refer to our Campaign Mappings service for name mappings.

creative_id Integer

Identifier for the creative.

creative_name String

Creative name mapping.

Note: This field is not available in bid event logs. Please refer to our Campaign Mappings service for name mappings.

deal_id String

Corresponds to Open RTB dealid. An alphanumeric string that represents a private marketplace deal (that is, what IX signals to DSPs to bid upon). omitted = an event that doesn't have an applicable private marketplace deal.

p_id String Unique identifier for people-based IDs (only available in certain cases).
audience_id String Audience Identifier (only available in certain cases).
internal_deal_id Long

Internal IX deal identifier.

cookie_match_status String

Cookie match status.

  • matched = IX has a buyeruid for the corresponding DSP.
  • unmatched = IX doesn't have a buyeruid for the corresponding DSP.
a_domain String

Advertiser domain passed to IX from DSPs.

bid_stage String

Granular information about a bid response event, such as: bid error or blocked bid. Possible values in your client audit logs are listed below:

Note: This field is only available for log files associated with bid event types (for DSPs and buyers only).

min_bid_to_win Double

The bid you would have needed to submit in order to surpass all other bidders and seller-wide floors in the IX auction. This field is only included if your bid lost the auction.

Note: This field is only available for log files associated with bid event types (for DSPs and buyers only). Also, this field does not apply to auctions that were won by a deal bid.

page_url String

(Coming soon!)

URL of the webpage where the ad call originated.

Note: This field is only available for log files associated with impression event types.

Was this page helpful?

You are invited to take a 1-minute survey to help us improve this site.

START SURVEY