Checklist - mApp

Business Manager

Ensure you’ve created a Business Manager account. You’ll need this to access Monetization Manager, which is the platform you’ll use to monetize with Audience Network.

When you create a Property, you can access it via the Business Settings in Business Manager, either under the People tab, or under the Data Sources.

If you’ve created a Property but it’s not visible in either Business Manager or Monetization Manager, please contact us.

You can add people to your business and grant them permission to apps and websites in your Business Manager. See our guide to learn how to do this.

You can add people to apps or website in your Business Manager. Once you add a person to this, you can choose the level of permissions to give them. See our guide to find out how to do this.

Business Manager uses a 2-layer permission system that makes sure each person has the access they need. The first level is where you add people to your Business Manager. The second is task-based permissions, where you can grant them access to the Property.

Make sure you’ve given the correct access to the correct people in your business. See our guide for more information.

Finance editors can edit business payment information. You can give them admin access to the Property to allow them to perform any action and view all metrics in Business Manager. Find out how using our guide.

The quickest way to test your integration is to test with a device. This testing lets you see both test ads and production ads. You’ll need to make sure your device is treated as a test device by our ad system and not a normal device. Use our guide to find out how to do this.

When you create a new ad placement within an Ad Space for Audience Network, you can choose to manually set CPM targets. Find out more about price settings.

Integration - bidding

The property can be allow listed for different app bidding integrations: in-house ad servers, integrated ad servers and external ad servers. Once allow listed, app publishers can view both Bidding and Waterfall metrics in its Performance tab of Monetization Manager.

The property makes network calls to AN real-time bidding endpoint through its bidding integration and the received network calls will be reflected as bid requests in its Monetization Manager.

The bid request sent to our real-time bidding endpoint must comply to required format and correct value depends on the bidding integration options. Qualified bid requests will be reflected as bid requests in property’s MoMa dashboard. Non-compliant bid request will be rejected by our bidding endpoint. For detail information, please refer to AN Developer Docs.

Facebook Audience Network is committed to deliver high quality service to app publishers through constantly improved SDKs. It is recommended to use latest SDK for best quality and performance. Older SDKs will be deprecated from using the bidding endpoint. Please check latest SDKs for Android and iOS from Developers Doc site.

The property is represented by its unique app bundle name in AN for monetization. AN is committed to ensure the uniqueness and security of app bundle for complying to best business practices and policies. Please check Manage Property page in MoMa to ensure the bundle status is in ready or requesting ads status.

AN ad placement has to be set for one type of ad display formats in Monetization Manager before the placement can be used and the same type of ad display format has to be used in bid request for match. Please check No Bid Reasons page in MoMa to ensure ad display format mismatch error is eliminated.

AN offers ad opportunities as bid responses to bid requests which meet the AN demand requirements and at the same time the bid responses are reflected in Monetization Manager dashboard.

When receives response with best price, the bid becomes a winning bid. The property will convert the winning bid to real ad request and send it to AN for fulfillment and the ad request will be reflected in Monetization Manager dashboard.

Integration - ad request

The Network Security Configuration feature lets apps customize their network security settings in a safe configuration file without changing app code. Check out our guidance on the Facebook for Developer’s website for more information on how to do this.

When using Audience Network SDK for Android version 5.3.0 and above, the initialize() method must be called before any other SDK operations. Check out our guidance on the Facebook for Developer’s website for more information.

Check our our code samples bundled with the Audience Network SDK release, which demonstrate how to use various ad formats.

When setting up the placement, ensure the ad display formats in ad requests match the ad display format in your code. Otherwise, this will result in no fills.

In Monetization Manager, you can set default payment accounts and link your properties with existing or new payment accounts. Use our guide for more information.

When integrating Audience Network into your app, you should test that your implementation is working with real devices while you're logged into the Facebook app before making it live. Read our guidance to find out how to do this.

See our guide on the Facebook for Developers site on how to validate ad requests from Charles Proxy tool.

You can use this guide to help validate ad request or responses to and from Audience Network in cases such as:

  • Hassles for adding debugging code and investigating mobile device log
  • No clues for missing ad requests or impressions from dashboard

When testing your implementation of Facebook Audience Network, you may experience one of several possible error codes when making a request. Check what they mean using our ad request error guide.

We only show Audience Network ads to people with Facebook profiles. If we’re frequently not bidding on your requests for this reason, it might be because people who are visiting your platform aren't logged into Facebook or don't have tracking enabled.

Integration - impression

Check your code to make sure ShowAd() is called. See step 2 in our guide for how to show rewarded video ads.

Check your code to make sure onLoggingImpression() is called after the ad is displayed.

The Ad Impression logged from notification numbers should never misalign from the Monetization Manager dashboard. However, because many ad servers and mediation platforms count impressions differently to Audience Network, the Monetization Manager dashboard may misalign with the mediation dashboard. Read our guide to learn more.

Reporting API

Use our guide to make sure you’ve created the System User in Business Manager and added to the Property.

Use our guide to generate a System User Access Token.

When generating a System User Access Token, ensure that you selected read_audience_network_insights to be able to read Audience Network insights.

Ensure the reporting API format is verified using the Graph API Explorer.

Check your web browser to ensure the resolved reporting API is verified.