BidSwitch Custom Auto-Reports

This section outlines how BidSwitch partners can request or update a custom report, or solve any issues with them. The reports are automatically sent based on the partners’ preferred frequency. All reports are provided as a link to BidSwitch storage that will expire in 30 days, as well as being sent as email attachments.

Find the section that addresses your needs, and send an email to the BidSwitch Support Team in the proposed format. Using the correct format will allow the BidSwitch Support Team to promptly help you without additional questions.

Note

Custom reports cannot be sent earlier than 12:00 UTC because before that time the data may not be complete.

Custom Buyer Reports Data

When you request an custom Buyer report, it can be configured to return the following possible data for the time period given.

Buyer Report Properties
Data Fields Description
Average Bidfloor USD The average BidFloor in US Dollars.
Bid Rate Buyer Yes Bids / Buyer Bid Requests.
BSW Fee % The BidSwitch Fee as a percentage
DSP Bid Requests The number of Bid Requests BidSwitch sent to the Buyer.
DSP Price USD Buyer Media Cost in US Dollars.
DSP Price Buyer Media Cost.
DSP Yes Bids Number of valid Yes-Bids sent from the Buyer to BidSwitch.
Impressions The number of impressions.
Impression Rate Impressions / Buyer Yes Bids.
Tech Win Rate Impressions / Buyer Bid Requests.
Timeout bids % The % of Buyer time-outs.
DSP Blocked Creatives Creative IDs or creative advertiser domains that were blocked.
DSP Bidfloor Violations The number of bids below the bidfloor.
DSP Bids Failed SSP Req Responses that do not conform to Supplier requirements, for example, a missing mandatory field or click tracking macro.
DSP Invalid Bids Number of Buyer bids invalidated for another reason outside of the other potential invalidating circumstances mentioned in the report.
DSP Invalid Deals Responses with an invalid Deal ID or without a Deal ID for private deals.
DSP Invalid Responses Number of invalid Responses received by BidSwitch from the Buyer. An invalid response is a response without a parsable JSON bid object.
DSP Invalid Seat Responses with an invalid seat ID.

BidSwitch can split the data by one of the following keys:

  • SSP
  • DSP Seat ID
  • DSP Deal ID
  • Device Type
  • User Group
  • Content Type
  • Inventory Type
  • Connection Mode
  • Datacenter

Requesting a New Buyer Report

To request the creation of a new custom report, please send an email to support@bidswitch.com using the following format, and filling in the required information.

#Email Subject
Create a new custom report for DSP $DSP_NAME $dsp_id

#Email Body
Hi BidSwitch Support,
Please create a new custom report.

Platform: DSP $DSP_NAME $dsp_id
Frequency: "daily, weekly, monthly, or month_to_date"
Format: "csv, tsv, or xlsx"
Recipients: $list_of_email_addresses
Data fields: e.g. "DSP Bid Requests, DSP Yes Bids, Impressions, DSP Price USD"
Split data by: e.g. "SSP

Hint

The month_to_date report is data from the first day of the current month, to the day prior to requesting the report.

Updating a Buyer Report

To request an existing report be amended, please send an email to support@bidswitch.com using the following format. You can specify the whole report or just parts you would like to change.

# Email Subject
Change of automated report for DSP $DSP_NAME $dsp_id.

# Email Body
Hi BidSwitch Support,
Please change the existing automated report.

Report ID: $ABCD1234
Platform: DSP $DSP_NAME $dsp_id
Frequency: "daily, weekly, monthly, or month_to_date"
Format: "csv, tsv, or xlsx"
Recipients: $list_of_email_addresses
Data fields: e.g. "DSP Bid Requests, DSP Yes Bids, Impressions, DSP Price USD"
Split data by: e.g. "SSP"

Example Buyer Report

The following is a .csv example report.

SSP, Impressions, DSP Price
ssp1, 9391, 44.68
ssp2, 83780, 21.36
ssp3, 234941, 340.22

Custom Supplier Reports

When you request an custom Supplier report, it can be configured to return the following possible data for the time period given.

Supplier Report Properties
Data Column Description
SSP Bid Requests Number of Bid Requests BidSwitch receives from the Supplier.
DSP Yes Bids Number of valid Yes-Bids from the Buyer to BidSwitch.
Timeout % % of time-outs from the Buyer.
Impressions Number of Impressions.
Win Notices Number of Win Notifications.
DSP Invalid % Number of invalid Yes-Bids sent from Buyer to BidSwitch.
SSP Final Price SSP Media Cost.
Imp Rate Impressions / DSP Yes Bids.
SSP Yes Bids

Number of Yes-bids from BidSwitch to the Supplier.

Note: It is not the sum of all Buyer Yes-bids because BidSwitch can combine Yes-bids from several Buyers into 1 SSP Yes-bid.

BidSwitch can split the data by one of the following keys:

  • DSP
  • Publisher ID
  • Site ID
  • DSP Seat ID
  • DSP Deal ID
  • Device Type
  • Content Type
  • Inventory Type
  • Connection Mode
  • Datacenter

Requesting a New Supplier Report

To request the creation of a new custom report, please send an email to support@bidswitch.com using the following format.

# Email Subject
Create new custom report for SSP $SSP_NAME $ssp_id

# Email Body
Hi BidSwitch Support,
Please create a new custom report.

Platform: SSP $SSP_NAME $ssp_id
Frequency: "daily, weekly, monthly, month_to_date"
Format: "csv, tsv, or xlsx"
Recipients: $list_of_email_addresses
Data fields: e.g. "SSP Bid Requests, DSP Yes Bids, Impressions, SSP Price USD"
Split data by: e.g. "DSP"

Hint

The month_to_date report is data from the first day of the current month, to the day prior to requesting the report.

Updating a Supplier Report

To request an existing report be amended, please send an email to support@bidswitch.com using the following format. You can specify the whole report or just parts you’d like to change.

# Email Subject
Change of custom report for SSP $SSP_NAME $ssp_id

# Email Body
Hi BidSwitch Support,
Please change the existing custom report.

Report ID $ABCD1234
Platform: SSP $SSP_NAME $ssp_id
Frequency: "daily, weekly, monthly, or month_to_date"
Format: "csv, tsv, or xlsx"
Recipients: $list_of_email_addresses
Data fields: e.g. "SSP Bid Requests, DSP Yes Bids, Impressions, SSP Price USD"
Split data by: e.g. "DSP"

Example Supplier Report

The following is a .csv example report.

DSP, SSP Bid Requests, Impressions
dsp1, 61525, 43223
dsp2, 7625, 3456
dsp3, 87253, 56789