GoogleMobileAds Framework Reference

AI-generated Key Takeaways

• GADCustomNativeAdDelegate helps identify native ad assets and provides lifecycle event callbacks.

• It includes methods to track impressions and clicks on custom native ads.

• This delegate also provides notifications for click-time lifecycle events such as presenting and dismissing full-screen views.

• Developers can use these callbacks to manage application behavior in response to ad interactions, like pausing animations or restarting them.

• These methods help to integrate custom native ads seamlessly into an application and manage the user experience around ad interactions.

GADCustomNativeAdDelegate

@protocol GADCustomNativeAdDelegate <NSObject>

Identifies native ad assets.

Ad Lifecycle Events

• -customNativeAdDidRecordImpression:

  Called when an impression is recorded for a custom native ad.

  Declaration

  Swift

  optional func customNativeAdDidRecordImpression(_ nativeAd: GADCustomNativeAd)

  Objective-C

  - (void)customNativeAdDidRecordImpression:(nonnull GADCustomNativeAd *)nativeAd;

• -customNativeAdDidRecordClick:

  Called when a click is recorded for a custom native ad.

  Declaration

  Swift

  optional func customNativeAdDidRecordClick(_ nativeAd: GADCustomNativeAd)

  Objective-C

  - (void)customNativeAdDidRecordClick:(nonnull GADCustomNativeAd *)nativeAd;

Click-Time Lifecycle Notifications

• -customNativeAdWillPresentScreen:

  Called just before presenting the user a full screen view, such as a browser, in response to clicking on an ad. Use this opportunity to stop animations, time sensitive interactions, etc.

  Normally the user looks at the ad, dismisses it, and control returns to your application with the customNativeAdDidDismissScreen: message. However, if the user hits the Home button or clicks on an App Store link, your application will end. The next method called will be the applicationWillResignActive: of your UIApplicationDelegate object.

  Declaration

  Swift

  @MainActor optional func customNativeAdWillPresentScreen(_ nativeAd: GADCustomNativeAd)

  Objective-C

  - (void)customNativeAdWillPresentScreen:(nonnull GADCustomNativeAd *)nativeAd;

• -customNativeAdWillDismissScreen:

  Called just before dismissing a full screen view.

  Declaration

  Swift

  @MainActor optional func customNativeAdWillDismissScreen(_ nativeAd: GADCustomNativeAd)

  Objective-C

  - (void)customNativeAdWillDismissScreen:(nonnull GADCustomNativeAd *)nativeAd;

• -customNativeAdDidDismissScreen:

  Called just after dismissing a full screen view. Use this opportunity to restart anything you may have stopped as part of customNativeAdWillPresentScreen:.

  Declaration

  Swift

  @MainActor optional func customNativeAdDidDismissScreen(_ nativeAd: GADCustomNativeAd)

  Objective-C

  - (void)customNativeAdDidDismissScreen:(nonnull GADCustomNativeAd *)nativeAd;