Connecting direct sales via Adfox

Step 1. Add an app and create an unit in the Yandex Advertising Network

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:

1. Create counterparties (advertising chain participants).

2. Enter information about the contract with the end advertiser.

3. Add the labeling data to the site (app) structure in Adfox. In the site settings:

   1. Go to the Sites tab in the Adfox menu.

   2. Find and open the site with the required app.

   3. Select Transfer the site to the ERIR in the site settings. This opens the Labeling section.

   4. 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

  Time

  You 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 frequency

  You 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 behavior

  You 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 demographics

  Targeting 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.

  Geography

  You 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 segments

  In 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 type

  You 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 position

  You can specify the position of the placements where you want to serve your campaign's banners.

  By IP address

  You 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 system

  You can target your campaign by specific operating systems. For more information, see Adfox Help.

  By browser

  You 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 keywords

  You 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 targeting

  You 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

  1. 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.

  2. Upload the dictionary for any free additional targeting characteristic through the Adfox interface.

  3. 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 targeting

  You 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

Banner ads

InStream ads

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
Android iOS Unity Flutter React Native	Android iOS Unity Flutter React Native

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:

• Android
• iOS

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:

• Android
• iOS
• Unity
• Flutter
• React Native

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

1. Go to the Campaigns tab and click + Add.

2. 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.

3. When you select a Dynamic monetization campaign, the additional External monetizer field appears: leave the Not set value.

4. 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.

5. 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 icon. Clicking it will make the information about the advertiser appear. If the text is too long, it may be cropped and partially replaced with an ellipsis. Users can view and copy all the information by triple-clicking it.

6. If necessary, you can enable sending campaign statistics by email. For more information about sending statistics, see the Adfox Help.

7. 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.

8. 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

1. Prepare a creative according to the banner requirements.

2. In the Adfox interface, go to Banners in the campaign settings.

3. Click Add.

4. 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	HTML App Mobile Banner Image App Mobile Banner
   Interstitial ads	App Mobile Interstitial	HTML App Mobile Interstitial Image App Mobile Interstitial
   Native ads	App Mobile Native	Media Native Media Native Deeplink App Native Slider Video 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

5. The Settings tab with three sections (General settings, Contents, and Delivery settings) opens: fill in the basic fields. To learn more, see Banner requirements.

6. If necessary, set up tracking of banner placement in Adfox using pixels of third-party systems.

Contact support