NoBidReason

1
2
3
4
5
{
    "Name": "Mopedo.Bidding.NoBidReason",
    "Kind": "EntityResource",
    "Methods": ["GET", "DELETE", "REPORT", "HEAD"]
}

The NoBidReason resource, and its child resources - InvalidBid, UnsupportedBanner and ClickTrackingNotSupported, are used to track and give feedback on why some bid requests are not responded to with bids. Every time the bidder finds some issue while evaluating bid requests, that the advertiser should be made aware of, entities will be created in the above-mentioned resources.

Format:

Property name Type Description
BidRequest BidRequest The bid request that was matched by a bid rule
Info string Information about the missed bid opportunity
Time datetime The time when the missed bid opportunity was registered

InvalidBid

1
2
3
4
{
    "Name": "Mopedo.Bidding.InvalidBid",
    "Methods": ["GET", "DELETE", "REPORT", "HEAD"]
}

Entities are created in the InvalidBid resource whenever a bid generated by a bid template failed validation.

Format

Excluding the properties inherited from NoBidReason.

Property name Type Description
Error string The error code describing the validation error

UnsupportedBanner

1
2
3
4
{
    "Name": "Mopedo.Bidding.UnsupportedBanner",
    "Methods": ["GET", "DELETE", "REPORT", "HEAD"]
}

The UnsupportedBanner resource keeps track of all instances where a bid request was matched by a bid rule, but there was no Ad of matching dimensions to place in the available ad slot. Finding these instances and calculating the number of missed ad placement opportunities can be useful for optimizing campaigns. To get an aggregated view of unsupported banners, use the UnsupportedBannerReport resource.

Format

Excluding the properties inherited from NoBidReason.

Property name Type Description
Width integer The width of the unsupported ad slot
Height integer The height of the unsupported ad slot
Dimensions string The dimensions expressed as a string, e.g. "250x300"

ClickTrackingNotSupported

1
2
3
4
{
    "Name": "Mopedo.Bidding.ClickTrackingNotSupported",
    "Methods": ["GET", "DELETE", "REPORT", "HEAD"]
}

If the bid request requires bids to contain support for click tracking, but the matched Ad has no click tracking support – a new entity will be created in the ClickTrackingNotSupported resource.

Format

ClickTrackingNotSupported has the same format as the parent resource NoBidReason.