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.
• Required Parameters: sellerMemberId, startDate, endDate

Refer to the GraphQL schema for the latest information on available endpoints, dimensions, and metrics.

publisherNetwork Endpoint Summary

Depending on your needs and workflow, use the query endpoints below to request data:

publisherNetwork Synchronous endpoints

These endpoints are designed to handle queries for low volumes of data and return results with relatively quick response times. When querying for larger volumes of data, use the Asynchronous endpoints.

Pagination

Synchronous endpoint results are paginated to a default page size of 50 rows. The size can optionally be set using the size parameter in a request (the value of which cannot exceed the row limit).

If the number of result rows is greater than the given page size, then the response will also include a nextCursor object, whose value can be passed in as the cursor field of the subsequent request.

publisherNetworkReport

Returns reporting data (e.g. the reporting available TripleLift Console or TripleLift Direct).

publisherNetworkFilterOptions

Returns all possible filter values of a dimension in a given time period.

publisherNetwork Asynchronous endpoints

These endpoints are designed to handle queries for high volumes of data and return results within 5 minutes. For quicker response times and low volumes of data, use the Synchronous endpoints.

There are two options to obtain a CSV report asynchronously:

1. Submit a request to an asynchronous endpoint and immediately receive a report download link. Poll a second endpoint until your report is ready at that download link.
2. Submit a request to an asynchronous endpoint and wait to receive an email containing the report.

asyncDownloadPublisherNetworkReport

This endpoint is used in Option 1, above. This endpoint uses the same parameters as the synchronous publisherNetworkReport endpoint (without the pagination-related fields cursor and size) and responds with a download link in the form of a pre-signed S3 URL.

Example request:

query {
  asyncDownloadPublisherNetworkReport(
    sellerMemberId: "YOUR_MEMBER_ID"
    startDate: "2024-06-15" 
    endDate: "2024-07-30"
    dimensions: [YMD, PUBLISHER_NAME]
    metrics: [AD_REQUESTS, REVENUE]
)
}

Example response:

{
  "data": {
    "asyncDownloadPublisherNetworkReport": "https://triplelift-reporting-api-downloads.s3.amazonaws.com/9629b338-a654-4f95-ac4f-8b9dfafeb3ca/1735843508921/triplelift_report.csv?X-Amz-Security-Token=IQoJb3JpZ2luXNyF2CRFuvpB430YDTbzZLAIgYBV4T2uFp4np4zZ471RwMNeby0c3%2By3sOTtfYmjRr%2FMqxgUI2%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAAGgwyNTU5OTMwMDUwOTEiDAdZ%2FwDCe8O1dvOekSqaBd9AC9BjQXtHukgmdGomyMnnW5qr72B617Xz976w10EfL3KyOyw9KRD5JSJt8Pz8FrRQ23131xlFF35YmH8OSIlvWWkNfGVJMk0vP8fvc7w99T6fgB5yF2KfMVufwH6Y8lQdd0o5%2BSLvG581NstAl7SzSaEuOIqo0j41qRkueVk2QZGX3t2lkkO4Gqmjq51lU3Oaue7Jl6D%2B%2Bag1%2BFOGGIclN%2BFvxE%2FfBVhLzC3R2GgEsIj2UBe5JMUwdubG9xuwCA09sySJecBcOYknyUT%2FuyLEPZ4IvyshDzZtqYJUW8VjnCFGxLKg5PBj6dcw7rRUVHKxv8PfAkOcyonWQv9yEg5NsDhQnxqJ8bwb9no3aL%2Bdr8EBUeAZhhazilmNpOK87sbg%2BaAxI2o4gIpaTYnAEA4hJpFu1FnNOD8pFMMZzURQaB1Rke4omarL93I7spcpWC20r%2F8vAFu7Ahf9JKt20ZKhx65Kpgvqgw5YjmWITw5K4tJjUpvnW234cuBuiFOwUaHovg%2BG9IjDuDZI5WyLCfKKe8gx3glLK6ZNF8h2FD6vUBAD8XJzo31ARDhcdytwke71h%2BlAsGng6A7Umt62mP%2B1yR%2B29Mw0bvngRjJiEk7xz%2FRFZeGkAwDL6lsmnfppzThir3BYyj0WHdpl9TzuD%2Bxy0%2BgKTJ7Amik1qSvJSfu5kHVthjIfQcD%2FOh%2Fmh4cSFP%2F7g7c24nYE1kUL4SuV2DkpbOJhWR4CNm9gloOEcTmNB79YascR%2FeogWaIO9uS9PvHN%2BlCB%2BNNDOIysQfn6h%2Foqd0AtQLp5bHP17FMzAnJk84fPhG4dBOWq56EB5ai1QC6ihsithiuerhstithre31HEadvXaXds9md9%2FPWOEBI2VbzN8Q3eG19yvzDKrdu7BjqxAWas1Pj8UcE%2B2kA42NrTK%2B3H17PnGJG%2FqXD4Rvcx2wC995mJFpJgDLOOkUNRbrp2MHjm3eshQ8F07BuDbq%2BiuI0LNuBHI0qFoK8%2FesX8mBXKURXmGRGsujZDtjNVwHhqRwmgYKjR5HeXbjUgkHfXMEkJPqupeonlfI%2Fb1Om%2B30f0E%2BT46rQxOb%2B4lK9KYFze2XQC%2Bkl19y5WU0RPD23jfqyA53T3M%2B1pNV6U%2FdjKNgdClQ%3D%3D&X-Amz-Algorithm=ABC-123-DFF&X-Amz-Date=20250102T184508Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1799&X-Amz-Credential=ASIIHHEIHTIHLWH%2F20250102%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=14b12cbd349dbbc36acac145778aaaaaaaaaa06f57716b15dba1814"
  }

asyncDownloadReportStatus

This is the polling endpoint mentioned in Option 1. It accepts the pre-signed S3 link in the response from asyncDownloadPublisherNetworkReport and returns one of 3 possible status strings:

• READY - the report is present in the download link
• WAITING - the report is not ready yet
• ERROR - the report request must be resubmitted

asyncEmailPublisherNetworkReport

This endpoint is used in Option 2. It uses the same parameters as the synchronous publisherNetworkReport endpoint (without the pagination-related fields cursor and size), as well as a list of valid email addresses for the report recipients. It returns true if the request was successfully received, and false otherwise.

Example request:

query {
  asyncEmailPublisherNetworkReport(
    sellerMemberId: "YOUR_MEMBER_ID"
    startDate: "2024-06-15" 
    endDate: "2024-07-30"
    dimensions: [YMD, PUBLISHER_NAME]
    metrics: [AD_REQUESTS, REVENUE]
    filters: []
    emails: ["EMAIL_1", "EMAIL_2"]
)
}

Example response:

{
  "data": {
    "asyncEmailPublisherNetworkReport": true
  }

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.
• Required Parameters: sellerMemberId, startDate, endDate

Refer to the GraphQL schema for the latest information on available endpoints, dimensions, and metrics.

ctvPublisherNetworkReport Endpoint Summary

Depending on your needs and workflow, use the query endpoints below to request data:

ctvPublisherNetworkReport Synchronous endpoints

These endpoints are designed to handle queries for low volumes of data and return results with relatively quick response times. When querying for larger volumes of data, use the Asynchronous endpoints.

Pagination

Synchronous endpoint results are paginated to a default page size of 50 rows. The size can optionally be set using the size parameter in a request (the value of which cannot exceed the row limit).

If the number of result rows is greater than the given page size, then the response will also include a nextCursor object, whose value can be passed in as the cursor field of the subsequent request.

ctvPublisherNetworkReport

Returns CTV reporting data (e.g. the reporting available TripleLift Direct Reports for CTV).

ctvPublisherFilterOptions

Returns all possible filter values of a dimension in a given time period.

ctvPublisherNetworkReport Asynchronous endpoints

These endpoints are designed to handle queries for high volumes of data and return results within 5 minutes. For quicker response times and low volumes of data, use the Synchronous endpoints.

There are two options to obtain a CSV report asynchronously:

1. Submit a request to an asynchronous endpoint and immediately receive a report download link. Poll a second endpoint until your report is ready at that download link.
2. Submit a request to an asynchronous endpoint and wait to receive an email containing the report.

asyncDownloadCTVPublisherNetworkReport

This endpoint is used in Option 1, above. This endpoint uses the same parameters as the synchronous ctvPublisherNetworkReport endpoint (without the pagination-related fields cursor and size) and responds with a download link in the form of a pre-signed S3 URL.

Example request

query {
  asyncDownloadCTVPublisherNetworkReport(
    sellerMemberId: "YOUR_MEMBER_ID"
    startDate: "2024-11-15" 
    endDate: "2024-12-15"
    dimensions: [YMD, PUBLISHER_NAME, ORTB_CONTENT_GENRE]
    metrics: [AD_REQUESTS, RENDERED, REVENUE, VIDEO_COMPLETIONS]
)
}

Example response

{
  "data": {
    "asyncDownloadCTVPublisherNetworkReport": "https://triplelift-reporting-api-downloads.s3.amazonaws.com/9629b338-a654-4f95-ac4f-8b9dfafeb3ca/1735843508921/triplelift_report.csv?X-Amz-Security-Token=IQoJb3JpZ2luXNyF2CRFuvpB430YDTbzZLAIgYBV4T2uFp4np4zZ471RwMNeby0c3%2By3sOTtfYmjRr%2FMqxgUI2%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAAGgwyNTU5OTMwMDUwOTEiDAdZ%2FwDCe8O1dvOekSqaBd9AC9BjQXtHukgmdGomyMnnW5qr72B617Xz976w10EfL3KyOyw9KRD5JSJt8Pz8FrRQ23131xlFF35YmH8OSIlvWWkNfGVJMk0vP8fvc7w99T6fgB5yF2KfMVufwH6Y8lQdd0o5%2BSLvG581NstAl7SzSaEuOIqo0j41qRkueVk2QZGX3t2lkkO4Gqmjq51lU3Oaue7Jl6D%2B%2Bag1%2BFOGGIclN%2BFvxE%2FfBVhLzC3R2GgEsIj2UBe5JMUwdubG9xuwCA09sySJecBcOYknyUT%2FuyLEPZ4IvyshDzZtqYJUW8VjnCFGxLKg5PBj6dcw7rRUVHKxv8PfAkOcyonWQv9yEg5NsDhQnxqJ8bwb9no3aL%2Bdr8EBUeAZhhazilmNpOK87sbg%2BaAxI2o4gIpaTYnAEA4hJpFu1FnNOD8pFMMZzURQaB1Rke4omarL93I7spcpWC20r%2F8vAFu7Ahf9JKt20ZKhx65Kpgvqgw5YjmWITw5K4tJjUpvnW234cuBuiFOwUaHovg%2BG9IjDuDZI5WyLCfKKe8gx3glLK6ZNF8h2FD6vUBAD8XJzo31ARDhcdytwke71h%2BlAsGng6A7Umt62mP%2B1yR%2B29Mw0bvngRjJiEk7xz%2FRFZeGkAwDL6lsmnfppzThir3BYyj0WHdpl9TzuD%2Bxy0%2BgKTJ7Amik1qSvJSfu5kHVthjIfQcD%2FOh%2Fmh4cSFP%2F7g7c24nYE1kUL4SuV2DkpbOJhWR4CNm9gloOEcTmNB79YascR%2FeogWaIO9uS9PvHN%2BlCB%2BNNDOIysQfn6h%2Foqd0AtQLp5bHP17FMzAnJk84fPhG4dBOWq56EB5ai1QC6ihsithiuerhstithre31HEadvXaXds9md9%2FPWOEBI2VbzN8Q3eG19yvzDKrdu7BjqxAWas1Pj8UcE%2B2kA42NrTK%2B3H17PnGJG%2FqXD4Rvcx2wC995mJFpJgDLOOkUNRbrp2MHjm3eshQ8F07BuDbq%2BiuI0LNuBHI0qFoK8%2FesX8mBXKURXmGRGsujZDtjNVwHhqRwmgYKjR5HeXbjUgkHfXMEkJPqupeonlfI%2Fb1Om%2B30f0E%2BT46rQxOb%2B4lK9KYFze2XQC%2Bkl19y5WU0RPD23jfqyA53T3M%2B1pNV6U%2FdjKNgdClQ%3D%3D&X-Amz-Algorithm=ABC-123-DFF&X-Amz-Date=20250102T184508Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1799&X-Amz-Credential=ASIIHHEIHTIHLWH%2F20250102%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=14b12cbd349dbbc36acac145778aaaaaaaaaa06f57716b15dba1814"
  }

asyncDownloadReportStatus

This is the polling endpoint mentioned in Option 1. It accepts the pre-signed S3 link in the response from asyncDownloadCTVPublisherNetworkReport and returns one of 3 possible status strings:

• READY - the report is present in the download link
• WAITING - the report is not ready yet
• ERROR - the report request must be resubmitted

asyncEmailCTVPublisherNetworkReport

This endpoint is used in Option 2. It uses the same parameters as the synchronous ctvPublisherNetworkReport endpoint (without the pagination-related fields cursor and size), as well as a list of valid email addresses for the report recipients. The endpoint returns true if the request was successfully received and false if otherwise.

Example request

query {
  asyncEmailCTVPublisherNetworkReport(
    sellerMemberId: "YOUR_MEMBER_ID"
    startDate: "2024-11-15" 
    endDate: "2024-12-30"
    dimensions: [YMD, PUBLISHER_NAME]
    metrics: [AD_REQUESTS, REVENUE]
    filters: []
    emails: ["EMAIL_1", "EMAIL_2"]
)
}

Example response

{
  "data": {
    "asyncEmailCTVPublisherNetworkReport": true
  }

What's next

• Reporting API Changelog