GoogleMobileAds Framework Reference

  • GADMediatedUnifiedNativeAdNotificationSource enables adapter communication with the Google Mobile Ads SDK regarding user interactions and events related to mediated native ads.

  • Adapters use this class to inform the SDK about impressions, clicks, screen presentations, and dismissals, ensuring accurate tracking and ad lifecycle management.

  • It includes specific methods for signaling the start, pause, and end of video playback for mediated native video ads, providing comprehensive video ad event tracking.

  • Adapters should utilize these notification methods to maintain synchronization between their actions and the Google Mobile Ads SDK, ultimately improving ad performance and user experience.

GADMediatedUnifiedNativeAdNotificationSource


@interface GADMediatedUnifiedNativeAdNotificationSource : NSObject

Notifies the Google Mobile Ads SDK about the events performed by adapters. Adapters may perform some action (e.g. opening an in app browser or opening the iTunes store) when handling methods in GADMediatedUnifiedNativeAd. Adapters in such case should notify the Google Mobile Ads SDK by calling the relevant methods from this class.

  • Called by the adapter when it has registered an impression on the tracked view. Adapter should only call this method if -[GADMAdNetworkAdapter handlesUserImpressions] returns YES.

    Declaration

    Swift

    class func mediatedNativeAdDidRecordImpression(_ mediatedNativeAd: any MediatedUnifiedNativeAd)

    Objective-C

    + (void)mediatedNativeAdDidRecordImpression:
    (nonnull id<GADMediatedUnifiedNativeAd>)mediatedNativeAd;

  • Called by the adapter when it has registered a user click on the tracked view. Adapter should only call this method if -[GADMAdNetworkAdapter handlesUserClicks] returns YES.

    Declaration

    Swift

    class func mediatedNativeAdDidRecordClick(_ mediatedNativeAd: any MediatedUnifiedNativeAd)

    Objective-C

    + (void)mediatedNativeAdDidRecordClick:
    (nonnull id<GADMediatedUnifiedNativeAd>)mediatedNativeAd;

  • Must be called by the adapter just before mediatedNativeAd has opened an in-app modal screen.

    Declaration

    Swift

    class func mediatedNativeAdWillPresentScreen(_ mediatedNativeAd: any MediatedUnifiedNativeAd)

    Objective-C

    + (void)mediatedNativeAdWillPresentScreen:
    (nonnull id<GADMediatedUnifiedNativeAd>)mediatedNativeAd;

  • Must be called by the adapter just before the in-app modal screen opened by mediatedNativeAd is dismissed.

    Declaration

    Swift

    class func mediatedNativeAdWillDismissScreen(_ mediatedNativeAd: any MediatedUnifiedNativeAd)

    Objective-C

    + (void)mediatedNativeAdWillDismissScreen:
    (nonnull id<GADMediatedUnifiedNativeAd>)mediatedNativeAd;

  • Must be called by the adapter after the in-app modal screen opened by mediatedNativeAd is dismissed.

    Declaration

    Swift

    class func mediatedNativeAdDidDismissScreen(_ mediatedNativeAd: any MediatedUnifiedNativeAd)

    Objective-C

    + (void)mediatedNativeAdDidDismissScreen:
    (nonnull id<GADMediatedUnifiedNativeAd>)mediatedNativeAd;

Mediated Native Video Ad Notifications

  • Called by the adapter when native video playback has begun or resumed.

    Declaration

    Swift

    class func mediatedNativeAdDidPlayVideo(_ mediatedNativeAd: any MediatedUnifiedNativeAd)

    Objective-C

    + (void)mediatedNativeAdDidPlayVideo:
    (nonnull id<GADMediatedUnifiedNativeAd>)mediatedNativeAd;

  • Called by the adapter when native video playback has paused.

    Declaration

    Swift

    class func mediatedNativeAdDidPauseVideo(_ mediatedNativeAd: any MediatedUnifiedNativeAd)

    Objective-C

    + (void)mediatedNativeAdDidPauseVideo:
    (nonnull id<GADMediatedUnifiedNativeAd>)mediatedNativeAd;

  • Called by the adapter when native video playback has ended.

    Declaration

    Swift

    class func mediatedNativeAdDidEndVideoPlayback(_ mediatedNativeAd: any MediatedUnifiedNativeAd)

    Objective-C

    + (void)mediatedNativeAdDidEndVideoPlayback:
    (nonnull id<GADMediatedUnifiedNativeAd>)mediatedNativeAd;