Buyer Reporting
advertiserReport
The advertiserReport query endpoint provides deal performance reporting for all deals associated with your TripleLift Account (aka Member), matching the capabilities of Reports for Advertisers in TripleLift Direct.
- Scope: Covers all deals created in your Account
- Capabilities: Filter and group using custom dimensions, metrics, and filter values.
Endpoint Summary
- Use the Synchronous endpoints when querying for low volumes of data, with relatively quick response times
- Use the Asynchronous endpoints when querying for larger volumes of data, returned within 5 minutes
Depending on your needs and workflow, use the query endpoints below to request data:
| Query Endpoint Name | Query Endpoint Type | Description |
|---|---|---|
advertiserReport |
Synchronous | Returns deal performance data, up to 5,000 rows |
advertiserFilterOptions |
Synchronous | Returns all possible filter IDs and values of a dimension, in a given time period, to be used in your queries |
asyncDownloadAdvertiserReport |
Asynchronous | Returns a high volume of data, up to 400MB, within 5 minutes; responds with a pre-signed S3 download link |
asyncDownloadReportStatus |
Asynchronous | Polling endpoint that accepts the pre-signed S3 link from the asyncDownloadAdvertiserReport response and returns the status of your report generation (READY, WAITING, or ERROR) |
asyncEmailAdvertiserReport |
Asynchronous | Returns a high volume of data within 5 minutes, up to 10MB; delivers the final CSV report to a specified list of valid email addresses |
Seller Reporting
publisherNetworkReport
The publisherNetworkReport query endpoint provides standard performance reporting, for all publishers, associated with your TripleLift Account (aka Member), matching the capabilities of the query tool in the TripleLift Console and the Web & Mobile reporting for Publishers in TripleLift Direct.
- Scope: Covers all seller activity within your Account
- Capabilities: Filter and group using custom dimensions, metrics, and filter values.
Endpoint Summary
- Use the Synchronous endpoints when querying for low volumes of data, with relatively quick response times
- Use the Asynchronous endpoints when querying for larger volumes of data, returned within 5 minutes
Depending on your needs and workflow, use the query endpoints below to request data:
| Query Endpoint Name | Query Endpoint Type | Description |
|---|---|---|
publisherNetworkReport |
Synchronous | Returns standard performance reporting for publishers, up to 5,000 rows |
publisherNetworkFilterOptions |
Synchronous | Returns all possible filter IDs and values of a dimension, in a given time period, to be used in your queries |
asyncDownloadPublisherNetworkReport |
Asynchronous | Returns a high volume of data, up to 400MB, within 5 minutes; responds with a pre-signed S3 download link |
asyncDownloadReportStatus |
Asynchronous | Polling endpoint that accepts the pre-signed S3 link from the asyncDownloadPublisherNetworkReport response and returns the status of your report generation (READY, WAITING, or ERROR) |
asyncEmailPublisherNetworkReport |
Asynchronous | Returns a high volume of data within 5 minutes, up to 10MB; delivers the final CSV report to a specified list of valid email addresses |
ctvPublisherNetworkReport
The ctvPublisherNetworkReport query endpoint provides performance reporting for CTV publishers, inclusive of many of the dimensions and metrics from the standard performance reporting, with the addition of ORTB content object and TripleLift video content metadata. Query for CTV supply activity associated with your TripleLift Account (aka Member), matching the capabilities of the CTV reporting for Publishers in TripleLift Direct.
- Scope: Covers all seller activity for CTV publishers within your Account
- Capabilities: Filter and group using custom dimensions, metrics, and filter values.
Endpoint Summary
- Use the Synchronous endpoints when querying for low volumes of data, with relatively quick response times
- Use the Asynchronous endpoints when querying for larger volumes of data, returned within 5 minutes
Depending on your needs and workflow, use the query endpoints below to request data:
| Query Endpoint Name | Query Endpoint Type | Description |
|---|---|---|
ctvPublisherNetworkReport |
Synchronous | Returns performance reporting for CTV publishers, up to 5,000 rows |
ctvPublisherFilterOptions |
Synchronous | Returns all possible filter IDs and values of a dimension, in a given time period, to be used in your queries |
asyncDownloadCTVPublisherNetworkReport |
Asynchronous | Returns a high volume of data, up to 400MB, within 5 minutes; responds with a pre-signed S3 download link |
asyncDownloadReportStatus |
Asynchronous | Polling endpoint that accepts the pre-signed S3 link from the asyncDownloadCTVPublisherReport response and returns the status of your report generation (READY, WAITING, or ERROR) |
asyncEmailCTVPublisherNetworkReport |
Asynchronous | Returns a high volume of data within 5 minutes, up to 10MB; delivers the final CSV report to a specified list of valid email addresses |