Bid Report

Report details

• reportType: bid
• Media solutions: Onsite Display
• Create report: POST /api/v1/snapshot/report
• Report generation: Asynchronous snapshot; retrieve the output after the job completes.

Best used for

• Auction performance analysis
• Bid efficiency monitoring
• Delivery diagnostics
• Auction optimization workflows

Key limitations

• No conversion metrics
• No awareness metrics
• No attribution metrics

Request parameters and report behavior

The Create Report Snapshot endpoint requires advertiserId, startDate, endDate, and reportType. Dates use yyyy-MM-dd and cannot be the current date. Reporting data may lag by 24–48 hours. If reportMetrics is omitted, all metrics relevant to the report type are returned.

Near real-time refresh. scope=CAMPAIGN_GROUP is not supported.

For the complete request schema, see Create Report Snapshot.

Dimensions

• campaignExtId (Default)
• campaignName
• date (Default)
• lineItemExtId (Default)
• lineItemName

Metrics

• adSpend
• numAdsClicks
• numAdsShow
• pacingPercent
• validBids