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.

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.3.0-beta2'
}

Manual Download

What's New in 5.3.0-beta

Dependency Removal

The Android SDK no longer requires Android support library. Apps can freely upgrade to Android X or to different versions of the support library without affecting their SDK.

GetBidderToken is now faster

BidderTokenProvider.getBidderToken() can now be called often and the bidder token is precomputed at startup so, once the SDK initializes, obtaining the bidder token should be faster than in previous versions, avoiding latency issues.

Reduced SDK Footprint

The Android SDK now has a smaller method footprint. It now has around 800 methods vs over 8000 previously. This is useful mainly for single-dex publishers. The size of the Android SDK has also been reduced.

Reduced Network Usage

The Android SDK now uses less upstream network traffic when communicating with Facebook servers.

Better Security

The SDK is now bundled differently to improve our security measures. We ship a separate asset that is a dex file with more code. Bytecode manipulation of this dex file is not allowed.

New method: getAdFormatForPlacement

Applications can now obtain the ad formats that is associated with each placement IDs after initialization has finished. This data is obtained during initialization, provided there is network connectivity. This allows SDK clients to know what type of ad is configured in Monetization Manager.

The format type can be determined using the following class method in the AudienceNetworkAds class: int getAdFormatForPlacement(Context context, String placementId);

New method: isInitialized

New method (isInitialized) in AudienceNetworkAds that allows applications to test whether the SDK is initialized. This allows publishers to avoid double initialization.

New method: getAdsProcessName

New method (getAdsProcessName) in AudienceNetworkAds that allows applications to check whether the current process is an internal SDK process (same as isInAdsProcess that was introduced in 5.1). For publishers who want more control over their apps' processes, this can be used to filter the process spawned by the ads SDK.

Change to NativeAdViewAttributes

NativeAdViewAttributes constructor now requires a Context object.

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

Manual Download

What's New in 5.3.0-beta

New method: adFormatTypeNameForPlacementId

Applications can now obtain the ad formats that is associated with each placement IDs after initialization has finished. This data is obtained during initialization, provided there is network connectivity. This allows SDK clients to know what type of ad is configured in Monetization Manager.

The format type can be determined using the following class method in the FBAudienceNetwork class: + (FBAdFormatTypeName)adFormatTypeNameForPlacementId:(NSString *)placementId;

Bug fixes and changes

• Fixed bug concerning CFBundleSupportedPlatforms value, that was causing apps to be reject in AppStore review.
• Playable ads are now fetched in a background thread.
• Fixed a memory leak in playable ads.
• New implementation for fetching user agent.

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.