Test Mode

Use the test mode feature to verify that you successfully integrated particular ad networks from among those that MAX mediates.

To enable test mode, define a test device and select a network in the Test Mode section of your MAX account. After you enable test mode for a device, when that device makes an ad request to the network it does so with the network’s test mode enabled. The device also receives detailed device logs.

Note

When you enable test mode, the MAX SDK outputs verbose device logging to iOS Console.

When you turn off Test Mode on your device, your ad units revert to using the configuration listed in the MAX Ad Units page. In addition to using Test Mode in the dashboard, AppLovin recommends that you use Mediation Debugger Test Ads on your devices. This is a quick way to test integration.

Enable Test Mode

To enable Test Mode, select MAX > Mediation > Manage > Test Mode and click + Add Test Device.

Type the device Name and the “Identifier for Advertisers” (IDFA).

Choose the Test Network you would like to see ads from. Then click ✔ Save. When the save completes, all MAX apps associated with your account start receiving test ads from the network you selected.

Disable Test Mode

To disable test mode on your device:

1. Select MAX > Mediation > Manage > Test Mode.
2. Find your device in the list of MAX Test Devices. In the row associated with that device, hover over the green dot in the Status column.
3. A pause icon (⏸️) button appears next to the dot. Click that button.
4. The Pause Test Device dialog appears. Click ✔ Yes.

This disables test mode on your device. Your device now receives ads based on the ad unit configuration that is listed in your MAX Ad Units page.

How to Enable Test Ads in the AppLovin SDK

You can enable test ads for one or more IDFAs programmatically with the AppLovin SDK.

Note

With test ads, AppLovin will not track enabled impressions, clicks, and revenue. Only use such ads to test your app integration.

To enable test ads for a set of IDFAs, pass a list of test device advertising IDs in AppLovin SDK settings. Starting in SDK version 11.11.0, you must set test IDFAs when you create the first SDK instance. The following code snippets demonstrate how to do this:

New SDK (12.3.1+) Methods:

Objective-C

ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: @"«SDK-key»" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
  builder.mediationProvider = ALMediationProviderMAX;
  builder.testDeviceAdvertisingIdentifiers = @[@"«your-IDFA»"];
}];

Swift

let initConfig = ALSdkInitializationConfiguration(sdkKey: «SDK-key») { builder in
  builder.mediationProvider = ALMediationProviderMAX
  builder.testDeviceAdvertisingIdentifiers = ["«your-IDFA»"]
}

Old SDK (pre-12.3.1) Methods:

Objective-C

ALSdkSettings *settings = [[ALSdkSettings alloc] init];
settings.testDeviceAdvertisingIdentifiers = @[@"«your-IDFA»"];
ALSdk *sdk = [ALSdk sharedWithSettings:settings];

Swift

let settings = ALSdkSettings()
settings.testDeviceAdvertisingIdentifiers = ["«your-IDFA»"]
let sdk = ALSdk.shared(with: settings)

Troubleshooting

If you cannot get test ads after you follow these steps, you might have an integration issue. Follow the steps in “Why am I not seeing any ads?”.