The Client Audit Logs (CAL Client Audit Logs (CAL) API. An API that allows Index customers to retrieve log files for impression and bid event data.) service is a programmatic-based method of accessing non-aggregated data for all events on the Index Exchange (Index) 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.
CAL frequency
CAL files are available within 36 hours of the event and retained for 14 days, after which they are automatically purged. The CAL data is stored on Index servers and can be retrieved using our CAL API.
Batch data
Index processes and delivers large amounts of log-level data incrementally in batch CSV files. Because CAL uses batch processing to deliver data, it has a fast turnaround time. CAL also provides you with the ability to view raw event logs, generate data insights, run data science projects, and customize your reporting on top of the Index platform, for example, by running your own aggregations.
CAL log types
CAL files include non-aggregated data 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 Index Representative know which event type(s) you'd like to subscribe to.
Note: In some cases, partners may request for the obfuscation of certain data fields within CAL. These fields will be shown as shown as -1 or XXXX.
Impression events
An impression event is logged when an auction is won in the ad server A platform that manages, stores, and delivers advertisements to a publisher's site. and a creative A digital ad made available in various creative types, defined by their size in pixels such as 300x250px. is served on a page.
Bid events
A bid event is logged when a DSP Demand-Side Platform (DSP). A software platform that automates bidding decisions in real-time and efficiently connects buyers and audiences through an ad exchange or SSP. Also known as a buy-side platform. submits a bid response An OpenRTB response that is sent by the DSP in response to the SSP's or ad exchange's bid request. It is an event directed back to the seller expressing a valuation for the request and conditions of sale. to Index.
