Override-enable test mode

To test your Audience Network implementation, you can override all set-ups by sending test mode as true. This option allows you to test ads on your physical and simulator devices before releasing your app to the public. This approach allows you to test any type of ad. To see a test ad, you must send both the bid request and ad request with test mode as true.

To enable the test override, ensure that both bid and ad requests are sent in test mode. This overrides all other signals and shows a test ad. Test mode is available on real devices and simulators:

Note that using a test payload alone is not sufficient.

When integrating through mediation partners, use the partner’s testing methods and enable test mode. Here are examples of a few partner testing tools:

For direct bidding integrations not done through a mediation platform, send the test mode setting in the bid request: test=1, where 0 = live mode and 1 = test mode.

For the test ad to be shown, test mode must be sent in both the bid request and the ad request. Any inconsistencies between the calls result in a no-fill. The SDK changes apply to all integration types, whether direct or through mediation partners.

If you are integrating with a mediation partner on Android, the AN SDK is downloaded as part of the adapter package. Import the following class:

import com.facebook.ads.AdSettings;

After importing the class, use one of the following methods from the SDK before loading the ad.

Enable test mode globally:

AdSettings.setTestMode(true);

After you have finished testing, disable test mode and clear the test device setting:

AdSettings.setTestMode(false);
AdSettings.clearTestDevices();

If you are integrating with a mediation partner on iOS, the AN SDK is downloaded as part of the adapter package. Import the following class:

#import <FBAudienceNetwork/FBAdSettings.h>

Use the following method from the SDK before loading the ad:

[FBAdSettings addTestDevice:[FBAdSettings testDeviceHash]];

For more information on setting test devices, see Test your implementation on a test device.

After you have finished testing, clear the test device setting:

[FBAdSettings clearTestDevice:[FBAdSettings testDeviceHash]];

Note that test requests will not trigger real impressions in Monetization Manager.