Use cases for log-level files

Log-level files are granular data reports containing details for lost bids and impressions, associated with an agency's activity. 

There are a number of reasons why log-level files are useful:

• Facilitate industry studies: Log-level files provide necessary granular data when an advertiser is participating in audits which require log-level data from SSPs. These studies often provide advertisers a view into their working media and total supply chain fees, which can be used to confirm fees are within an expected range.
• Support agency audits: They enable access to data required when a holding company is undergoing a formal audit.
• Fee transparency: Their use ensures fees are within a reasonable and expected range.
• Performance optimization: They enable bidding history analysis to improve performance.

On this page:

• Log-level files in GCS
• How to pull files from GCS
• Contents of GCS files

Log-level files in Google Cloud Storage

Google adds log-level files to a Google Cloud Storage (GCS) bucket daily with a 2-month look back window. They then give  the bucket name to the agency and provide access to agency users by adding admin users in the Agency Seat user interface.

If an agency finds corrupt data in the file, it must be reported to Google within 30 days to ensure we can correct the data.

How to pull files from GCS

In the Google Cloud console, go to the Cloud Storage Buckets page.

1. Go to Buckets.

2. In the list of buckets, click the name of the bucket that contains the object you want to download.

3. The bucket details page opens, with the "Objects" tab selected.

4. Navigate to the object, which may be located in a folder.

5. Click the download icon associated with the object.

Your browser settings control the download location for the object.

Contents of GCS files

GCS files contain the following fields: