Checking settings and reports

A tool for checking buyer bids

In several cases, bid requests can be sent to buyers multiple times:

• When loading the page: requests are sent to all buyers specified in the configuration script.
• When reloading a placement: using the reload() method, the buyers that are only related to the reloaded ad are polled again.
• When calling the pushAdUnits()method: the request is only sent to the buyers specified in it.

To get bids from the latest buyer polling, use the getLastBidsReceived method:

window.Ya.headerBidding.getLastBidsReceived();

The response contains an array filled with Bid objects for each "placement + buyer" pair. An object may only contain one of the following fields:

• banner: If the buyer responds with a regular banner.
• native: If the buyer responds with a native banner.
• error: If an error occurs.

Example of a method call in the browser console

interface Bid {
    adapterName: string; // buyer name
    containerId: string; // container ID     
    campaignId: number; // campaign ID in Adfox     
    requestDuration: number; // request duration     
    cost?: {
        currency: string; // currency "RUB"/"USD"
        cpm: number; // CPM rate returned by the server 
    },
    banner?: {
        src: string; // banner contents     
    },
    size?: {
        width: number; // width in px
        height: number; // height in px
    },
    error?: {
        code: number; // error code         
        message: string; // error name     
    },
    native?: {
        nativePayload: any; // object with contents for a native banner impression     
    }
};

Reports by Header Bidding

If monetizers are enabled for your account, reports by Header Bidding are available to you at the site and account levels. To learn more about reports, see Monetization reports.