Lesson 3: Getting started with an ad campaign
To launch direct ad campaigns in Adfox, create an app in the Yandex Advertising Network interface, add ad units to it, and connect Adfox to them. After that, you can create an ad campaign in the Adfox interface.
How to create an app and set up ad units in the Yandex Advertising Network partner interface
- Log in to your Yandex Advertising Network account.
- Add an app and verify your ownership.
The app will be automatically submitted for moderation, a process that takes no more than two days. During this time, you can create and connect ad units, but ad impressions will only begin after the app passes moderation and your access is confirmed. - Create an ad unit. Direct sales are supported only for banner, interstitial, native, and InStream ad units.
Banner advertising. You can display ad creatives as banners that take up part of the screen. Banners can be images or HTML code.
Interstitial advertising. You can serve interstitial ads on the app's splash screen or between screen transitions. Ads can be images or HTML code.
Native advertising. These ads can change based on the design and features of the app in which they appear.
The layout of a native ad adapts to its environment. You get a banner from the ad network and apply your own design to the ad elements.
We'll discuss InStream advertising in the next topic.
- Connect Adfox: Go to Ad networks, open the ad unit settings, and navigate to the Yandex Advertising Network settings to enable the Connect Adfox option.
After that, the app structure will automatically appear in the Adfox interface, and the new ad unit will be linked to the placement.
The app structure includes the site, section, and placement.
- In Adfox terms, the site is your mobile app.
- The section is an object within the site.
- The placement is a specific ad slot in your app.
- Now, integrate the Yandex Mobile Ads SDK into the app and connect the ad unit.
For instructions on how to integrate the Yandex Mobile Ads SDK for different platforms, see Help:
To enable direct sales, follow this guide.
InStream advertising is a video ad format where the ad clip is embedded into the video stream and plays before, during, or after the main video.
To launch direct ad campaigns with InStream advertising in Adfox, connect your app as a video resource in the Yandex Advertising Network and create an ad unit.
1. Add the app as a video resource.
Ensure the app meets the requirements for video partners:
- The app generates a traffic of 10,000 or more unique users per day for a month or longer.
- The app publishes only licensed content or your own content, not aggregated user-generated content.
Submit a request to support.Include the app link in your request.
The app will then be submitted for moderation, which usually takes no more than two days.
Once the video resource is connected, the app appears in the Yandex Advertising Network interface in the Ads in videos → Video resources tab. The app will get a unique identifier (Page ID) and the New status. After passing moderation, the app’s status changes to “Working. No statistics”.
2. Create a unit
- Go to the InStream Video Units tab, then click Add video unit.
- In the General tab, fill in the required fields.
- In the Strategy tab, choose the appropriate traffic management strategy:
- The Maximum revenue strategy uses all available traffic and doesn’t require you to manage it manually.
- The Minimum CPM strategy allows you to set the minimum bid for RTB advertising in your app. If auction bids exceed this threshold, banners from Yandex RTB will be shown. If bids are below the floor, your own ads set up in the relevant field will be displayed.
- The Separate CPM strategy allows you to limit the number of impressions for Yandex Direct video advertising: video ads up to 15 seconds and display videos up to 60 seconds. You can set CPM thresholds or completely disable a specific type of advertising. If you haven’t disabled any ad or specified a floor, the system considers the floor to be zero.
- Click Save.
- Integrate the ad unit into the app following the instructions: Android | iOS.
3. Add your app structure to Adfox
The app structure includes the site, section, and placement.
- In Adfox terms, the site is your mobile app.
- The section is an object within the site.
- The placement is a specific ad slot in your app.
Step 1. Add a site
- Navigate to the Sites tab and click + Add.
- Specify the general settings for the app.
- Name: Enter the name of your app.
- Site owner: Specify the user who will access the impression statistics. If it’s your own app and you’ll be the one working with statistics, you may omit the owner. You can add or change the site owner at any time.
Then click Add.
Step 2. Add a section
Specify the section parameters.
- Name: Enter a name for this section.
- Be sure to disable the ‘Dynamic definition by REFERER’ option.
Step 3. Add a placement.
Specify its general settings.
- Name. We recommend that you specify the position of your ad placement.
- Banner type. Defines the ad format supported by this placement. Choose one of the banner types:
- Pre-roll (App): To display the ad before the video.
- Mid-roll (App): To display the ad during the video.
- Post-roll (App): To display the ad after the video.
- Pause-roll (App): To display the ad when the user pauses the video.
- Position. Defines the logical location of the placement in the page’s sections. This parameter is optional.
Click the Add button.
4. Add an InStream unit to the placement
- Go to Monetization → Video advertising. Hover over the placement you want to link to the Yandex Advertising Network unit and click “+”.
- This opens a window with a list of video resources. Select the video resource you created previously.
- In the Yandex Advertising Network’s window that opens, add the InStream unit. The ad unit’s position should match the banner type in the placement.
- Click Save.
5. Integrate the ad unit into the app.
Step 1. Integrate Yandex Mobile Ads SDK into the app and connect the ad unit. Read more in the Yandex Mobile Ads SDK section:
Step 2. Integrate InStream ads into the player.
- Get the
PAGE_ID
of the video resource in the Yandex Advertising Network (you don’t need the full AdUnit in theR-M-page_id-block_id
format). - There are several APIs that support InStream advertising:
- ExoPlayer AdsLoader API: For basic integration.
- Instream API: For advanced integration.
Instructions for Android and iOS.
In response to an ad request, the SDK will receive the VMAP for the specified PAGE_ID
. The adBreakType
parameters of your Adfox placement (for example, Pre-roll) will be updated with the links to the request for the appropriate Adfox placement.
If you specified a section of the video resource when creating a video unit, be sure to also pass its ID in the CATEGORY_ID
parameter.