Connecting via Adfox HB
To the monetizer
Account setup
- To become an Adfox HB monetizer, contact support.
Add a website, section, or placement that the publisher will access via Header Bidding.
Determine the type of banner and templates that you'll connect the publisher to. If there is no banner type with templates, add it by following these instructions.
Place a campaign and banners that will be displayed on the publisher's side in the created placement.
Learn more about creating campaigns and adding banners.
Set the total CPM for the campaign.
You can also set a separate CPM for specific placements. To enable this feature, contact Adfox support.
- On the Campaigns tab, find the campaign with the CPM that you want to configure. Specify the CPM for this campaign in the corresponding column.
- To set the CPM for a flight, click
Parameters, which is to the left of the campaign name. That will open a tab with the parameters for the campaign.
- Go to the Flights tab. A list of flights within the campaign opens.
- Set the CPM for the desired flight in the corresponding column.
- On the Campaigns tab, find the desired campaign. Click
Placement, which is to the left of the campaign name.
- In the tab that opens, click
Sections, which is to the right of the site name. That opens a tab with site sections.
- Click
Placements, which is to the right of the section name.
- Set the CPM for the desired placement in the corresponding column.
- Get the ad tag of the placement and send it to the publisher.
To the publisher
Checking integration
To check that Header Bidding is configured correctly on the publisher's side, you can do the following:
Make sure that the correct parameters are specified in the Header Bidding settings:
- In the browser console on the publisher's site, run the following command:
The Header Bidding settings object will be displayed in the console.window.YaHeaderBiddingSettings
- For the
code
(container ID on the page) parameter there, find theadUnit
that should contain the IDs for calling the monitizer placement. Make sure that:
- The monetizer's login in the
bidder
parameter is correct:adfox_%bidder-login%
. - The IDs in the
params
parameter match the IDs the monetizer passed to the publisher.
For example:
Make sure that there are no errors in the request and the creative comes with a bid:
- Run the following browser console command:
window.Ya.headerBidding.getBidsReceived()
- Make sure that a creative with a bid is received for the login and the container from Step 1.
For example:
- Check the number of
containerId
.Restriction. You can specify no more than tencontainerId
per monetizer.
Enable custom targeting via Adfox HB
If a monetizer account that uses Adfox HB has custom targeting set up, you need to add the puidN
parameters and targeting values to the ad tag, where N is the characteristic number from 1 to 63. The puid
parameters are added to the params
object in name: value
format, where:
name
is the parameter name (puidN
).value
is the parameter value.
window.YaHeaderBiddingSettings = {
biddersMap: { 'adfox_example': '957356' },
adUnits: [{
code: 'adfox_154875622348837699',
bids: [{
bidder: 'adfox_example',
params: {
pp: 'g',
ps: 'cqmv',
p2: 'fqnq',
puid1: 'woman',
puid2: '16:17:18:19',
puid3: 'green'
}
}]
}],
timeout: 500
};
Viewing statistics
You can control your campaigns using the following reports: