Connecting direct sales via Adfox
Step 1. Add an app and create an unit in the Yandex Advertising Network
-
Add an app in the Yandex Advertising Network.
-
Create an ad unit: banner, interstitial, or native.
Note
You cannot add a banner with direct sales for Rewarded, App Open Ads, and Feed ad units.
-
Connect Adfox in one of the following ways:
-
In the unit settings under Advertising networks, open the Yandex Advertising Network settings and enable the Connect Adfox option.
-
If you are going to use Yandex Mediation, add the desired advertising networks and set up mediation. In this case, Adfox is enabled automatically.
-
In the Adfox interface, the app structure (site and placement) will appear automatically after you add the app in the Yandex Advertising Network. The created unit will already be linked to the placement.
-
Connect the app as a video resource. To learn how to do this and what requirements the app must meet, see InStream ads.
-
In the Adfox interface, add the app structure: site, section, placement.
- Site: An object representing a mobile app in Adfox terms.
- Section: An object within a site. Sections may be different depending on the operating system: iOS or Android.
- Placement: An object representing a specific placement in the app.
How to add a site, section, and placement for InStream ads in Adfox
-
Go to the Sites tab in the Adfox menu.
-
Click + Add and specify the site parameters:
- Site name: Required parameter. It may be the app name.
- Site owner: The user who has access to site statistics. If it's your app and you'll be the one viewing the statistics, you don't need to specify the owner. You can select the site owner later in the site parameters.
- Category: Used to collect impression statistics for certain app categories. For more information about categories, see the Adfox Help.
- If you're going to serve your ads in Russia and label them with Adfox tools, enable the Transfer the site to the ERIR option. Learn more about ad labeling in Step 2 below.
-
Click Add. A window for adding a section opens.
-
Specify the section parameters:
- Name: Section name, for example, iOS.
- Category: Used to collect impression statistics for certain app categories.
-
Click Add.
Note
If the “Dynamic definition by REFERER” module is enabled in the account, more boxes appear when adding a section. In this case, deselect “Dynamic definition by REFERER”.
-
A window for adding a placement opens. Specify the parameters:
-
Name: Placement name. We recommend specifying the placement location.
-
Category: Used to collect impression statistics for certain app categories.
-
Banner type: Determines which ad format can be displayed on this placement. For InStream ads, choose one of the banner types:
- Pre-roll (App): To display an ad before the video starts playing.
- Mid-roll (App): To display an ad while the video is playing.
- Post-roll (App): To display an ad after the end of the video.
- Pause-roll (App): To display an ad when the pause button is pressed.
-
Position: Determines the logical location of the placement on the section pages. This parameter is optional.
-
-
Click Add.
-
Go to Monetization → Video advertising. Hover over the placement you want to link the Yandex Advertising Network unit to and click the + icon.
-
A window with a list of video resources opens: select the video resource created earlier in step 1.
-
In the Yandex Advertising Network window that opens, add an InStream unit. The unit position must match the banner type on the placement.
-
Click Save.
Step 2. Enable ad labeling
You're required to submit data to the ad register if you place ads for a direct sale and serve them in Russia, either as the immediate advertiser or via an agency.
Adfox provides the functionality for managing campaigns, regardless of the advertising data operator you use for submitting data to the state register. Additionally, Adfox partners can register creatives automatically: directly in the Adfox interface while setting up their campaigns. In that case, the creative will be registered with the Yandex advertising data operator.
To label ads via the Adfox interface, follow the steps below:
-
Create counterparties (advertising chain participants).
-
Enter information about the contract with the end advertiser.
-
Add the labeling data to the site (app) structure in Adfox. In the site settings:
-
Go to the Sites tab in the Adfox menu.
-
Find and open the site with the required app.
-
Select Transfer the site to the ERIR in the site settings. This opens the Labeling section.
-
Fill in the fields:
- Placement type: Select App.
- Name: Enter the name of the site to be added to the ad register.
- Site URL: A URL for downloading the app that starts with http:// or https://.
- Counterparty: The counterparty (app owner) you added on the Marking tab earlier.
-
For more information about labeling via the Adfox interface, see the Adfox Help.
Step 3. Set up targeting (optional)
Targeting an ad banner means adjusting its impression settings to ensure that it's delivered to the right audience based on various parameters.
For certain types of targeting, data is passed in the request to Adfox by default. You can configure these parameters in the Targeting tab of the interface. To enable other types of targeting, implement passing parameters with values from the app, then enable targeting in the interface.
Determine which parameters you want to use for targeting your ads:
-
Types of targeting available without additional setup
TimeYou can set up targeting:
-
By days of the week or hours.
-
By days of the month when you want to serve impressions.
For more information, see Adfox Help.
By frequencyYou can limit the number of impressions and clicks per individual user. For example, to not show the banner more than twice a day to the same user or to pause impressions if the user has already clicked the banner link. For more information, see Adfox Help.
By behaviorYou can tag users that you want to target in the future by creating action tracking points and assigning them temporary categories. For more information, see Adfox Help.
By demographicsTargeting by demographics is based on audience data on gender, age, and income collected by the Crypta technology. You can either set one characteristic or combine the values of multiple characteristics (for example, to target by both gender and age). For more information, see Adfox Help.
GeographyYou can toggle banner impressions for specific countries, regions, cities, and manually selected areas on the map. This type of targeting uses the Yandex geobase. For more information, see Adfox Help.
By Yandex Audience segmentsIn addition to data from Crypta and external providers (DMPs, Data Management Platforms), you can use your own data about users on your platforms to set up your campaigns. For more information, see Adfox Help.
By device typeYou can differentiate the site's audience and show the most relevant ads. For example, you can choose to serve ads only to mobile and tablet users. Or vice versa, target only desktop users. For more information, see Adfox Help.
By positionYou can specify the position of the placements where you want to serve your campaign's banners.
By IP addressYou can target specific IP addresses or blocks of IP addresses by whitelisting them or exclude impressions for users with blacklisted IPs. For more information, see Adfox Help.
By operating systemYou can target your campaign by specific operating systems. For more information, see Adfox Help.
By browserYou can set up targeting by browser. It's used, for example, to show ads for Opera, Safari, Google Chrome, and Mozilla to Internet Explorer users. For more information, see Adfox Help.
-
-
Types of targeting that require passing values from the app to the request
By keywordsYou can use targeting by keywords in different ways. For example, you can insert relevant search queries in the ad tag or set up targeting by names and interests, using the user base to more accurately identify the target audience. To set up targeting, pass the parameters in the ad request to Adfox. For more information, see Adfox Help.
Custom targetingYou can specify custom targeting values. For example, you can target only users with the test build or trigger banner impressions based on a specific internal metric.
To set up targeting, pass the parameters in the ad request to Adfox.
Steps for setting up additional targeting
-
Create a dictionary for a targeting characteristic. The dictionary should contain a list of values:
-
The key is passed to the ad tag in the app.
-
The value is included in the targeting settings and can be toggled.
In Adfox, you can add up to 63 custom dictionaries for your characteristics. Each dictionary can hold up to 10,000 values and can be updated with new key-value pairs as needed.
-
-
Upload the dictionary for any free additional targeting characteristic through the Adfox interface.
-
Implement passing the keys to the index of the characteristic for which you created the dictionary.
To learn how to implement passing values to the ad tag, see Ad targeting in Adfox.
For more information, see Adfox Help.
Logical targetingYou can specify values for ad campaign impressions using the
AND/OR/NOT
conditions. Logical targeting supports additional targetings. To set up targeting, pass the parameters in the ad request to Adfox. For more information, see Adfox Help. -
Step 4. Integrate the ad unit into the app
Alert
If you previously integrated the Yandex Mobile Ads SDK, you don't need to do anything else.
Integrate the Yandex Mobile Ads SDK into the app and connect the ad unit. To learn more, see the Yandex Mobile Ads SDK section:
Direct SDK call |
Yandex Mediation |
To check whether you integrated your ads correctly, run test ads using demo ad units. After making sure that everything is correct, replace the demo ad units with the actual placement IDs.
Demo ad unit | Android | iOS | Unity | Flutter | React Native |
---|---|---|---|---|---|
demo-banner-adfox-html | ![]() |
![]() |
![]() |
![]() |
![]() |
demo-banner-adfox-image | ![]() |
![]() |
![]() |
![]() |
![]() |
demo-interstitial-adfox-image | ![]() |
![]() |
![]() |
![]() |
![]() |
demo-interstitial-adfox-html | ![]() |
![]() |
![]() |
![]() |
![]() |
demo-native-adfox | ![]() |
![]() |
![]() |
![]() |
![]() |
Step 4.1 Integrate the main SDK
Alert
If you integrated the Yandex Mobile Ads SDK earlier, you do not need to do anything else.
Integrate the Yandex Mobile Ads SDK into the app and connect the ad unit. To learn more, see the Yandex Mobile Ads SDK section:
Step 4.2 Integrate the player
1. Get PAGE_ID
of the video resource in the Yandex Advertising Network (you don't need to specify AdUnit fully in the R-M-page_id-block_id
format).
2. Integrate the player following the instructions for Android | iOS.
In response to the ad request, the SDK will receive a VMAP for the specified PAGE_ID
. Links to requests to the appropriate Adfox placement will be added to the adBreakType
parameters associated with this placement (for example, pre-roll).
If you specified a section of a video resource when creating a video unit, you also need to pass its ID in the CATEGORY_ID
parameter.
To enable additional targetings or set up logical or keyword targeting, pass the relevant parameters in the ad request to Adfox. For more information, see Yandex Mobile Ads SDK Help:
To collect separate statistics on cross sections in Adfox, pass the partner-stat-id
parameter in the app. For more information, see Adfox Help.
Step 5. Set up and place an ad campaign in Adfox
-
Go to the Campaigns tab and click + Add.
-
Select the campaign type depending on the display priority:
- Guarantee: campaigns take priority over other campaigns and are used for guaranteed sales, when the publisher has obligations to run the ad.
- Dynamic monetization (or DM) campaigns have a lower priority than Guarantee campaigns. They compete for impressions along with the Yandex Advertising Network and other ad exchanges. The display order is determined by the CPM: the higher the CPM, the higher the chance of an impression.
- Promo campaigns have the lowest priority of the three. Such campaigns are usually used for custom promotion.
For more information about campaign types, see the Adfox Help.
-
When you select a Dynamic monetization campaign, the additional External monetizer field appears: leave the Not set value.
-
Set the basic parameters of the campaign:
Name
Enter the campaign name.
An advertiser
Select one from the list of advertisers previously created. For more information about advertisers, see the Adfox Help.
Impression count method
Specify what counts as a campaign impression:
- Banner ad response.
- Viewable impression, Yandex (IMS): An impression is counted if at least 50% of the banner area remains in the active browser window for at least 2 seconds.
- Event N: An event that is called in the banner template (not applicable for in-app ads, use other methods instead).
- Impression (IMS): An impression counts when ad rendering begins.
- Viewable impression (IMS): An impression is counted by the criteria set out by international media standards, including the minimum percentage of pixels in the viewable area and the impression duration in the active browser tab.
For more information about impression count methods and viewability tracking, see the Adfox Help.
Rotation method
For Guarantee and Promo campaigns:
- Level and Priority: Determine how often the banners of this campaign are served compared to the banners of other campaigns. The first is the highest level.
- % of traffic (only for campaigns using the % of traffic rotation method): Specify the percentage of traffic to be allocated for impressions of this campaign.
For Dynamic monetization campaigns, specify the CPM floor (the minimum cost per thousand impressions).
Impression and click running speed
- As fast as possible: Campaign banners are served at the maximum possible speed until the impression/click limits are triggered (if specified). The maximum ad running speed doesn't require that you specify any limits and start/end dates of your campaign.
- Spread evenly throughout the day: Impressions are evenly distributed throughout the day. Be sure to specify the daily impression limit (the recommended minimum limit is at least 500 impressions/clicks). The other parameters are optional.
- Spread evenly throughout the entire period: The campaign impressions are evenly distributed over the entire period, based on account data and system statistics. Be sure to specify the total impression limit (the recommended minimum limit is at least 500 impressions/clicks) and the end date of your campaign. The other parameters are optional.
- Spread evenly throughout the entire period (automatic prolongation): The campaign impressions are evenly distributed over the entire period, based on account data and system statistics. If the campaign doesn't run over its limit in the allocated time, it's automatically extended for one day, where it runs at maximum speed. Be sure to specify the total impression limit and the end date of your campaign. The other parameters are optional.
Note
Depending on the running speed, there may be underdelivery or overdelivery of impressions. For more information about the running speed, see the Adfox Help.
Impressions total, day, hour
Specify the maximum number of banner impressions in the campaign overall, per day, and per hour.
When the number of impressions reaches the number in Total, the campaign status is set to completed, and the banners are no longer served. When the number of impressions from the beginning of the day reaches the daily limit, the banners stop being served until the next day. When the number of impressions from the beginning of the hour reaches the hourly limit, the banners stop being served until the next hour.
Clicks total, per day, per hour
Specify the maximum number of banner clicks in the campaign.
When the number of clicks reaches the total limit, the campaign status changes to completed, and the banners are no longer served. When the number of clicks from the beginning of the day reaches the daily limit, the banners stop being served until the next day. When the number of clicks from the beginning of the hour reaches the hourly limit, the banners stop being served until the next hour.
Campaign period
Mandatory parameters. By default, the current date is set. If you don't change it, banners start being displayed immediately after you add them.
-
Specify the labeling settings:
Submission to ad register
You're required to submit data to the ad register if you place ads for a direct sale and serve them in Russia, either as the immediate advertiser or via an agency.
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 via the Adfox interface and the Yandex advertising data 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 with a counterparty for placing ads.
- 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.
For more information about ad labeling, see the Adfox Help.
Advertiser information
Enter the legal name and details of the advertiser.
To display the advertiser information in the banner, enable the Show banner menu option in the banner settings. The advertising menu is the
-
If necessary, you can enable sending campaign statistics by email. For more information about sending statistics, see the Adfox Help.
-
Under Placements, select the placement (site, section, or placement for your app) and click Save. For more information about campaign placement rules, see the Adfox Help.
-
Set up targeting (if necessary). Using targeting, you can set up the display of ads for a specific audience depending on geography, device type, time, and other factors. You can also set up targeting at the placement level (sites, sections, or placements) or at the banner level. For more information about targeting, see the Adfox Help.
Step 6. Add banners
-
Prepare a creative according to the banner requirements.
-
In the Adfox interface, go to Banners in the campaign settings.
-
Click Add.
-
Select the banner type and template depending on the ad format.
Ad format (complies with the unit format in the YAN interface)
Banner type in Adfox
Template
Banner
App Mobile Banner
Interstitial ads
App Mobile Interstitial
Native ads
App Mobile Native
InStream ads
Pre-roll (App)
Mid-roll (App)
Post-roll (App)
Pause-roll (App)
Linear-Ad (Pre / Mid / Post - Roll) VAST 4.0 Viewability
Wrapper
-
The Settings tab with three sections (General settings, Contents, and Delivery settings) opens: fill in the basic fields. To learn more, see Banner requirements.
-
If necessary, set up tracking of banner placement in Adfox using pixels of third-party systems.