Reporting

Authorized Buyers provides the Snippet status report to get information on whether a creative has been approved and helps debug serving problems.

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.