MoPub MRect Ads

MRect Ads will be rendered using MPAdView through the HyBidMoPubMRectCustomEvent adapter.

Requirements

• Ad Zone ID from the PubNative Publisher Dashboard
• MoPub Ad Unit ID for the Ad Placement that you want to request.

Create MoPub AdView

1. Declare a MPAdView *moPubMrect property.

Swift:

var moPubMrect = MPAdView()

Objective-C:

@property (nonatomic, strong) MPAdView *moPubMrect;

2. Instantiate the property that you have declared, passing in your MoPub Ad Unit ID.

Swift:

self.moPubMrect = MPAdView (adUnitId: <YOUR MoPUB AD UNIT ID HERE>, size: MOPUB_MEDIUM_RECT_SIZE)

Objective-C:

self.moPubMrect = [[MPAdView alloc] initWithAdUnitId:<YOUR MoPUB AD UNIT ID HERE>
                                                size:MOPUB_MEDIUM_RECT_SIZE];

3. Register your view controller as the moPubMrect's delegate (MPAdViewDelegate).

Swift:

self.moPubMrect.delegate = self

Objective-C:

self.moPubMrect.delegate = self;

4. Make sure to call stopAutomaticallyRefreshingContents method.

self.moPubMrect.stopAutomaticallyRefreshingContents()

Objective-C:

[self.moPubMrect stopAutomaticallyRefreshingContents];

5. Implement the MPAdViewDelegate's viewControllerForPresentingModalView method. Typically your controller can simply return self.

Swift:

extension ViewController : MPAdViewDelegate
{
    func viewControllerForPresentingModalView() -> UIViewController!
    {
        return self
    }
}

Objective-C:

#pragma mark - <MPAdViewDelegate>

- (UIViewController *)viewControllerForPresentingModalView
{
    return self;
}

For more information about MoPub MRect integration, you can refer to the MoPub Documentation as well.

Create HyBid Ad Request

1. Import HyBid into your class.

Swift:

import HyBid

Objective-C:

#import <HyBid/HyBid.h>

2. Declare a HyBidMRectAdRequest *mRectAdRequest property.

Swift:

var mRectAdRequest =  HyBidMRectAdRequest()

Objective-C:

@property (nonatomic, strong) HyBidMRectAdRequest *mRectAdRequest;

3. Instantiate the property that you have declared. After this, you can request an Ad by, passing your Ad Zone ID and also your registered view controller as the mRectAdRequest's delegate (HyBidAdRequestDelegate).

Swift:

self.mRectAdRequest.requestAd(with: self, withZoneID: <YOUR AD ZONE ID HERE>)

Objective-C:

self.mRectAdRequest = [[HyBidMRectAdRequest alloc] init];
[self.mRectAdRequest requestAdWithDelegate:self withZoneID:<YOUR AD ZONE ID HERE>];

Request Ad from MoPub

After the ad is successfully received from PubNative, the request should be made to MoPub with some parameters that will help the ad be chosen properly in the MoPub waterfall.

The HyBidPrebidUtils must be used so that the SDK can generate the proper keywords for the received ad.

Swift:

extension ViewController : HyBidAdRequestDelegate
{
    func requestDidStart(_ request: HyBidAdRequest!)
    {
        print("Request\(request) started")   
    }
    
    func request(_ request: HyBidAdRequest!, didLoadWith ad: HyBidAd!)
    {
        print("Request loaded with ad: \(ad)")
        if (request == mRectAdRequest) {
        self.moPubMrect.keywords = HyBidPrebidUtils.createPrebidKeywordsString(with: ad, with: TWO_DECIMAL_PLACES)
        self.moPubMrect.loadAd()
        }
    }
    
    func request(_ request: HyBidAdRequest!, didFailWithError error: Error!)
    {
        print("Request\(request) failed with error: \(error.localizedDescription)")
        self.moPubMrect.loadAd()  
    }
}

Objective-C:

#pragma mark - HyBidAdRequestDelegate

- (void)requestDidStart:(HyBidAdRequest *)request
{
    NSLog(@"Request %@ started:",request);
}

- (void)request:(HyBidAdRequest *)request didLoadWithAd:(HyBidAd *)ad
{
    NSLog(@"Request loaded with ad: %@",ad);
    
    if (request == self.mRectAdRequest) {
        [self.moPubMrect setKeywords:[HyBidPrebidUtils createPrebidKeywordsStringWithAd:ad withKeywordMode:TWO_DECIMAL_PLACES]];
        [self.moPubMrect loadAd];
    }
}

- (void)request:(HyBidAdRequest *)request didFailWithError:(NSError *)error
{
    NSLog(@"Request %@ failed with error: %@",request,error.localizedDescription);
    [self.moPubMrect loadAd];
}

After making this request to MoPub, it will run its waterfall and if the line item targeted by our keywords gets chosen, the HyBidMoPubMRectCustomEvent adapter will be called to render the ad.

---

<- Banner Ads            -> Interstitial Ads