Rewarded

Rewarded units occupy the entire screen. When the user views such ads, they get a reward (for example, access to a file or exclusive content on the site). The time before the reward is shown as a countdown timer. If the user closes the ad earlier, they won't get rewarded.

You can display rewarded units on both the desktop and mobile versions of the site. If you want the ad to appear on all devices, you need to create a separate unit for each version of the site.

The unit can show:

  • Text & Image ads with the Fullscreen  format.

  • Display ads: They are selected automatically and occupy the maximum unit area. The aspect ratio of display ads is close to the size of the user's screen.

  • Video ads.

How to use the unit

The unit is good for:

  • Media and portals offering exclusive information.

  • Dating sites.

  • File sharing sites.

  • Resources that utilize gaming mechanics and in-game currency.

When using rewarded units, observe the following requirements:

  • A rewarded unit is only displayed if the user explicitly consents to view an ad (for example, by following the “View ad to access the document” link).

  • The user will definitely get a reward for viewing the ad. Read the instructions below on how to reward users.

These requirements apply to rewarded units, but not to fullscreen units: the latter appear without the user's consent and do not bring them a reward. If a rewarded unit doesn't meet the requirements, it may be blocked.

How to create a rewarded unit

Alert

To get access to rewarded ad units, contact support by email or chat.

  1. In the Yandex Advertising Network interface, go to Ads on websites → Ad units and click New ad unit.

  2. Select the site that you want to create an ad unit for and click Next.

  3. Select the Rewarded unit type.

  4. Enter a unit name to be used in the Yandex Advertising Network interface.

  5. Select the platform: Desktop or Mobile. If you want to display the unit on both platforms, create a separate unit for each of them. In the desktop version, the unit will appear when navigating between pages and occupy the entire screen area.

  6. Set the CPM floor:

    • Maximum revenue: Determine the minimum cost of impressions automatically. With this option, you can effectively fill placements and maximize revenue for the site owner.

    • CPMV floor: Set your own minimum cost per thousand impressions based on a viewability check. The CPMV floor is set in rubles, US dollars, or euros. You can change the floor currency in your account settings.

      Alert

      Setting a CPMV floor can reduce the unit fill rate and, therefore, decrease your income.

  7. Specify the time before the reward in seconds (the maximum is 60). If the user closes the ad earlier, they won't get rewarded.

  8. Choose a theme: Dark or Light. The default option is Light theme. Dark theme units have a different background and color scheme for their text, frame, buttons, and other elements. The selected theme is applied to all ad formats within the unit.

  9. Choose how you want to configure ad formats

    • Use standard settings: When this option is selected, the unit displays all available formats: Text & Image ads, display ads, and video ads. The ad design is determined automatically.

    • Configure the formats: You can disable the display of some formats or change their design:

      Main design applies to Fullscreen  Text & Image ads.

      In the preview area, you can preview the unit's appearance in different framing containers and on different devices. To do this, fill in the Container field for the desktop site version or Screen field for the mobile version. You can select a value from the list or set the size yourself by selecting Custom.

      Note

      The specified container size is used only to generate the preview area and isn't saved in the unit settings.

      Display ads are served automatically based on the unit size.

      You can't disable the format.

      Video ads are selected automatically based on the unit size.

      You can't disable the format.

  10. Click Create. A window with the embed code will open. Use this code to place the ad unit on your site.

How to add a rewarded unit to your site

  1. Get the embed code: create a new unit or click Get code in the settings of an existing unit.

  2. Copy the YAN loader code to the clipboard. Paste it inside the <head> tag of the page where you want to display a rewarded unit. The loader code is only embedded on the page once and is used to call all units of the Yandex Advertising Network.

  3. Set up rewards for users who view the ad completely. To do this, add the onRewarded callback function to the unit code and define the reward action. Acceptable values: true ― the reward condition is met, false ― the reward condition isn't met.

    <!-- Yandex.RTB R-A-588461-68 -->
    <script>window.yaContextCb.push(()=>{
      Ya.Context.AdvManager.render({
        blockId: 'R-A-588461-68',
        type: 'rewarded',
        platform: 'desktop', // change the value to 'touch' for the mobile version
        onRewarded: (isRewarded) => {
            if (isRewarded) {
                // the reward condition is met
            } else {
                // the reward condition isn't met
            }
        }
      })
    })
    </script>
    
  4. Add the resulting unit code within the <body> tag on the page so that it can be invoked by clicking a button or performing an action on your site. The button text or call to action should be unambiguous, clearly indicating to the user that the action will open an ad unit, and upon completion of the ad, they will receive a reward.

    If you want to use the rewarded unit for desktop and mobile devices on a site with adaptive layout, add both unit codes one after another. YAN will automatically request the code that matches the user's device.

    To check the site version and call the proper ad unit, you can add the Ya.Context.AdvManager.getPlatform() method to the embed code.

    Sample code for a rewarded unit on a site with adaptive layout
    <script>
      window.yaContextCb.push(() => {
          if (Ya.Context.AdvManager.getPlatform() === 'desktop') {
            // calling the rewarded unit for the desktop version
            Ya.Context.AdvManager.render({
              blockId: 'R-A-588461-68',
              type: 'rewarded',
              platform: 'desktop',
              onRewarded: (isRewarded) => {
                  if (isRewarded) {
                      // the reward condition is met
                  } else {
                      // the reward condition isn't met
                  }
              }
            });
          } else {
            // calling the rewarded unit for the mobile version
            Ya.Context.AdvManager.render({
              blockId: 'R-A-588461-69',
              type: 'rewarded',
              platform: 'touch',
              onRewarded: (isRewarded) => {
                  if (isRewarded) {
                      // the reward condition is met
                  } else {
                      // the reward condition isn't met
                  }
              }
            });
          }
      });
    </script>
    

Contact support

Write to WhatsApp Go to WhatsApp

Write to chat

Send an email



You can also go to





Previous