SDK Beta Program

SDK 5.2.0-beta

The Beta is currently closed. See below for information on the Rewards Program.

What's New?

Highlights

  • New native templates - an easier way to add Native Ads to your app.
  • Added option to hide ad reporting icon from AdOptionsView.
  • Added blur background to videos in MediaView (Native Ads).
  • Interstitial design improvements.

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

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 5 million impressions during the one-month Beta period.
  2. Deliver 7.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.2.0-beta2'
}

Manual Download

Package Date

Audience Network SDK 5.2.0-beta

February 05, 2019

What's New in 5.2.0-beta

  • Revamped native templates bringing you an easier way to add Native Ads to your app. These adapt to the size of the ad container.
  • Added option to hide ad reporting icon from AdOptionsView.
  • Added Blur background to videos in MediaView (Native Ads).
  • Initialization method becomes mandatory.
  • Interstitial design improvements.

Native Templates

A new native ads template type that is not dependent on static size. Only to be used for native ads - not native banner ads. Supported size is 200x200 and bigger.

In order to use the new template, you can use the same method just without passing in the template type:

private NativeAd nativeAd;
...
    nativeAd.setAdListener(new AdListener() {
        ...
        @Override
        public void onAdLoaded(Ad ad) {
          // Render the Native Ad Template
          View adView = NativeAdView.render(MainActivity.this, nativeAd);
          LinearLayout nativeAdContainer = (LinearLayout) findViewById(R.id.native_ad_container);
          // Add the Native Ad View to your ad container. 
            // The recommended dimensions for the ad container are:
            // Width: 280dp - 500dp
            // Height: 250dp - 500dp
            // The template, however, will adapt to the supplied dimensions.
          nativeAdContainer.addView(adView, new LayoutParams(MATCH_PARENT, 800));  
        }
    }

This is what the new Templates look like:



Init method

We introduced an initialization method in 5.1.0. This function is now mandatory in SDK 5.2.0 onwards.

In order to ensure the Audience Network SDK functions correctly, we require using the init function, which ensures that ad delivery and measurement will not be impacted. This method needs to be called once, ideally from your Application, or in the onCreate() method in the activity which contains your ads.

public class YourApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        AudienceNetworkAds.initialize(this);
    }
}

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 facebook-admob-adapter.aar to your project.

Using the Beta with MoPub mediation


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

Manual Download

Package Date

Audience Network SDK 5.2.0-beta

January 17, 2019

What's New in 5.2.0-beta

  • Revamped native templates bringing you an easier way to add Native Ads to your app. These adapt to the size of the ad container.
  • Added option to hide ad reporting icon from AdOptionsView.
  • Added Blur background to videos in MediaView (Native Ads).
  • Interstitial design improvements.

Native Templates

A new native ads template type that is not dependent on static size is introduced. Only to be used for native ads - not native banner ads. Supported size is 200x200 and bigger.

In order to use the new template, you can use the same method just without passing in the template type:

- (void)nativeAdDidLoad:(FBNativeAd *)nativeAd
{
    ...

    if (nativeAd && nativeAd.isAdValid) {
        FBNativeAdView *adView = [FBNativeAdView nativeAdViewWithNativeAd:nativeAd];
        adView.frame = self.adContainerView.bounds;
        adView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
        [self.adContainerView addSubview:adView];
        self.adView = adView;
    }
}

This is what the new Templates look like:



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