Quick start

Step 1. Log in to Adfox

A new Adfox account is created automatically when you register in the Yandex Advertising Network and accept the service's single electronic offer.

If you don't have a Yandex Advertising Network account

Log in with Yandex ID or register.
On the Adfox home page, click Join.
Fill out the application and click Send application. You get access to the Yandex Advertising Network and Adfox interface.

After registering your account, you get administrator access. The administrator has the full set of rights to manage account settings. They can also create users and manage their access rights.

You can access Adfox the following ways:

You can use a banner type to mark up placements on your website, in a video player, or in an app. For example: Fullscreen, 240 × 400, 300 × 600, stretching banner, pre-roll. Each banner type contains a set of templates which determine the appearance and functionality of an ad creative.

You can add custom banner types if you plan to place ads on a website (including mobile versions). For other cases, banner types and templates are already set.

How to determine banner types and templates

The banner type and the templates it has available depend on the ad format and placement:

Placement	Format	How to add a banner type and a template
Website (desktop and mobile version)	Banner ad, Video ad	Go to Settings → Banner types → Custom → Nondimensional. Click + Add, enter a name for the banner type and click Add. The Templates tab opens. Add a template: use a preset template or create a custom one.
AMP pages	Banner ad	Added by default. To enable available banner types and templates: Go to Settings → Banner types → Predefined → Nondimensional. Banner types for AMP pages have AMP in their names. Click the Templates icon next to the name of the banner type to open the list of templates.
Mobile apps for iOS and Android	Banner ad	Added by default. Available banner types and templates can be found on the Settings → Banner types → Predefined → Nondimensional tab. Banner types for apps have App Mobile in their names.
Video ad		Added by default. Available banner types and templates can be found on the Settings → Banner types → Predefined → XML tab.
Video resource	Video in video content	Added by default. To enable available banner types and templates: Go to Settings → Banner types → Predefined → XML. Click the Templates icon next to the name of the banner type to open the list of templates.
—	Tracking pixel	Added by default. To enable the 1 x 1 banner type, go to Settings → Banner types → Predefined → Nondimensional.

Step 3. Add contractors and a contract

This step is necessary if you place ads under a contract for displaying ads in Russia signed directly with an advertiser or through an agency and want to report these ad impressions to the state register through the Yandex advertising data operator (Yandex ORD).

For more information about transferring data to the state register, see Settings for Russian ad register.

When you don't need to specify the contractor and contract data

You don't need to add contractors and an contract if at least one of the following conditions is met:

You don't have a direct contract for placing ads with an advertiser.
Ads will be displayed outside of Russia.
You place a token in a creative on your own and transfer data to the Russian state register via a different advertising data operator.

Step 4. Add a site, sections, and placement

A site in Adfox is a resource where ads are placed. It can be a regular or mobile website, a mobile app, or a video resource.

Each site (website, app, video resource) is divided into sections and placements. A site section is a part of a site that's logically distinct in terms of topic, method of selling banner placements, subdomain, or any other characteristic. A placement is the direct ad placement on the site.

Note

To place direct sales banners in a mobile app, add an app in the Yandex Advertising Network interface, create an ad unit and connect it to Adfox. If you use Mobile Mediation, Adfox is already enabled by default.

In the Adfox interface, the app can be found on the Sites tab. It will have the same name as in the Advertising Network.

How to add a site, sections, and placements

Go to the Sites tab and click + Add.
Enter the site's name in this tab. The name must be unique within your account.
If the creatives to be placed on the site must be added to the ad register and you want to submit data about them via the Yandex advertising data operator, fill in the fields under Marking:
- Placement type: Site, app, or information system.
- Name: Name of the site to be added to the ad register.
- Site URL: Site or video resource domain, blog URL, or URL for downloading an app that starts with http:// or https://.
  
  If the site is hosted on a third-party platform, please provide its exact URL. For example, the URL of a Telegram channel or blog on Zen.
- Contractor: Contractor (domain, video resource, blog, or app owner) that you added in the Marking tab earlier.
  
  If the contractor isn't the sole owner of the resource (for example, an aggregator site), leave the field empty.
Click Add.
After the site is added, the Sections tab opens. If necessary, specify page templates that describe the range of URLs included in this section: you can list all the appropriate URLs or use templates. Standard is a default template type, so the * symbol can stand for any set of characters. You can also use URL templates with posix.2 regular expressions. Afterwards, click Add.
The Placements tab opens. Create a placement where you plan to place your campaign.

In the name of the placement, we recommend specifying the banner type and position on the site, for example: “300 × 300, top”, “240 × 400, middle right”. This makes it easier to find the right placement in the interface.

Specify the banner type and location. For example, the 300 × 300 banner type and the <top> position. Click Add.

Step 5. Get and place the ad tag on the resource

Site

App

Video resource

You should obtain the site-level ad tag for the placement once and install it on all the pages of your site. To get the ad tag to install on your site:

Open the Sites tab and click Ad tag next to the name of the site. The Ad tag tab with the ad loader code and the ad unit code opens.
Choose the Banner type and Position parameters that match the site where you are planning to place the ad tag.
Add the ad loader code to the <head> of each page where your ads are served. Add the ad unit tag between the <body> and </body> tags where the ad unit should be displayed.

Integrate Yandex Mobile Ads SDK into the app and connect a R-M ad unit. For more information, see Ads in Mobile Apps Help.

Open the Sites tab and click Ad tag next to the name of the video resource. The Ad tag tab opens.
Choose the Banner type and Position parameters that match the site where you are planning to place the ad tag.
The ad request link appears.
Afterwards, integrate Video Ads SDK into the player and paste the link. Learn more about ads in the video player.

Step 6. Create an advertiser

An advertiser is a user who can access statistics of campaigns that they are indicated as the advertiser for. An account administrator can also allow an advertiser to add, edit, or delete banners in their campaign.

If you are not planning to grant other users access to statistics, you can select a pre-installed advertiser in the campaign settings.

How to create an advertiser

Go to the Users → Participants → Advertisers and click + Create new.
Enter the advertiser's login and email address. The advertiser will be sent an email with a link to register in Adfox.

Note

You can only use Latin letters, numbers, dashes, underscores, and periods to create a login. The login must contain from 1 to 32 characters and be unique within the Adfox system. If you enter an existing username, a warning appears.

Step 7. Add a campaign

Go to the Campaigns tab and click Create.
Specify the advertiser created earlier, the campaign type, and the impression count method.
Select what data to submit to the ad register:
- Submit data to state register: If you want to get a token and transfer data to the Russian state register through the Yandex advertising operator.
- Do not submit data to state register: If at least one of the following conditions is met:
  - You don't have a direct contract for placing ads with contractors.
  - Ads will be displayed outside of Russia.
  - You place a token in a creative on your own and transfer data to the Russian state register via a different advertising data operator.
Select a site, section, or placement where you want to place your campaign.
Save the campaign.

Step 8. Add banners to the campaign

A banner is an advertising creative.

In the created campaign, go to the Banners tab and click Create.
Select the banner type that you specified when creating the placement.
Select a template for your creative, such as Banner Image [context].
Configure the banner settings. To learn more about the settings and requirements for creatives, see Banner requirements.
If you chose to Submit data to state register at the campaign level, add the creative data in the Settings for Russian ad register section. For more information, see Transferring data to the Yandex advertising data operator and getting a token.
Click Add.

Now the advertising creatives are displayed on your site. Detailed information about ad requests, impressions, and clicks can be found in the Reports tab.

Step 9. Enable monetization with the Yandex Advertising Network or via Header Bidding

Monetization enables you to sell traffic on placements through the Yandex Advertising Network or other external monetizers using Real Time Bidding technology. You can find the list of external monetizers that can be connected to Adfox in Header Bidding.

Monetization with the Yandex Advertising Network

External Header Bidding monetization

Monetization with the Yandex Advertising Network can be enabled for both regular websites (mobile and desktop versions), and for sites created using AMP technology.

Add a website in the Yandex Advertising Network interface. Once added, the resource is automatically submitted for moderation. After your resource passes moderation, you can connect the Advertising Network to Adfox.
In the Adfox interface, go to Monetization → Display advertising, and hover over the placement to connect to the Yandex Advertising Network. A plus sign appears in the YAN block ID column, click it.
In the window that opens, select the site added to the Yandex Advertising Network in the first step: a special ad unit is created on the placement for Adfox.
The Yandex Advertising Network interface opens: add advertising formats to the unit and set up an impression strategy. To read more about setting up an ad unit, see Yandex Advertising Network Help.

Header Bidding is a technology that lets multiple monetizers connected to a site bid on a placement when a user loads a site page, enabling you to get the highest price.

Before you start connecting any third-party monetizer:

Sign a separate contract with each monetizer that competes in auctions with Header Bidding technology.
In the monetizer's personal account, create an ad unit for the placement on your site and save its ID: you'll need it to create a configuration script.

Step 1. Add a template labeled Header Bidding for the banner used on the placement

Determine the banner type used on the placement where you want to enable external monetization. Let's say this is a 240 × 400 predefined banner type. Add a special template to this banner type:

Go to Settings → Predefined and open the templates in the desired banner type.
Find the template with the monetizer's name that's labeled Header Bidding from the list of templates, for example Header Bidding myTarget, and click Select (>>).
The desired template is added to the banner type. Click Change.

Step 2. Create a campaign for an external monetizer

Go to the Campaigns tab and click Create.
Enter the name, advertiser, and the external monetizer you selected.
Select a site, section, or placement where you want to enable external monetization.
Save the campaign.

Step 3. Add a banner

In the campaign you created, go to the Banners tab and click Create.
Select the banner type used on the placement where you want to enable external monetization.
Select the template that you added in step 1. In our example, it is Header Bidding myTarget.
If necessary, change the banner settings. To learn more about banner parameters, see Adding banners.
Click Add.

Step 4. Create and connect a configuration script

Go to Monetization → HB configurator.
Click Add container and specify the Container ID.
Click Add monetizer.
Select a monetizer (in our case it's myTarget) and specify the Buyer's placement ID, which is an placement ID in the account of the selected external monetizer.
Click Generate.

Copy the ad tag and add it to the HTML code of the site (or selected pages) inside the <head> tag. Afterwards, Header Bidding external monetization for Adfox placement is enabled.

To learn more about monetization, see Monetization in Adfox.