Client Audit Logs
While Index has always provided log level data upon request, the client audit log service is a new programmatic-based method of accessing non-aggregated data for all events on the Index Exchange (IX) platform. This data provides publishers, buyers, and data providers the ability to build more personalized insights, run sophisticated data science projects, or use customized and consolidated reporting products.
Availability, Storage, and Deletion
Client audit logs are available within 36 hours of the event and retained for 14 days, after which they are automatically purged. The client audit log data is stored on IX servers and can be retrieved using our API.
Batch vs Streaming Data
Our other reporting products, such as Domo, use batch data, which is grouped and presented to you in a way that's easy to digest. Client audit logs use streaming data, which is non-aggregated. Unlike batch data, streaming data requires additional cost and complexity to understand the logs, but allows for faster turnaround time and the ability for you to build your own custom reporting features on top of the IX platform. So, if you're looking to customize your own reporting (and have the technical prowess required to work with them), client audit logs are the way to go.
Client audit log files include data that is not aggregated about your impression events and bid events. You can subscribe to just one event type or to both. If you subscribe to both, you can expect to see two logs per event, per hour— or, 48 logs per day. If you subscribe to one, you'll see 24. Let your IX Representative know which event type(s) you'd like to subscribe to.
- 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 when a DSP submits a bid response to IX.
If you're a publisher, you'll see the top five (by CPM) bids submitted for each auction in your bid events logs. If you're a buyer, you'll see all the bids you submitted to IX in your bid events logs.
Start Generating Client Audit Logs
Client audit log files are not generated by default. To start generating them, reach out to your IX Representative. Find that you're not using the logs? No problem. Your IX Representative can also disable them for you.
Client Audit Log generation is automatically paused following a period of 35 days of inactivity with the API. This applies to authentication, file listing, and download routes. Hitting any of these three routes automatically re-enables data generation.
Retrieve Client Audit Logs
Once you've started generating the logs, you'll need to complete authentication so that you can use our API to retrieve the log files using a two-step process. For more information, see Log Retrieval.