SDK Beta Program

The SDK Beta Program gives Developers a first look at the latest features and advancements from the Facebook Audience Network SDK.

• Android Installation Guide and Updates
• iOS Installation Guide and Updates

The Beta period will last approximately one month before the general availability release of each major SDK. During this period, Developers using the Beta SDK will be eligible to receive various rewards.

Why use the Beta SDK?

• First look at the latest features from the Audience Network
• Rewards program with Facebook Advertising Credits
• Access to closed Developer Community, with the Audience Network Team

The Beta SDK has been through the same testing and quality cycles as any other SDK from Facebook Audience Network.

How to use the Beta SDK?

In order to use the Beta SDK, please sign up for the SDK Beta Program in Monetization Manager.

1. Go to Monetization Manager.
2. Click Monetisation settings > SDK Beta.
3. Agree to the Audience Network Beta SDK Terms
4. Follow the installation guides below to download and install the Beta SDK.

All other instructions can be found in the general Android and iOS developer guides, unless stated below.

Beta Terms

By using the Audience Network Beta SDK, you acknowledge that you have read, understood, and agree to the Audience Network Beta SDK Terms.

Rewards

How to claim rewards in the Beta

Participants in our SDK Beta program can claim Facebook Ads Credits for delivering impressions and submitting bugs.

Impressions rewards

1. Deliver 3 million impressions during the one-month Beta period.
2. Deliver 5 million impressions on any of these formats over the 1-month beta period:
   • iOS Rewarded Video
   • Android Rewarded Video
   • iOS Interstitial
   • Android Interstitial

Bug bounty

Whilst the Beta SDK has been through the same testing and quality cycles as any other Facebook Audience Network SDK, we acknowledge that there may be undetected issues. If you find such an issue, then you may be eligible for the bug bounty reward.

To qualify for a reward, you must submit a verified and validated bug during the 1-month beta period. Please visit the SDK Beta Page in Monetization Manager to submit a bug.

Android

Android installation Guide

See the Getting Started guide for more information on integrating the Audience Network Android SDK.

Maven (Preferred Download Method)

Add this to Module-level /app/build.gradle before dependencies:

repositories {
  // You can also use jcenter if you prefer
  mavenCentral() 
}

Add the compile dependency with the latest version of the Facebook SDK in the build.gradle file:

dependencies { 
    compile 'com.facebook.android:audience-network-sdk:5.4.0-beta'
}

Manual Download

What's New in 5.4.0-beta

Change: ImageView with NativeBannerAd

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

class NativeBannerAd {
    /**
     * Registers the given view as the container and the required ImageView as the Icon display
     * for this NativeBannerAd to handle impressions and clicks.
     * ImageView must be within the view passed as the container for this NativeBannerAd.
     * Applies a click handler to the entire unit.
     * @param view the View containing this NativeBannerAd for display
     * @param iconView ImageView to display Icon for this NativeBannerAd
     *
     * @since 5.4
     */
     public void registerViewForInteraction(View view, ImageView iconView);
     
    /**
     * Registers the given view as the container and the required ImageView as the Icon display
     * for this NativeBannerAd to handle impressions and clicks.
     * ImageView must be within the view passed as the container for this NativeBannerAd.
     * Applies a click handler to the entire unit.
     * @param view the View containing this NativeBannerAd for display
     * @param iconView ImageView to display Icon for this NativeBannerAd
     * @param clickableViews a list of all view elements that should handle taps on this unit
     *
     * @since 5.4
     */
    public void registerViewForInteraction(
        View view,
        ImageView iconView,
        @Nullable final List<View> clickableViews);
}

New: File cache improvements on Android

Our Android 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: Improved SDK security

Improved security of the Android SDK to reduce fraud.

New: Kotlin ad sample app

We now provide an example application that uses Facebook Audience Network SDK in Kotlin.

Change: Exoplayer Dependency Removed

Exoplayer is no longer a dependency of the SDK.

Bug fixes and changes

• Fixed: Incorrect caching in Interstitial ads.
• Fixed: Playable ads are not shown in landscape mode for Interstitial/Rewarded Video ad format.
• Fixed: ANR on UI Thread.
• Fixed: Close icon larger than expected when fullscreen in RecyclerView.
• Change: loadAd no longer performs I/O in the UI thread for NativeBannerAd.

Integration with third-party mediation platforms

Adapters published in Bintray are not built with the Beta SDK. It is discouraged to use them, follow the steps below to integrate the Beta SDK with a mediation platform.

Using the Beta with AdMob mediation

• Follow the Android Installation guide to add the Beta SDK to your project.
• Download adapter file, extract it and add the GoogleMediationAdapter-release.aar to your project.

Using the Beta with MoPub mediation

• Follow the Android Installation guide to add the Beta SDK to your project.
• Download adapter file, extract it and add the MoPubMediationAdapter-release.aar to your project.
• Follow the steps described in MoPub documentation using the code from the previous step.

iOS

iOS installation Guide

See the Getting Started guide for more information on integrating the Audience Network SDK for iOS.

Using Cocoapods

1. Add the following line to your project's Podfile: pod 'FBAudienceNetwork', '~> 5.4.0-beta'
2. Run pod install.

Manual Download

What's New in 5.4.0-beta

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.

Integration with third-party mediation platforms

Adapters published in Cocoapods are not built with the Beta SDK. It is discouraged to use them, follow the steps below to integrate the Beta SDK with a mediation platform.

Using the Beta with AdMob mediation

• Follow the iOS Installation guide to add the Beta SDK to your project.
• Download adapter zip, extract it and add FacebookAdapter.framework to your project.

Using the Beta with MoPub mediation

• Follow the iOS Installation guide to add the Beta SDK to your project.
• Download the Beta adapter code from this repository.
• Integrate the adapter via source code as it is described in MoPub documentation.