Transaction-Level (TLX) Reports
Transaction-level reports — TLX for short — are transaction-level exports. Where aggregated reports give you totals, percentages, and breakdowns by dimension, TLX gives you one row per transaction. They are the right tool when you need to investigate a specific cookie, transaction, or user ID, or when you want to join Pinokio data against your own logs by a high-cardinality identifier.
Some fields are only available through TLX — transaction ID, user ID, and any custom keys you pass.
What you get
Section titled “What you get”Each TLX run produces a single .csv file containing every transaction that occurred in the report’s time window and verdict from Pinokio with IVT codes for invalid transactions.
How to set up a TLX report
Section titled “How to set up a TLX report”TLX reports must be configured by Pinokio. Reach out to your Pinokio account manager with:
- the time window or cadence you want (daily, weekly, ad-hoc),
- which fields you need beyond the default set,
- how you want to access the files (Dashboard, API, or direct delivery).
How to access TLX files
Section titled “How to access TLX files”Once a TLX report is configured, files are available three ways:
- Reporting API — list and download via
/listand/get. TLX files appear alongside other report files. - Direct delivery — for high volume, Pinokio can deliver TLX files directly to your data warehouse or object store. Configured with your account manager.
- Dashboard — the Reports page has a Detailed tab where TLX runs appear. Each row has actions to download or delete.