Connecting direct sales via Adfox

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

  1. Add an app in the Yandex Advertising Network.

  2. Create an ad unit: banner, interstitial, or native.

    Note

    You cannot add a banner with direct sales for Rewarded and App Open Ads ad units.

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

  1. Connect the app as a video resource. To learn how to do this and what requirements the app must meet, see InStream ads.

  2. 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
    1. Go to the Sites tab in the Adfox menu.

    2. 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.
    3. Click Add. A window for adding a section opens.

    4. Specify the section parameters:

      • Name: Section name, for example, iOS.
      • Category: Used to collect impression statistics for certain app categories.
    5. 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”.

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

    7. Click Add.

  3. Go to Monetization → Video advertising. Hover over the placement you want to link the Yandex Advertising Network unit to and click the + icon.

  4. A window with a list of video resources opens: select the video resource created earlier in step 1.

  5. In the Yandex Advertising Network window that opens, add an InStream unit. The unit position must match the banner type on the placement.

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

  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. Integrate the unit into the app

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

Alert

If you integrated the Yandex Mobile Ads SDK earlier, you do not need to do anything else.

Step 3.1 Integrating 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 3.2 Integrating 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.

Step 4. Set up and place a 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 5. 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