Meta Audience Network

Audience Network SDK for iOS Change Log

Changelog and release notes for the Audience Network SDK for iOS.

Audience Network iOS SDK 6.15.0 - March 15, 2024

  • Added privacy manifest file with declaration for collected data types and required reasons APIs
  • Minimum supported iOS version is now iOS 12
  • Minor bug fixes and performance improvements

Audience Network iOS SDK 6.14.0 - August 3, 2023

  • Fix crashing due to memory issues when there has too many views loaded
  • Remove bitcode from SDK

Audience Network iOS SDK 6.12.0 - October 3, 2022

  • Fixed a crash in SKStoreProductViewController on iOS 15.7

Audience Network iOS SDK 6.11.2 - July 13, 2022

  • Fixed a bug on iOS 15.6 (beta) where second tap on mobile app install ad CTA causes the host app to freeze

Audience Network iOS SDK 6.11.1 - May 24, 2022

  • Fixed a bug on iOS 15.5 where second tap on mobile app install ad CTA causes the host app to freeze
  • Performance improvements

Audience Network iOS SDK 6.11.0 - May 11, 2022

  • Performance improvements
  • Reverted default distribution method for Audience Network SDK as a static framework via CocoaPods. To embed dynamic framework, use manual installation.
  • Deprecated -loadAd in favour of -loadAdWithBidPayload: methods. For more details on Audience Network becoming bidding only refer to our Audience Network blog post

Audience Network iOS SDK 6.10.0 - April 12, 2022

  • Performance improvements
  • Audience Network SDK is now distributed as a dynamic framework via CocoaPods.

Audience Network iOS SDK 6.9.0 - November 8, 2021

  • Performance improvements
  • FBSDKCoreKit_Basics is no longer required as a dependency.
  • Xcode 13 is required to build apps that integrate this version of Audience Network SDK.

Audience Network iOS SDK 6.8.0 - October 11, 2021

  • Performance improvements

Audience Network iOS SDK 6.7.0 - September 13, 2021

  • Performance improvements

Audience Network iOS SDK 6.6.0 - August 24, 2021

  • SDK is now packaged as XCFramework
  • arm64 simulator slice to allow testing on Apple Silicon Mac platforms

Audience Network iOS SDK 6.5.1 - June 23, 2021

  • Disabled link time optimization
  • Updated FBAudienceNetwork pod to depend on a standalone FBSDKCoreKit_Basic pod to work with FBSDK 11.0+. This version will not work with older versions of FBSDK through CocoaPods. See more on GitHub.

Audience Network iOS SDK 6.5.0 - May 17, 2021

  • Performance improvements

Audience Network iOS SDK 6.4.1 - April 21, 2021

  • Storage optimisation and performance improvements
  • FBSDKCoreKit_Basics dependency version: >= 7.0.1. We advise you adopt the latest release for best performance and stability. Download FBSDKCoreKit_Basics from GitHub

Audience Network iOS SDK 6.3.1 - March 23, 2021

Xcode 12 required to use Audience Network SDK 6.3.1

Xcode 12 or higher is required to use this version of Audience Network SDK when building your application.

Fixed:

  • Prevented navigation bar from overlaying ads.
  • Minor layout fix for playable ads..

Audience Network iOS SDK 6.3.0 - February 22, 2021

Xcode 12 required to use Audience Network SDK 6.3.0

Xcode 12 or higher is required to use this version of Audience Network SDK when building your application.

Fixed:

  • A crash caused by subclassing SKStoreProductViewController on iOS 13.0.
  • Audio did not stop after a playable ad was dismissed.
  • Video paused with no play button available to resume.

Audience Network iOS SDK 6.2.1 - January 11, 2021

In order to monetize on iOS 14 once Apple introduces its new requirements, you will need to use Audience Network SDK 6.2.1+. Please note that this is a change from our previously communicated guidance to use SDK 6.0 or higher.

Within the latest version, there are two important requirements to highlight:

  • Implement the ‘setAdvertiserTrackingEnabled’ flag, irrespective of the use of mediation, to inform us whether to use the data to deliver personalized ads.
  • Add the suggested SKAdNetwork IDs to the Xcode project’s Info.plist in order for advertisers to measure the success of ad campaigns.
  • Build with Xcode 12+ (iOS SDK 14+).

Audience Network iOS SDK 6.2.0 - October 26, 2020

Notice: Audience Network iOS SDK 6.2 is the next version after 6.0 and includes 6.1 changes. We skipped the 6.1 label in order to keep version parity with Android releases.

FBSDKCoreKit_Basics dependency version: >= 7.0.1. We advise you adopt the latest release for best performance and stability. Download FBSDKCoreKit_Basics from GitHub.

This version of Audience Network SDK has been built with Xcode 11.6.

SKAdNetwork: Audience Network iOS SDK 6.2.1 and above are compatible with Apple’s SKAdNetwork. See more on Meta for Developers.

Change: Watch & Browse

Watch and browse on iOS with improvements from Android learnings.

Change: Adaptive Layout

Another attempt to re-run the alternative adaptive design with minor improvements.

Audience Network iOS SDK 6.0.0 - September 28, 2020

FBSDKCoreKit_Basics dependency version: >= 7.0.1. We advise you adopt the latest release for best performance and stability. Download FBSDKCoreKit_Basics from GitHub.

This version of Audience Network SDK has been built with Xcode 11.6.

Change: New API, setAdvertiserTrackingEnabled

See more on Meta for Developers.

Change: SKAdNetwork support

All publishers will need to use Audience Network iOS SDK 6.2.1+ in order to monetize with iOS 14 users when Apple introduces their new requirements

Fixed:

  • Cases where interstitial and rewarded video ads were sometimes rendered in an incorrect orientation.

Audience Network iOS SDK 5.10.1 - July 20, 2020

FBSDKCoreKit_Basics dependency version: >= 5.6.0. We advise you adopt the latest release for best performance and stability. Download FBSDKCoreKit_Basics from GitHub.

Fixed:

  • A crash happening in previous release (5.10.0) in cases where FBSDKCoreKit_Basics dependency version in use is 7.0.0 or older.

Audience Network iOS SDK 5.10.0 - July 6, 2020

There's an issue affecting Audience Network SDK 5.10.0 for iOS, which results in the app crashing. We're working on a fix that'll likely be in place by July 21, or you can update to FBSDKCoreKit version 7.0.1 or above to avoid the issue.

Change: Data processing options

We've released a Limited Data Use feature to give businesses more control over how their data is used in our systems and better support them with their California Consumer Privacy Act (CCPA) compliance efforts.

Audience Network iOS SDK 5.9.0 - May 11, 2020

FBSDKCoreKit_Basics dependency version: >= 5.6.0. We advise you adopt the latest release for best performance and stability. Download FBSDKCoreKit_Basics from GitHub.

Change: Performance improvements

  • Ad load times reduced
  • Network bandwidth usage reduced

Fixed:

  • A rare ad presentation failure for full-screen formats

Audience Network iOS SDK 5.8.0 - March 30, 2020

FBSDKCoreKit_Basics dependency version: >= 5.6.0. We advise you adopt the latest release for best performance and stability. Download FBSDKCoreKit_Basics from GitHub.

Change: mediaViewRenderingMethod removed

Removed deprecated media rendering method from public API. Remove usage of mediaViewRenderingMethod to ensure that your Audience Network integration continues to work.

Fixed:

  • Server-side reward callbacks are now triggered as expected.

Audience Network iOS SDK 5.7.1 - February 20, 2020

Fixed:

  • Resolved crashes on iOS9 devices when attempting to request an ad.

Audience Network iOS SDK 5.7.0 - February 17, 2020

Change: Xcode 11

Our SDK will no longer successfully link with projects which have bitcode enabled, that are built with Xcode10.

Change: Rewarded Video Improvements

Rewarded video design improvements.

Change: Interstitial Improvements

Interstitial design improvements.

Audience Network iOS SDK 5.6.1 - January 28, 2020

Fixed:

  • Duplicate symbols when including minizip.
  • Linker warning about duplicate category implementation.
  • Rendering issues with playable ads.
  • Playable ads now load correctly for all creatives.
  • Playable ads now close correctly on widescreen devices.
  • Resolved crash when attempting to cache ad assets.

Audience Network iOS SDK 5.6.0 - October 28, 2019

Change: UIWebView Removed

We have removed all references to UIWebView which has been deprecated by Apple.

Change: Image Interstitial Improvements

Updated designs for image interstitials.

Change: Endcard Improvements for Interstitials

Updated designs for link-click interstitial end cards.

Change: Networking And Caching Improvements

Changes to networking and caching logic to improve their performance.

Change: Mixed Audience Flag

We have changed the flag for the label for Mixed Audiences, from isChildDirected to MixedAudience. More information on Mixed Audiences and COPPA can be found here:

https://developers.facebook.com/docs/audience-network/coppa

Bug fixes and changes

  • Fixed: Interstitial video now plays when user navigates to next video carousel card from previous image card.
  • Fixed: Interstitial now appears correctly when device is rotated after ad is loaded.
  • Changed: FBSDKCoreKit_Basics dependency bumped to version 5.6.0 or greater.

Known Issues

ld: warning: instance method 'adnw_URLEncodedString' in category from ... conflicts with same method from another category

There is a conflicting instance method 'adnw_URLEncodedString' that is present in two different categories. There will not be any side effects as the implementation of this method is identical in both places. There is a warning indicating this issue when building in Xcode, it is safe to ignore it.

Audience Network iOS SDK 5.5.1 - September 25, 2019

New: iOS13 support

  • Official release for iOS 13 support
  • Removed usage of UIWebView

Audience Network iOS SDK 5.5.0 - August 19, 2019

New: Added support for size classes

Size classes are now supported by AN iOS SDK.

New: Added dependency to zlib

Interstitial and Rewarded Video formats now require Apple's zlib encoder.

Bug fixes and changes

  • Changed: Updates to interstitial ad reporting flow.
  • Fixed: Original setIdleTimerDisabled flag setting respected after video playback.
  • Fixed: Playable ads in interstitials now respect change in device orientation.
  • Changed: FBSDKCoreKit_Basics dependency bumped to version 5.2.1 or greater.

Audience Network iOS SDK 5.4.0 - June 17, 2019

  • UIImageView now interchangeable with FBMediaView for FBNativeBannerAd
  • File cache improvements
  • Added dependency to FBBSDKCoreKit_Basics
  • Removed dependency to CoreLocation.framework

Change: UIImageView with FBNativeBannerAd

Native Banner Ads can now be created with UIImageView. New methods (see below) have been added to allow this. Note that using FBMediaView is still supported.


@interface FBNativeBannerAd

/**
 This is a method to associate a FBNativeBannerAd with the UIView you will use to display the native ads.

 @param view The UIView you created to render all the native ads data elements.
 @param iconImageView The UIImageView you created to render the icon
 @param viewController The UIViewController that will be used to present SKStoreProductViewController
 (iTunes Store product information) or the in-app browser. If nil is passed, the top view controller currently shown
 will be used.


 The whole area of the UIView will be clickable.
 */
- (void)registerViewForInteraction:(UIView *)view
                     iconImageView:(UIImageView *)iconImageView
                    viewController:(nullable UIViewController *)viewController;

/**
 This is a method to associate FBNativeBannerAd with the UIView you will use to display the native ads
 and set clickable areas.

 @param view The UIView you created to render all the native ads data elements.
 @param iconImageView The UIImageView you created to render the icon
 @param viewController The UIViewController that will be used to present SKStoreProductViewController
 (iTunes Store product information). If nil is passed, the top view controller currently shown will be used.
 @param clickableViews An array of UIView you created to render the native ads data element, e.g.
 CallToAction button, Icon image, which you want to specify as clickable.
 */
- (void)registerViewForInteraction:(UIView *)view
                     iconImageView:(UIImageView *)iconImageView
                    viewController:(nullable UIViewController *)viewController
                    clickableViews:(nullable NSArray<UIView *> *)clickableViews;

New: File cache improvements on iOS

Our iOS SDK now uses a new cache for storing downloaded ads. This new cache is more reliable and should reduce the number of caching errors.

New: Added dependency to FBBSDKCoreKit_Basics

As we're adding FBSDKCoreKit/FBSDKCoreKit_Basics as a dependency of the iOS SDK, changes will be needed in project dependencies.

For developers using CocoaPods, no code change will be required. Simply run pod repo update and pod install and the project will be automatically updated to the latest version.

For developers integrating manually, a manual dependency to FBSDKCoreKit.framework has to be added to the project. It can be done by following these steps:

  1. Download both FBSDKCoreKit.framework and its stripped down version (FBSDKCoreKit_Basics.framework) from our GitHub release page.
  2. If a static framework is used, drag and drop the framework to the project.
  3. If a dynamic framework is used, add the framework to “Embedded Binaries” for the project.

If your application is already using FBSDKCoreKit it needs to be upgraded to FB SDK version 5.0.

Bug fixes and changes

  • Fixed: 'Unhandled Exception' error message shown while loading video ads for App Installs for Interstitial ad format.
  • Fixed: Product image mismatch between carousel card image and web page after tapping on CTA of particular carousel card for Interstitial ad format.
  • Fixed: Crash on Video Player on iOS.

Audience Network iOS SDK 5.3.2 - May 16, 2019

Fixed

  • Fixed adDidLoad delegate method called twice per ad load for banner ads.

Other

  • Removed dependency on CoreLocation.framework

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