|NOTICE: This file is deprecated and has been replaced by an Excel file downloadable on Github here.|
|Log Type||Description||Delivery Method(s)||Expected Delivery Timing||Delivered Via||S3 Bucket Requirements||Delivery Format Options||Log Headers Google Docs||Log Headers GitHub||More information|
|Wins||The winning auctions, impressions, clicks, and events (video plays, etc)||Batch - Hourly||Batched logs are created via two different processes: the processing of the bid (which can take up to 4 hours), and the joining of the bid with clicks and events (which can take up to three hours). As a result, at most we expect a 7.5 hour window from bid_time to log delivery (including 30 min for file writing). Events after 3 hours are not included in logs.||S3||Single bucket across regions||Gzipped CSV||Google Doc||auction_log_headers.csv||Batch files are joined, which means bid, click and activity data matched against impression data will be included.|
|Batch - Daily||Between 6-7am ET (6am during daylight savings time, 7am during non-DST periods)||S3||Single bucket across regions||Gzipped CSV|
|Realtime - Unjoined||Realtime||HTTP or Kinesis Stream||N/A||Protobuf (or JSON for HTTP)||GitHub Proto||Does not include the RequestLogMessage (Auction Message) mentioned in GitHub.|
New information (clicks, activities) are sent as separate messages and are never "joined" back an impression.
|Realtime - Joined||Realtime||HTTP or Kinesis Stream|
(Kinesis Streams must be in the US-EAST-1 region)
|N/A||Protobuf or JSON||RequestLogMessage will be included 99%+ of the time and sent alongside the ImpressionLogMessage.|
As more information is received about the win event (clicks, activities), the message will be-resent joined with the additional information. i.e., It is possible receive new messages for the same Auction ID multiple times.
|Attributed Conversions||The conversions events recorded by Beeswax. Conversions will be attributed to an auction.||Batch||~8 Hour delay||S3||Single bucket across regions||Gzipped CSV||Google Doc||conversion_log_headers.csv||These logs are unjoined, and will need to be joined by the client with the win logs for custom attribution.|
|Conversions||The conversions events recorded by Beeswax. Conversions will not be attributed.||Batch||Near real-time||S3||Buckets must be co-located in US-EAST-1, US-WEST-2, EU-WEST-1, or AP-NORTHEAST-1||Gzipped CSV||Google Doc||conversion_log_headers.csv||These logs are unjoined, and will need to be joined by the client with the win logs for custom attribution.|
|Bid Response Feedback (aka "Loss Logs")||Loss logs provided by a limited number of exchanges (currently only Google)||Batch||~1 Hour delay||S3||Single bucket across regions||Gzipped CSV||Google Doc||bid_response_feedback_log.csv||Google documentation on feedback logs.|
|Bids||The bids returned from Beeswax to the exchange, whether the auction was won or not.||Batch||Near real-time||S3||Buckets must be co-located in US-EAST-1, US-WEST-2, EU-WEST-1, or AP-NORTHEAST-1||Gzipped CSV||Google Doc||bid_log_headers.csv||Bid logs are mainly used to calculate win rates on any dimension that comes through on the bid & win logs, which you can then use to improve your bidding strategies. Often, clients that use a custom bidding agent will log the bids themselves.|
|Auctions||The auction request from the exchange, normalized to OpenRTB fields.||Batch||Near real-time||S3||Buckets must be co-located in US-EAST-1, US-WEST-2, EU-WEST-1, or AP-NORTHEAST-1||Gzipped CSV||Google Doc||auction_log_headers.csv||Auction Logs can be used for inventory analytics. You can use the data to inform future bidding strategies. Importantly, per your agreement with Beeswax, these logs can never be used to create derivative segments for your use or resale. For example, you may not record the User IDs that come through on the bid requests and retarget those users in a different auction.|
|Segments||All 1st party and 3rd party segments available on the auction||Batch||Near real-time||S3||Buckets must be co-located in US-EAST-1, US-WEST-2, EU-WEST-1, or AP-NORTHEAST-1||Gzipped CSV||Google Doc||segment_log_headers.csv||Segment logs have two primary use cases. The first is for Audience Forecasting, and analyzing how segmented users appear in auctions. The second is for understanding and attribution of user segments that were not explicitly targeted on a line item but which were nevertheless available.|