Using the Client Audit Logs API
Follow the steps below to use the CAL Client Audit Logs (CAL) API. An API that allows Index customers to retrieve log files for impression and bid event data. API:
|
CAL files are not generated by default. To start generating them, contact your Index Representative. Your Index Representative can also disable them for you if you've stopped using them. |
|
Complete authentication. Once you've started generating the logs, you'll need to complete authentication. |
|
Retrieve CAL files. Use the CAL API to retrieve your bid event or impression event log files using a two-step process. |
|
Review the list of fields in the Data dictionary to learn about your CAL data. |
|
Use the mappings service. You can use the CAL API's mappings service to retrieve the name mappings that correspond to your CAL file data. |
|
Use the exchange rate service. You can use the CAL API's exchange rate service to convert USD revenue measures in your CAL files into local currency. |
Note: CAL 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.