GoogleMobileAds Framework Reference

  • GADMediatedUnifiedNativeAdNotificationSource enables adapters to inform the Google Mobile Ads SDK about user interactions and events related to a mediated native ad.

  • Adapters use this class to notify the SDK about impressions, clicks, screen presentations, video playback events, and other relevant actions performed by the user or the ad itself.

  • By calling specific methods within this class, adapters ensure the Google Mobile Ads SDK remains synchronized with the ad's lifecycle and user engagement.

  • This communication is crucial for accurate tracking, reporting, and overall ad performance within the Google Mobile Ads ecosystem.

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;