Loading ads

1. Create an instance of the YMANativeAdLoader class to get native ads.

2. Create a configuration for the nativeAdRequestConfiguration request using the YMANativeAdRequestConfiguration class. As the request parameters, you can use the ad unit ID, method for loading images, age, gender, and other data that might improve the quality of ad selection.

3. Set a delegate for retrieving an ad that implements the YMANativeAdLoaderDelegate protocol:

4. To track the ad loading process, implement the YMANativeAdLoaderDelegate protocol methods: -nativeAdLoader:didFailLoadingWithError: and -nativeAdLoader:didLoadAd:.

5. To load the ad, send the loadAdWithRequestConfiguration: message to the loader.

   • Swift
   • Objective-C

   adLoader.loadAd(with: requestConfiguration)

   [self.adLoader loadAdWithRequestConfiguration:requestConfiguration];
6. If the ad loaded, the following method is called:

   • Swift
   • Objective-C

   func nativeAdLoader(_ loader: YMANativeAdLoader, didLoad ad: YMANativeAd)

   - (void)nativeAdLoader:(YMANativeAdLoader *)loader didLoadAd:(id<YMANativeAd>)ad
7. If the ad didn't load, the following method is called:

   • Swift
   • Objective-C

   func nativeAdLoader(_ loader: YMANativeAdLoader, didFailLoadingWithError error: Error)

   - (void)nativeAdLoader:(YMANativeAdLoader *)loader didFailLoadingWithError:(NSError *)error

   For more information about possible errors, see YMANativeErrorCode.

General ad request

• Swift
• Objective-C

// Creating a loader 
adLoader = YMANativeAdLoader()
adLoader.delegate = self

// Creating a request configuration 
let requestConfiguration = YMANativeAdRequestConfiguration(adUnitID: "<AdUnitID>")

// Passing the request configuration to the loader
adLoader.loadAd(with: requestConfiguration)

// Implementing delegate methods
....

func nativeAdLoader(_ loader: YMANativeAdLoader, didLoad ad: YMANativeAd) {
    // Render the ad 
}

// Creating a loader self.adLoader = [[YMANativeAdLoader alloc] init];
self.adLoader.delegate = self;

// Creating a request configuration
YMANativeAdRequestConfiguration *requestConfiguration =
        [[YMANativeAdRequestConfiguration alloc] initWithAdUnitID:@"your_AdUnitID"];

// Passing the request configuration to the loader 
[self.adLoader loadAdWithRequestConfiguration:requestConfiguration];

// Implementing delegate methods
....
- (void)nativeAdLoader:(YMANativeAdLoader *)loader didLoadAd:(id<YMANativeAd>)ad
{
     // Render the ad 
}

Yandex Mobile Ads SDK provides the option to load multiple ads in a single request (up to nine ads).

1. Create an instance of the YMANativeBulkAdLoader class to get native ads.

2. Create a configuration for the nativeAdRequestConfiguration request using the YMANativeAdRequestConfiguration class. As the request parameters, you can use the ad unit ID, method for loading images, age, gender characteristics, and other data that might improve the quality of ad selection.

3. Set a delegate for retrieving an ad that implements the YMANativeBulkAdLoaderDelegate protocol.

4. To track the ad loading process, implement the YMANativeBulkAdLoaderDelegate protocol methods: -nativeBulkAdLoader:didLoadAds: and -nativeBulkAdLoader:didFailLoadingWithError:.

5. Send to the loader the request configuration and count of ads requested (the adsCount parameter).

   • Swift
   • Objective-C

   adLoader.loadAds(with: requestConfiguration, adsCount: adsCount)

   [self.adLoader loadAdsWithRequestConfiguration:requestConfiguration adsCount:adsCount];

// Creating a request configuration
let requestConfiguration = YMAMutableNativeAdRequestConfiguration(adUnitID: AdUnitID)

// Creating a loader
adLoader = YMANativeBulkAdLoader()
adLoader.delegate = self

// Passing the request configuration and the number of requested ads to the loader
adLoader.loadAds(with: requestConfiguration, adsCount: adsCount)

// Implementing delegate methods

func nativeBulkAdLoader(_ nativeBulkAdLoader: YMANativeBulkAdLoader, didLoad ads: [YMANativeAd]) {
    ...
    // Working with each id<YMANativeAd> object separately. For more information, see "Customizing the ad design".
}

// Creating a request configuration
YMAMNativeAdRequestConfiguration *requestConfiguration =
    [[YMANativeAdRequestConfiguration alloc] initWithAdUnitID:AdUnitID];
    
// Creating a loader 
self.adLoader = [[YMANativeBulkAdLoader alloc] init];
self.adLoader.delegate = self;

// Passing the request configuration and count of requested ads to the loader
[self.adLoader loadAdsWithRequestConfiguration:requestConfiguration adsCount:adsCount];

// Implementing delegate methods

- (void)nativeBulkAdLoader:(YMANativeBulkAdLoader *)nativeBulkAdLoader didLoadAds:(NSArray<idYMANativeAd> *)ads
{
    ...
    // Working with each id<YMANativeAd> object separately. For more information, see "Customizing the ad design".
}