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
  1. Log in with Yandex ID or register.

  2. On the Adfox home page, click Join.
  3. 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:

Step 2. Banner types and templates

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 your own 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
  1. Go to Settings → Banner types → Custom → Nondimensional.
  2. Enter a name for the banner type and click Add. The Templates tab opens.
  3. Add a template: use a preset template or create a custom one.
Turbo and AMP pages Banner ad Added by default. To enable available banner types and templates:
  1. Go to Settings → Banner types → Predefined → Nondimensional. Banner types for Turbo pages have Turbo in their names, and AMP for AMP pages.
  2. Click the  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. To enable available banner types and templates:
  1. Go to Settings → Banner types → Predefined → Nondimensional. Banner types for apps have App Mobile in their names.
  2. Click the  icon next to the name of the banner type to open the list of templates.
Video ad Added by default. To enable available banner types and templates:
  1. Go to Settings → Banner types → Predefined → XML.
  2. Click the  icon next to the name of the banner type to open the list of templates.
Video resource Video in video content Added by default. To enable available banner types and templates:
  1. Go to Settings → Banner types → Predefined → XML.
  2. Click the  icon next to the name of the banner type to open the list of templates.
Tracking pixel Added by default. To enable the 1x1 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.

How to add a site, sections, and placements
  1. Go to the Sites tab and click + Add.
  2. Enter the site's name in this tab. The name must be unique within your account.
  3. 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:
    • Name: Name of the site to be added to the ad register.
    • URL: Site or video resource domain, blog URL, or URL for downloading an app.
    • Placement type: Site, app, or information system.
    • Contractor: Select a contractor (site owner) from those you added earlier in the Marking tab.
  4. Click Add.
  5. 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.
  6. 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.

Note. If you use Mobile Mediation in the Yandex Advertising Network interface, the app is added to Adfox automatically. To open the app, go to the Sites tab.
Step 5. Get and place the ad tag on the 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:
  1. Open the Sites tab and click next to the name of the site. The Ad tag tab with the ad loader code and the ad unit code opens.
  2. Choose the Banner type and Position parameters that match the site where you are planning to place the ad tag.
  3. 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.
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
  1. Go to the Users → Participants → Advertisers and click + Create new.
  2. 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
  1. Go to the Campaigns tab and click + Add.
  2. Specify the advertiser created earlier, the campaign type, and the impression count method.
  3. 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.
  4. After the campaign is added, the Placement tab opens. Place the campaign on the previously created site.
Step 8. Add banners to the campaign

A banner is an advertising creative.

How to add banners
  1. In the created campaign, go to the Banners tab and click + Add.
  2. Select the banner type that you specified when creating the placement.
  3. Select a template for your creative, such as Banner Image [context].
  4. Configure the banner settings. To learn more about the settings and requirements for creatives, see Banner requirements.
  5. 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.
  6. 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 can be enabled for both regular websites (mobile and desktop versions), and for sites created using Turbo and AMP technology.

  1. 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.
  2. In the Adfox interface, go to Monetization → Display advertising, and hover over the platform to connect to the Yandex Advertising Network. A plus sign appears in the YAN block ID column, click it.
  3. 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.
  4. 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.

To learn more about monetization, see Monetization in Adfox.

Contact support