Facebook Audience Network SDK for iOS Change Log

Changelog and release notes for the Facebook SDK for iOS.

Audience Network iOS SDK 5.3.1 - April 16, 2019

This version is identical to 5.3.0 but built with XCode 10.1. Please use this if you are not using XCode 10.2 or later to build your application.

Audience Network iOS SDK 5.3.0 - April 15, 2019

This version will work with XCode 10.2 or later. In case XCode 10.1 is used to build the application, please use Audience Network SDK 5.3.1

Added

  • Interstitial design improvements

Fixed

  • Fixed issue with CFBundleSupportedPlatforms value in Info.plist
  • Fixes for Playable ads
  • Fixed initial volume for interstitial ads

Audience Network iOS SDK 5.2.0 - February 20, 2019

Added

  • Nullability specifiers
  • An option to hide ad reporting icon from AdOptionsView
  • New native templates - an easier way to add Native Ads to your app.
  • Interstitial design improvements

Fixed

  • Timer and animation starting if card already chosen for a rewarded ad

Audience Network iOS SDK 5.1.1 - January 16, 2019

Fixed

  • Interstitial videos continuing to play after the user clicked to report an ad.
  • Bidder tokens being corrupted under certain conditions.

Changed

  • registerViewForInteraction for NativeAds and NativeBannerAds must now run from Main Thread.

Audience Network iOS SDK 5.1.0 - October 31, 2018

Added

  • FBAdOptionsView for Native ads which provides greater flexibility
  • New Interstitial design for Mobile App Install ads
  • Added Playable Ad format in Interstitial 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.

Fixed

  • Refactored and updated Dynamic Framework

Audience Network iOS SDK 5.0.2 - October 25, 2018

Fixed

  • Resizing of FBAdIconView
  • Preventing re-scheduling of viewability validator after impression
  • Reduce the size of FBAudienceNetwork.framework

Audience Network iOS SDK 5.0.1 - October 5, 2018

Fixed

  • Fixed the UI freeze issue
  • Fixed some crashes
  • Better user experience in watch and install page
  • Allow long text in native ad reporting options cell

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