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 Values

Data Fields

Description

Average Bidfloor USD

The average BidFloor in US Dollars.

Bid Rate

Buyer Yes Bids / Buyer Bid Requests.

DSP Bid Requests

The number of Bid Requests BidSwitch sent to the Buyer.

DSP Media Spend 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:

  • ads.txt status

  • SSP

  • Publisher

  • DSP Size, e.g. 320x50 pixels

  • DSP Seat ID

  • DSP Deal ID

  • Device Type

  • User Group

  • Country

  • DSP Currency

  • Content Type

  • Inventory Type

  • Connection Mode

  • Data Centre

  • Referrer Domain

  • Day

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 Values

Data Column

Description

All 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.

SSP Media Revenue eCPM USD

Supplier eCPM in US Dollar

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 Seat

Responses with an invalid seat ID.

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

  • ads.txt status

  • Campaign ID

  • DSP

  • Publisher ID

  • Site ID

  • DSP Size, e.g 320x50 pixels

  • DSP Seat ID

  • DSP Deal ID

  • SSP Deals

  • Device Type

  • Country

  • Content Type

  • Inventory Type

  • Connection Mode

  • Data Centre

  • Referrer Domain

  • Day

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