Facebook Audience Network

 
 
 

Getting Started with the Facebook Audience Network

Facebook's Audience Network allows you to monetize your iOS and Android apps with targeted ads. This guides walks you through steps to get started on Audience Network.

Getting Started Steps

Step 1: Configure your app on Facebook

Step 2: Configure Ad Spaces and Placements

Step 3: Show Audience Network ads in your app

Step 4: Submit your app for review

Step 5: Tell us how to pay you


Prerequisites

  • You need to be logged in with your Facebook account while performing these steps. Make sure you log in with your real Facebook account and don't use a fake account or a duplicate account that you create for work purposes. Such accounts will be flagged by our integrity systems and disabled.
  • You need to have an iOS or Android app that you want to monetize with Audience Network.
  • The steps to show ads in your app require knowledge of the relevant platform and programming language. For example, Objective C or Swift for iOS, Java for Android and HTML/Javascript for mobile websites.
  • To go live with Audience Network in your mobile app, iOS apps must be available on the Apple App store and Android apps must be available on the Google Play store. You can integrate Audience Network and test the integration before your apps are available on those stores.

Step 1: Configure Your App on Facebook

You must be logged into Facebook to start.

Configure your app for Audience Network by clicking the button below and following on screen instructions. The dialog will create a new Facebook app with Audience Network enabled, or enable it on an existing app. It will then take you to the Audience Network section of the app dashboard to continue the configuration process.

Configure Facebook App

At the end of this step you should have a Facebook app that's enabled for Audience Network.

Step 2: Configure Ad Spaces and Placements

Ad Spaces allow you to organize your placements so they accurately reflect what a user is doing when they see your ads. By arranging your placements into Ad Spaces, you can build a better idea of how your app is performing based on the behavior of your users, not just the display format of your ads. The previous step should have left you with a Facebook app that has Audience Network enabled. This step will guide you through creating and configuring an Ad Space and placements under the same Ad Space. You can also create multiple new Ad Spaces at this time if your app or mobile website has multiple ad experiences.

There are a maximum of 4 Ad Spaces allowed per platform and Ad Spaces can't be deleted, only edited.


  1. Navigate to your app's Audience Network settings by going to https://developers.facebook.com/apps/<your_app_id>/audience-network/. If you don't know your app id, you can go to your Facebook apps, click on the app that you enabled for Audience Network and click on the Audience Network tab under Products on the left.
  2. In the Ad Spaces section, click Create Ad Space
  3. Change the Name to something easy to recognize.
  4. Choose the Platform that this Ad Space will serve traffic to. Ad Spaces will only serve traffic to the selected platform and all requests coming from other platforms will not be filled.
  5. [Optional] Upload a video that shows the ad experience in your app.
  6. Describe what actions the user would take in order to trigger ads in this Ad Space. Please be as explicit as you can, as all Ad Spaces on Audience Network will be reviewed and your ad space can be paused if the ad experience does not match with the information provided.
  7. Click Create to create your Ad Space.
  8. You will be prompted to create your placements if the Ad Space creation is successful.
  9. Name your placement.
  10. Describe how to trigger this specific ad placement under the Ad Space.
  11. Select Display Format. Audience Network supports three ad formats: Native, Interstitial (available for mobile apps only) and Banner. For more information, see Ad Design.
  12. The bottom slider allows you to optimize ad pricing for this placement. In most cases Optimize for Fill will yield the highest revenue. Selecting Optimize for CPM will give higher price per impression but will reduce the fill rate. This may be the right setting if you are using mediation with multiple demand sources and are less concerned about unfilled requests.
  13. Click Save to save the placement configuration.

Insights and performance data are broken down by placement, so you should create a separate placement for each ad location in your app. Also, be sure to give those placements easily recognizable names, e.g. iOS_home_screen, android_settings_screen, mweb_home_page, etc. This will give you better insights and performance calibration and allow you to easily distinguish the placements.

You should now have a Facebook app configured with Audience Network and at least one Ad Space and placement. You should also have configured the placement with the ad display format and price optimization you need, and have given it a recognizable name. The next step is showing ads in your app or on your mobile website by integrating the Audience Network SDK.

For Facebook to validate the ad requests sent by your app, please make sure to integrate with the latest version of our SDK.

Step 3: Show Audience Network Ads

You are now ready to integrate the Audience Network SDK into your app or mobile website and begin showing ads. Follow the implementation guide for your platform.

At the end of this step, you should have Audience Network ads showing in at least one placement within your app or mobile website.

For Facebook to validate the ad requests sent by your app, please make sure to integrate with the latest version of our SDK.

In order to submit your app for Audience Network review, please make sure to test the integration using real ads on a real device while logged in as your app's admin, developer or tester. Test ads are not sufficient to allow you to submit your app for review. For more information please refer to the testing guide.

If you are integrating Audience Network with a mediation layer during testing, please put Audience Network at the top of the waterfall to make sure that the mediation partner fires requests to Audience Network.

Testing requests with Audience Network Requests Debugger

After implementing the placements in your app, you can use the Audience Network Requests Debugger tool to verify that Facebook is receiving the requests from your app.

In the audience network section of the developer dashboard: https://developers.facebook.com/apps/<your_app_id>/audience-network/

Go to the "apps" section in the left panel under "Audience Network" and scroll down to see "Audience Network Requests Debugger". Click on Start button and the tool will start to monitor the requests from your app by yourself.

On you actual iOS or Android test device, iOS or Android, navigate in your app to trigger audience network ad placements, and the ad requests will show up in the tool. Please verify that the requests are sent with the right placement id, bundle package name etc.

This requires a physical device and will not work on the iOS simulator or Android emulator

You need to be logged in to the Facebook app on the same test device that you use in order to be monitored by the tool.

If the ad requests doesn't show up in the tool, it means that Facebook is not receiving the requests as expected. You can check the following items to debug:

  1. Ensure you are on a physical device not simulator/emulator
  2. Ensure the Facebook app is installed on your test device
  3. Ensure you are logged in to Facebook on your test device with a user who is admin, developer or tester on your Facebook Audience Network app
  4. If using mediation, ensure the mediation layer is sending requests to Facebook Audience Network

Step 4: Submit For Review

By now you have a working and tested integration of Audience Network in your app. Your app is live on the iOS App store and/or the Google Play store. You're now ready to submit your app for review. Once your app is approved, it will automatically start showing real ads.

Submit Your App for Review

A few things to keep in mind about the submitting apps for review:

  • You can have only one iOS app and one Android app per Facebook app id that are Under Review or Approved.
  • You can add your iOS or Android app to a Facebook app id by integrating Audience Network SDK in the app and requesting a real ad (non-test mode ads) for a user who is Facebook app developer, admin or tester. Alternatively, you can add your app to a Facebook app id by clicking the Add App button.
  • You can have only one iOS app and one Android app per Facebook app id that are Approved or being reviewed. If you have multiple iOS and/or Android apps you will need to create multiple Facebook apps.
  • You can submit your app for review by clicking the Submit For Review Button. The button is enabled when three conditions are all met:
    1. The iOS or Android app must be added to a Facebook app.
    2. The iOS or Android app must use the Audience Network SDK to request an ad. The user requesting the ad must be an admin, developer or tester of the Facebook app.
    3. For us to register your first request, please use real devices as opposed to emulators/simulators and ensure an admin, developer, or tester of the app is logged into Facebook on that device.

    4. The iOS or Android app must be live on the App Store or Play Store respectively.

Follow these steps to submit your mobile app for review:

  1. Navigate to your app's Audience Network settings by going to https://developers.facebook.com/apps/<your_app_id>/audience-network/. If you don't know your app id, you can go to your Facebook apps, click on the app that you enabled for Audience Network and click on the Audience Network tab under Products on the left. Click on the Apps and Websites section.
  2. Your app should already be listed in the Manage Apps box if you have followed previous steps, integrated the Audience Network SDK and sent some ad requests. If you see your app listed, skip to step 6 below. If you do not see your app listed, click Add App.
  3. Enter the URL to your app on the iTunes App store or Google Play store. You should see your app in the drop down list. If your app isn't showing, check the URL to make sure it points to the right app on one of the two supported app stores.
  4. Once you enter your app URL and submit it, it'll show up in the list of Your Apps with a status of Not Started.
  5. Each bundle/package that you add using the Add App button is in Not Started status until we receive an ad request from that bundle/package. The request must come from Facebook app developers, admins or testers.
  6. Once your app is live on the App Store or Play Store and is added to the Facebook app, you can click on Send For Review to submit it to Facebook for review. At that point the status will change to Your app is being reviewed. Once the review is completed, the status will change to reflect the review outcome. Learn more about adding apps and websites to our review process.

Step 5: Provide Payout Information

To start making money on Audience Network, you'll need to fill out your company and bank information in the Payout tab. Note that if this isn't your first app using Audience Network then you will need to select it from the list of companies you admin and add it to this app. If you do not see your existing company in the list of available companies, it's probably because you're not a company admin. You can resolve this by getting a user who is both a company admin and an app admin to add the company to the app.

We will stop showing ads in your app if your account balance hits $100 USD without submitting this information. Once you provide payout information, we will resume ads in your app or mobile website. Learn more in the Getting Paid FAQ here.

  1. Go to your Facebook app settings and click on Payout.
  2. Enter your company information then click Continue to follow the flow and enter all necessary information.
  3. Once we receive all necessary information and your app reaches at least $100 of ad revenue, it becomes eligible to receive payment. See the Payment FAQ for more information about payment setup and schedule.