[Analytics] Publisher Transparency Report

Retrieving Publisher Display Data at the Advertiser Level

As part of our open and transparent approach, we are providing publisher-oriented information on your ad impressions in the form of reports. These reports include publisher domains where ads are displayed, timestamps of displayed ads, the price you are paying for each impression, and contextual information such as user environment and device.
 
You can retrieve this information at any time through our REST API in the form of reports that can integrate back into your systems. Reports are available for up to 30 days.

🚧

The Management Center roles that can access the transparency endpoint are:

• Administrator
• Business Manager
• View Only

The transparency report is available at this endpoint:

https://api.criteo.com/legacy/marketing/v1/publishers/stats

 
Below are examples connecting using our API client library.

curl --request POST \
  --url https://api.criteo.com/legacy/marketing/v1/publishers/stats \
  --header 'Accept: application/json' \
  --header 'Content-Type: text/json' \
  --data '{"advertiserIds":"1234","startDate":"2020-09-03","endDate":"2020-09-04"}'

The call above will return an array of objects containing links to download the reports. The reports will be split out by advertiser and day. The 'advertiser_ids' field is required for all client libraries except node. In node, all advertisers linked with your account will be returned if you do not specify an advertiser id in the call.

[
  {
    "advertiserId": 1234,
    "stats": [
      {
        "fileName": "2020-09-03.csv.gz",
        "tokenValidUntil": "2020-09-05T17:52:05.757Z",
        "url": "https://criteocpp.blob.core.windows.net/......"
      },
      {
        "fileName": "2020-09-04.csv.gz",
        "tokenValidUntil": "2020-09-05T17:52:05.757Z",
        "url": "https://criteocpp.blob.core.windows.net/......"
      }
    ]
  }
]

In the array returned, the report address will be located in the 'stats' section under the 'url' parameter. You will need to retrieve the report from this location to see the data.

There are many ways to retrieve this report but in this example, we will be using curl.

curl -o "saved_report.csv.gz" "#link from the url param#"

Once the report is downloaded, you will need to uncompressed it and open it.

🚧

The downloaded report will have no column headers

To understand the report, you will want to save the column headers somewhere.
Column 1: Timestamp
Column 2: Date
Column 3: Hour
Column 4: Domain level referrer
Column 5: Cost
Column 6: CampaignId
Column 7: CategoryId
Column 8: BannerId
Column 9: Environment (e.g. Mobile)
Column 10: Device model
Column 11: OS

When reading over the report, there are a few things to note. They are listed before in a table for easy reference.