Adding Native Ads to your iOS App

1. After you have created a new project from iOS Getting Started guides, open Main.storyboard. Add a UIView element to the main View element and name it to adUIView.
   
   
   
2. In addition, add adIconImageView (FBMediaView), adTitleLabel (UILabel), adCoverMediaView (FBMediaView), adSocialContext (UILabel), adCallToActionButton (UIButton), adOptionsView (FBAdOptionsView), adBodyLabel (UILabel), sponsoredLabel (UILabel) under adUIView as illustrated in the image below.
   
   
   
3. You may notice that there is a red arrow nearby View Controller Scene. This usually means that there are missing constraints in your layout.
   
   
   You would need to select all the view objects in your scene and click the "resolve layout issue" icon to add missing constraints.
   
   
   
4. Now that you have created all the UI elements for showing a native ad, you will need to reference these UI elements in the ViewController interface. First open the ViewController.m (ViewController.swift if you are using Swift), then drag adUIView inside the ViewController object. You can name it as adUIView. After, you will need to do the same thing for adIconImageView , adTitleLabel, adCoverMediaView, adSocialContext, adCallToActionButton, adOptionsView, adBodyLabel, sponsoredLabel.
   
   
   
5. Build and run the project. You should see from your device or simulator empty content as follows:
   

1. In your View Controller source file, import the SDK, declare that ViewController conforms to the FBNativeAdDelegate protocol, and add a FBNativeAd instance variable
   Select language

   SwiftObjective-C

   ---

   import UIKit
   import FBAudienceNetwork
   
   class ViewController: UIViewController, FBNativeAdDelegate {
   
     private var nativeAd: FBNativeAd?
   }
   



2. In the viewDidLoad method, add the following lines of code to load the native ad content
   Select language

   SwiftObjective-C

   ---

   override func viewDidLoad() {
     super.viewDidLoad()
   
     let nativeAd = FBNativeAd(placementID: "YOUR_PLACEMENT_ID")
     nativeAd.delegate = self
     nativeAd.loadAd()
   }
   

   
   
   The ID that displays at YOUR_PLACEMENT_ID is a temporary ID for test purposes only.
   If you use this temporary ID in your live code, your users will not receive ads (they will get a No Fill error). You must return here after testing and replace this temporary ID with a live Placement ID.
   To find out how the generate a live Placement ID, refer to Audience Network Setup
3. The next step is to show the ad when the content is ready. You would need your ViewController to implement the nativeAdDidLoad delegate method
   Select language

   SwiftObjective-C

   ---

   func nativeAdDidLoad(_ nativeAd: FBNativeAd) {
   
   // 1. If there is an existing valid native ad, unregister the view
   if let previousNativeAd = self.nativeAd, previousNativeAd.isAdValid {
     previousNativeAd.unregisterView()
   }
   
   // 2. Retain a reference to the native ad object
   self.nativeAd = nativeAd
   
   // 3. Register what views will be tappable and what the delegate is to notify when a registered view is tapped
   // Here only the call-to-action button and the media view are tappable, and the delegate is the view controller
   nativeAd.registerView(
     forInteraction: adUIView,
     mediaView: adCoverMediaView,
     iconView: adIconImageView,
     viewController: self,
     clickableViews: [adCallToActionButton, adCoverMediaView]
   )
   
     // 4. Render the ad content onto the view
     adTitleLabel.text = nativeAd.advertiserName
     adBodyLabel.text = nativeAd.bodyText
     adSocialContextLabel.text = nativeAd.socialContext
     sponsoredLabel.text = nativeAd.sponsoredTranslation
     adCallToActionButton.setTitle(nativeAd.callToAction, for: .normal)
     adOptionsView.nativeAd = nativeAd
   }
   

Controlling Clickable Area

For a better user experience and better results, you should always consider controlling the clickable area of your ad to avoid unintentional clicks. Please refer to Audience Network SDK Policy page for more details about white space unclickable enforcement.



4. Choose your build target to be device and run the above code, you should see something like this:
   
   
   
   

1. Declare that your View Controller implements the FBMediaViewDelegate protocol
   Select language

   SwiftObjective-C

   ---

   class ViewController: UIViewController, FBNativeAdDelegate, FBMediaViewDelegate {
     ...
   }
   



2. When the native ad is loaded, set the delegate of FBMediaView object to be your view controller
   Select language

   SwiftObjective-C

   ---

   func nativeAdDidLoad(_ nativeAd: FBNativeAd) {
     adCoverMediaView.delegate = self
   }
   



3. Implement mediaViewDidLoad method in your view controller
   Select language

   SwiftObjective-C

   ---

   func mediaViewDidLoad(_ mediaView: FBMediaView) {
     let currentAspect = mediaView.frame.size.width / mediaView.frame.size.height
     print(currentAspect)
   
     let actualAspect = mediaView.aspectRatio
     print(actualAspect)
   }
   

   
   mediaView.aspectRatio returns a positive CGFloat, or 0.0 if no ad is currently loaded. Its value is valid after media view is loaded. There are convenience methods that will set the width and height of the FBMediaView object respecting its apsect ratio of the media content loaded. You can call applyNaturalWidth or applyNaturalHeight to update the FBMediaView object's width or height to respect the media content's aspect ratio.

func nativeAdDidClick(_ nativeAd: FBNativeAd) {
  print("Native ad was clicked.")
}

func nativeAdDidFinishHandlingClick(_ nativeAd: FBNativeAd) {
  print("Native ad did finish click handling.")
}

func nativeAdWillLogImpression(_ nativeAd: FBNativeAd) {
  print("Native ad impression is being captured.")
}

func nativeAd(_ nativeAd: FBNativeAd, didFailWithError error: Error) {
  print("Native ad failed to load with error: \(error.localizedDescription)")
}

1. We strongly recommend to leave media caching on by default in all cases. However, we allow you to override the default. Please be very careful if you decide to override our default media caching
   Select language

   SwiftObjective-C

   ---

   let nativeAd = FBNativeAd(placementID: "YOUR_PLACEMENT_ID")
   nativeAd.delegate = self
   nativeAd.loadAd(withMediaCachePolicy: .none)
   



2. First, you will need to manually download all media for the native ad
   Select language

   SwiftObjective-C

   ---

   func nativeAdDidLoad(_ nativeAd: FBNativeAd) {
   
   ...
   
   self.adCoverMediaView.delegate = self
   nativeAd.downloadMedia()
   self.nativeAd = nativeAd
   
     ...
   }
   



3. Next, you should only call registerViewForInteraction and display the ad after mediaViewDidLoad callback. All media has to be loaded and displayed for an eligible impression
   Select language

   SwiftObjective-C

   ---

   func mediaViewDidLoad(_ mediaView: FBMediaView) {
     guard let nativeAd = nativeAd else {
       return
     }
   
   // 1. Register what views will be tappable and what the delegate is to notify when a registered view is tapped
   // Here only the call-to-action button and the media view are tappable, and the delegate is the view controller
   nativeAd.registerView(
     forInteraction: adUIView,
     mediaView: mediaView,
     iconView: adIconImageView,
     viewController: self,
     clickableViews: [adCallToActionButton, mediaView]
   )
   
     // 2. Render the ad content onto the view
     adTitleLabel.text = nativeAd.advertiserName
     adBodyLabel.text = nativeAd.bodyText
     adSocialContextLabel.text = nativeAd.socialContext
     sponsoredLabel.text = nativeAd.sponsoredTranslation
     adCallToActionButton.setTitle(nativeAd.callToAction, for: .normal)
     adOptionsView.nativeAd = nativeAd
   }
   

• Once your app has a link on the App Store or Google Play Store, configure Audience Network in Monetization Manager to get ad placement IDs.
• Follow the guides to implement ad formats in your app.

• Visit our GitHub sample app repository⁠ to view sample code.
• View the Audience Network policies and the Facebook community standards⁠ to ensure your app complies.