Reporting

Authorized Buyers provides the following reporting data:

• The Snippet status report provides information on whether a creative has been approved and helps debug serving problems.
• The Performance report API provides information on the performance metrics of your bidder.

Snippet status report

The Snippet Status Report contains the approval status of your creatives, as well as the sensitive and product categorization that Authorized Buyers automatically detects. There are two versions of this report: a human readable text format and a binary protocol buffer format. You can use this report to determine whether a creative has been approved, and to help debug serving problems. Both versions of the report are provided via Google Cloud Storage.

This report is available via HTTP. The payload of the HTTP response is gzip-compressed according to RFC 1952. To uncompress the file from the command line, run gzip -d <filename>. To uncompress the file programmatically, you can use zlib, or a similar compression library, that supports the gzip format. The result is either a text file or a serialized protocol buffer, depending on the report version you download. The protocol buffer version's encoding is similar to the payload of the POST request in a BidRequest, and can be parsed using the following snippet.

string compressed = /* the payload from the GET request */;
string uncompressed = gunzip(compressed);
SnippetStatusReport snippet_report;
if (snippet_report.ParseFromString(uncompressed)) {
  // Process the snippet report.
}

The Snippet Status Report also lists the top reasons why a creative is filtered. For more details, see the comments of the SnippetFiltering message in the snippet-status-report.proto file.

The protocol buffer definition for SnippetStatusReport is available on the reference data page.

Each entry in the snippet status report contains a buyer_creative_id that you have set in your bid response. You can use this field to correlate snippet status information with your creatives. Each snippet will have a status of NOT_CHECKED, APPROVED or DISAPPROVED. If Authorized Buyers has classified the creative, the snippet status item will have the product and sensitive categories we have associated with the creative, as well as an advertiser id if one is available.

Please contact your technical account manager to enable this feature for your account.

You can use the Snippet Status Report Generator to generate Snippet Status Reports.

Performance report API

The Performance Report contains information that helps you to understand the performance of your bidder application. The data is in a JSON format, described below.

You can get performance data by calling performancereport. When calling the API, you must provide a reporting period (start time and end time) and your account ID. You can also provide a pagination token and a value indicating the maximum results in the report. For example, the following call:

performancereport?endDateTime=2013-06-13T17:25:00Z&startDateTime=2013-06-13T17:20:00Z&accountId=44773513

returns the following performance report:

{
 "kind": "adexchangebuyer#performanceReportList",
 "performance_report": [
  {
   "kind": "adexchangebuyer#performanceReport",
   "timestamp": "1371835200",
   "region": "EUROPE",
   "latency50thPercentile": 0.03306867574006745,
   "latency85thPercentile": 0.033068675740067444
  },
  {
   "kind": "adexchangebuyer#performanceReport",
   "timestamp": "1371835200",
   "region": "US_EAST",
   "latency50thPercentile": 0.031355335926353825,
   "latency85thPercentile": 0.01820351400729759
  },
  {
   "kind": "adexchangebuyer#performanceReport",
   "timestamp": "1371835200",
   "region": "ASIA",
   "latency50thPercentile": 0.029531352482377874,
   "latency85thPercentile": 0.029335240957323264
  },
  {
   "kind": "adexchangebuyer#performanceReport",
   "timestamp": "1371835200",
   "region": "US_WEST",
   "latency50thPercentile": 0.027170472757130575,
   "latency85thPercentile": 0.027170472757130575
  }
 ]
}

The report is in a JSON format where one field provides a POSIX timestamp, alongside the name of the trading location.

The data fields latency50thPercentile, latency85thPercentile and latency95thPercentile describe the Nth percentile round trip latency as perceived from Google servers for each minute covered by the report. Note that this is a weighted average among all Google data centers that are sending you traffic in a particular region, weighted by the amount of traffic per data center.