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.5.0-beta'
}

Manual Download

What's New in 5.5.0-beta

New: Native banner icon caching

Added a new API, withPreloadedIconView, allowing optional pre-caching of icon assets for native ads. A width and height must be specified.

NativeAdBase
    .buildLoadAdConfig() // NativeAdBase.LoadAdConfigBuilder 
    .withBidPayload(String)
    .withCacheFlags(MediaCacheFlags)
    .withPreloadedIconView(int w, int h)
    .loadAd();

New: Cache improvements on Android

Increased cache reliability by reducing number of caching errors.

Change: Interstitial and Rewarded Video optimizations

You will now receive a warning to the console instead of an error message if you:

• Make a secondary loadAd() request to an ad object if there is another request already loading.
• Make a secondary showAd() request to an ad object if there is already an ad on screen.

Bug fixes and changes

• Fixed: Fixes for playable ads.
• Fixed: Speaker button on video interstitials could become unresponsive on device rotation.
• Fixed: Sound could be heard on Rewarded Video end card.
• Fixed: Rewarded Video ads will no longer lock screens on OPPO devices.

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.5.0-beta'
2. Run pod install.

Manual Download

What's New in 5.5.0-beta

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.

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.