Facebook Audience Network SDK for iOS Change Log

Changelog and release notes for the Facebook SDK for iOS.

Audience Network iOS SDK 5.0.0 - September 7, 2018

Added

  • New ad reporting flow
  • New interstitial designs
  • New designs for rewarded video endcards
  • Playable Ad format in Rewarded Video Placements: Playable ads are a new interactive ad format that allows advertisers to offer a short preview of their game, app or brand before people can choose to download the app.
  • Long videos now supported on Rewarded Video with skip option

Changed

  • mediaCachePolicy defaults to ALL for nativeAd, nativeBannerAd and nativeAdsManager
  • Bump the minimum supported iOS version to 9.0

Fixed

  • Fixed some crashes in AdUnitsSample
  • Fixed video resume/pause when interrupted and foregrounded

Audience Network iOS SDK 4.99.3 - August 16, 2018

Fixed

  • Fixed the horizontal vs. vertical ad format mismatch, during bid time vs. ad time
  • Fixed a crash when loading ads on lower end iOS device

Audience Network iOS SDK 4.99.2 - July 31, 2018

Fixed

  • Fixed a crash when trying to cache multiple images
  • Fixed a crash during network connection initialization
  • Fixed the collection view sample in AdUnitsSample project

Audience Network iOS SDK 4.99.1 - July 4, 2018

Added

  • Option to use a UIImageView for the icon of a nativeAd (registerViewForInteraction:mediaView:iconImageView:viewController:)

Fixed

  • Fixed a crash which occurred when blurring images

Audience Network iOS SDK 4.99.0 - June 12, 2018

Added

  • New Native Ad format, NativeBannerAd, which should now be used to display native ads with only the advertiser/app icon
  • MediaView is now enforced for Native Ads
  • New IconView is now enforced for Native Banner Ads
  • Native Ads API Updates
  • Added “advertiserName”, “headline”, “linkDescription”, “sponsoredTranslation”, “adTranslation”, “promotedTranslation”
  • Renamed “body” to “bodyText”
  • Native Ads and Native Banner ads now cache the media by default (media for nativeAd are image / video and icon. Media for nativeBannerAds is icon).
  • Added mediaDownloaded delegate method to notify app when media has been successfully downloaded
  • Added downloadMedia method on NativeAd and NativeBannerAd to download media whenever publisher please
  • mediaCachePolicy on iOS is now set upon calling loadAd
  • mediaCachePolicy on iOS is now readonly
  • Added the tagView API which allows you to declare the role of views used to build a customized native experience in your app

Removed

  • Removed “title” and “subtitle” from the Native Ads API

Fixed

  • Fixed a crash which occurred when blurring images

Audience Network iOS SDK 4.28.1 - April 9, 2018

Fixed

  • An occasional crash in the sample application when loading native ads in scrollview
  • Thumbnail image content aspect ratio for interstitial video ads

Audience Network iOS SDK 4.28.0 - March 5, 2018

Fixed

  • Publishers using Rewarded Video can now set their rewardData before or after the loadAd method. The amount field has been removed to be consistent with the Android SDK.
  • Sponsored Text translation. Text is now localized to the user
  • Merged sample apps

Audience Network iOS SDK 4.27.2 - January 9, 2018

Fixed

  • Fix for a potential crash for video ads
  • Ad Choice placement fix for interstitial ads on iPhone X

Known Issues

  • FBAdChoicesView will not be shown on Native Ads if you have set fixed height constraint for your FBAdChoicesView. Please try to use bottom space constraint.

Audience Network iOS SDK 4.27.1 - December 13, 2017

Modified

  • Rewarded video ad delegate method rewardedVideoAdComplete renamed to rewardedVideoAdVideoComplete

Fixed

  • Fix for a crash when the window property is not implemented in the application delegate
  • Fix for a potential video freeze

Audience Network iOS SDK 4.27.0 - December 5, 2017

Added

  • Added duration property to FBRewardedVideoAd
  • No longer run any code at app launch

Modified

  • Minimum required iOS SDK version is now 8.0

Fixed

  • Fix for FBMediaView video not loading after video-related failures
  • Fixes for incorrect documentation in public headers
  • Fixed a crash when FBNativeAdDelegate nativeAdDidClick: is not implemented (also fixes crash on click in FBNativeAdView)
  • Fixed FBMediaView crashes when frame is invalid
  • Fixed crash in FBMediaView video seek UI
  • Fixed incorrect bidderToken from FBAdSettings before SDK initialization
  • Fixed errors when importing library into Swift due to malformed modulemap
  • Fixed memory leak in FBMediaView image rendering

Audience Network iOS SDK 4.26.1 - November 13, 2017

Added

  • Support for iPhone X

Modified

Fixed

  • Fix for blank end cards in Rewarded Video
  • Fixed potential app initialization crash due to C++ static initializer ordering
  • Fix for Banner ads broken after touching AdChoices
  • Fixed incorrect landscape orientation for image and carousel Interstitial ads

Audience Network iOS SDK 4.26.0 - September 14, 2017

Added

  • Clear cached MediaView views on memory warning
  • Added alpha API for App Bidding
  • Replace legacy usage of destinationURL with CTA in instream ad

Modified

Fixed

  • Fixed occasional app freeze when switching rapidly between apps
  • Fixed disableAutoRefresh not actually disabling auto-refresh
  • Fixed AdChoices clicks reporting ad clicks on banner or interstitial ad to delegate
  • Fixed CTAs being cutoff in some situations for native templates
  • Disabled internal viewability validation running for internal MediaView views when hidden
  • Optimized performance of view layout for MediaView
  • Fixed crash for certain link ad content when using WKWebView browser
  • Fixed some details being missed from locale identifier causing weird language mixes
  • Fixed incorrect in-app browser reporting
  • Fixed internal issues with view controller detection
  • Prevent video from playing in certain cases, when in-app-browser is displayed
  • Fixed CTAs taking users outside of the app in some unintended cases
  • Fixed occasional crash on iOS 11 with UIApplication background state on a non-main thread causing OpenGL calls in the background

Known Issues

  • When importing FBAudienceNetwork SDK v4.26, you will get an error saying "No Such Module". To fix this issue, you need to rename FBAudienceNetwork.modulemap to module.modulemap in FBAudienceNetwork.framework/Modules folder. This will be fixed in the next release.

Audience Network iOS SDK 4.25.0 - July 26, 2017

Modified

  • Log the type of events that are dispatched from unified logging (only ids were logged to the console before)
  • Added support for offline playback of Interstitial video ads
  • Additional support for showing Interstitial ads after device orientation change
  • Minor redesign of AdUnitsSample project (now includes Instream sample)
  • Removed InstreamAdSample project
  • Added playing property to FBMediaViewVideoRenderer
  • Changed default value of FBMediaViewVideoRenderer duration property to kCMTimeIndefinite

Fixed

  • Log the type of events that are dispatched from unified logging (only ids were logged to the console before)
  • Added support for offline playback of Interstitial video ads
  • Additional support for showing Interstitial ads after device orientation change
  • Minor redesign of AdUnitsSample project (now includes Instream sample)
  • Removed InstreamAdSample project