Creative Debugger

You can examine comprehensive information about problematic ads that appear in MAX-mediated apps. To do this, incorporate the creative debugger into your test environments, QA processes, and support ticket systems.

The creative debugger displays a button in the application for five seconds after you complete a special gesture. (This gesture is described in the video below.) If you then press the button that appears, a screen appears that displays a list of recently displayed ads. If you select an ad from this list, information displays about that ad (such as its mediated network and its creative ID). This gives you the information you need to report creative issues for that ad.

Note

This gesture is available for all ads in SDK 11.6.0 or later. In SDK versions before 11.6.0, the gesture is available for full-screen ads only. It is enabled by default for both development and production builds in all SDK versions.

To report issues with ads and to get help from the associated ad network, select the problematic ad and click the Report button. This creates an ad issue report. Send this report to the appropriate ad network partner. If the issue concerns AppLovin ads, send the report to your account manager or submit a ticket to AppLovin Support.

Disabling the Creative Debugger

The following code shows you how to disable the creative debugger with the MAX SDK:

Objective-C

[ALSdk shared].settings.creativeDebuggerEnabled = NO;

Swift

ALSdk.shared().settings.isCreativeDebuggerEnabled = false

Using the Creative Debugger Display API

In SDK versions 11.6.0 and above, you can display the Creative Debugger by making the following call:

Objective-C

[[ALSdk shared] showCreativeDebugger];

Swift

ALSdk.shared().showCreativeDebugger()

Creative ID

You can also retrieve the creative ID of displayed ads of various mediated networks. You can do this either by using the creative debugger, or by using the MAX SDK. The following code shows you how to do this with the MAX SDK:

Objective-C

NSString *creativeIdentifier = ad.creativeIdentifier;

Swift

let creativeIdentifier = ad.creativeIdentifier

The table below indicates which ad networks, ad formats, and adapter versions support this feature. The Ad Callback column shows you in which ad callback the creative ID becomes available.

Ad Network	Ad Formats	Ad Callback	Android Adapter Version	iOS Adapter Version
AppLovin	Interstitial, Rewarded	Ad Loaded	9.15.0	6.15.0
Amazon	Banner, Interstitial, MREC, Rewarded	Ad Loaded	9.6.2.1	4.5.6.1
BidMachine	Banner, Interstitial, MREC, Native, Rewarded	Ad Loaded	1.9.4.2	1.9.4.1.2
Chartboost	Interstitial, Rewarded	N/A	N/A	8.4.0.1
DT Exchange	Banner, Interstitial, Rewarded	Ad Displayed	7.7.4.1	7.8.0.1
Google Ad Manager	Banner, Interstitial, Rewarded	Ad Loaded	19.6.0.2	7.69.0.1
Google Bidding and Google AdMob	Banner, Interstitial, Rewarded	Ad Loaded	19.6.0.2	7.69.0.1
InMobi	Banner, Interstitial, Rewarded	Ad Loaded	9.1.1.3	9.1.1.1
Liftoff Monetize	Banner, Interstitial, MREC, Native, Rewarded	Ad Displayed	6.10.1.0	6.8.1.3
Liftoff Monetize	Banner, Interstitial, MREC, Native, Rewarded	Ad Loaded	7.1.0.0	7.2.0.0
Meta Audience Network	Banner, Interstitial, Rewarded	Ad Loaded	All	All
Mintegral	Banner, Interstitial, Rewarded	Ad Loaded	15.4.31.1	6.7.5.0.1
Pangle	Banner, Interstitial, Rewarded	Ad Loaded	All	All
Smaato	Banner, Interstitial,1 MREC,1 Native,1 Rewarded1	Ad Loaded	21.5.7.1	21.6.10.1
YSO Network	Banner, Interstitial, Rewarded	Ad Loaded	All	All

¹ Interstitial, MREC, Native, and Rewarded bidding ads are officially supported, on Android only, starting from version 22.5.0.0 of Smaato’s Android adapter.

Network Name

You can also retrieve the name of the ad network that is responsible for an ad. The following code shows you how to do this with the MAX SDK:

Objective-C

- (void)didLoadAd:(MAAd *)ad
{
  NSString *networkName = ad.networkName;
}

- (void)didFailToDisplayAd:(MAAd *)ad withError:(MAError *)error
{
  NSString *networkName = ad.networkName;
}

Swift

func didLoad(_ ad: MAAd)
{
  let networkName = ad.networkName
}

func didFail(toDisplay ad: MAAd, withError error: MAError)
{
  let networkName = ad.networkName
}