MMCustomEventBannerDelegate Protocol Reference

Conforms to NSObject
Declared in MMCustomEventBanner.h

Overview

This protocol indicates a communication channel back to the placement, in order to communicate user events and other information that may be important for the display or management of the ad. Any implementers of the MMCustomEventBanner protocol should make a best effort to send these messages where appropriate.

– customEventBannerLoadSucceeded: required method

This method should be called when an MMCustomEventBanner succeeds in loading ad content.

- (void)customEventBannerLoadSucceeded:(id<MMCustomEventBanner>)customEventBanner

Parameters

customEventBanner

The instance of custom event banner that called the callback.

Discussion

This method should be called when an MMCustomEventBanner succeeds in loading ad content.

Declared In

MMCustomEventBanner.h

– customEventBanner:loadFailedWithError: required method

This method should be called when an MMCustomEventBanner fails to load an ad, with an appropriate error message.

- (void)customEventBanner:(id<MMCustomEventBanner>)customEventBanner loadFailedWithError:(NSError *)error

Parameters

customEventBanner

The instance of custom event banner that called the callback.

error

The error which caused the load failure. It is recommended to use the standard error MMSDKErrorCode codes when passing an error back to an inline placement.

Discussion

This method should be called when an MMCustomEventBanner fails to load an ad, with an appropriate error message.

Declared In

MMCustomEventBanner.h

– customEventBannerContentTapped: required method

This method should be called whenever the content of the ad is tapped. This not only notifies any listeners on the placement, but also records an SDK reporting event, which may help resolve reporting or revenue discrepancies.

- (void)customEventBannerContentTapped:(id<MMCustomEventBanner>)customEventBanner

Parameters

customEventBanner

The instance of custom event banner that called the callback.

Discussion

This method should be called whenever the content of the ad is tapped. This not only notifies any listeners on the placement, but also records an SDK reporting event, which may help resolve reporting or revenue discrepancies.

Declared In

MMCustomEventBanner.h

– customEventBannerWillPresentModal: required method

This method should be called when the ad will present a modal.

- (void)customEventBannerWillPresentModal:(id<MMCustomEventBanner>)customEventBanner

Parameters

customEventBanner

The instance of custom event banner that called the callback.

Discussion

This method should be called when the ad will present a modal.

Declared In

MMCustomEventBanner.h

– customEventBannerDidPresentModal: required method

This method should be called when the ad has presented a modal.

- (void)customEventBannerDidPresentModal:(id<MMCustomEventBanner>)customEventBanner

Parameters

customEventBanner

The instance of custom event banner that called the callback.

Discussion

This method should be called when the ad has presented a modal.

Declared In

MMCustomEventBanner.h

– customEventBannerWillCloseModal: required method

This method should be called when the ad will close a modal.

- (void)customEventBannerWillCloseModal:(id<MMCustomEventBanner>)customEventBanner

Parameters

customEventBanner

The instance of custom event banner that called the callback.

Discussion

This method should be called when the ad will close a modal.

Declared In

MMCustomEventBanner.h

– customEventBannerDidCloseModal: required method

This method should be called when the ad has closed a modal.

- (void)customEventBannerDidCloseModal:(id<MMCustomEventBanner>)customEventBanner

Parameters

customEventBanner

The instance of custom event banner that called the callback.

Discussion

This method should be called when the ad has closed a modal.

Declared In

MMCustomEventBanner.h

– customEventBannerWillLeaveApplication: required method

This method should be called when the ad content will cause the current application to enter the background.

- (void)customEventBannerWillLeaveApplication:(id<MMCustomEventBanner>)customEventBanner

Parameters

customEventBanner

The instance of custom event banner that called the callback.

Discussion

This method should be called when the ad content will cause the current application to enter the background.

Declared In

MMCustomEventBanner.h

  requestedSize required method

The actual size of the ad requested by the user. It may be different from a pre-defined ad placement size, or even the size of the ad which is provided. A best effort should be made to provide content which will fit in this size.

@property (nonatomic, readonly) CGSize requestedSize

Discussion

The actual size of the ad requested by the user. It may be different from a pre-defined ad placement size, or even the size of the ad which is provided. A best effort should be made to provide content which will fit in this size.

Declared In

MMCustomEventBanner.h

  transitionStyle required method

The transition style that has been requested by the publisher. If at all possible, when displaying a modal, this value should be used.

@property (nonatomic, readonly) UIModalTransitionStyle transitionStyle

Discussion

The transition style that has been requested by the publisher. If at all possible, when displaying a modal, this value should be used.

Declared In

MMCustomEventBanner.h

  presentationViewController required method

The view controller that the publisher has set for presenting modal views.

@property (nonatomic, readonly) UIViewController *presentationViewController

Discussion

The view controller that the publisher has set for presenting modal views.

Declared In

MMCustomEventBanner.h