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.
- 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.
If you don't have a Yandex Advertising Network accountAfter 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:
- Log in to your Adfox account.
- 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.
- 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).
- 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.
- 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:
- 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.
- 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.
How to add a site, sections, and placementsNote. 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:
- 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.
- 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.
For mobile apps, we recommend getting the ad tag at the placement level:Go to the tab in one of the following ways:
- .
- .
- When you find the placement, click Ad tag.
- In the window that opens, copy the ad tag for your app type.
To use the SDK in your app, you must have an
Ad Unit Id
. This is a unique ID that's issued in the Yandex Advertising Network interface and has the following format: R-M-XXXXXX-Y.To get an
Ad Unit Id
, create a new ad unit on the tab.Important. If you can't see your placements on the Mobile advertising tab, make sure that your placement banner type has the “App” prefix. Learn more about banner types for apps. Next, integrate the SDK into the app and install the ad tag:
- Open the Sites tab and click
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.
- Go to the + Create new.and click
- 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.
How to create an advertiser - Step 7. Add a campaign
-
- Go to the Campaigns tab and click + Add.
- 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.
- 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.
- In the created campaign, go to the Banners tab and click + Add.
- 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.
How to add bannersNow 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.
- 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 , and hover over the platform 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 toand 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 BiddingmyTarget, 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 + Add.
- Enter the name, advertiser, and the external monetizer you selected and add the campaign.
- Step 3. Place the created campaign on the placement
-
When a campaign is created, the Placement tab opens.
- Select a site, sections, or placements where you want to enable external monetization.
- Click Change.
- Step 4. Add a banner
-
After a campaign is placed, the Banners tab opens.
- Click Add.
- 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 BiddingmyTarget.
- If necessary, change the banner settings. To learn more about banner parameters, see Adding banners.
- Click Add.
- Step 5. Create and connect a configuration script
-
- Go to.
- Click Add container and specify the Container ID.
- Click Add bidder.
- 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.