Creative Debugger

  • Updated

With the AppLovin MAX SDK, you can expose comprehensive ad information in MAX-mediated apps. You can identify problematic ads when you incorporate the creative debugger into your test environments, QA processes, and support ticket systems.

The creative debugger displays a button anywhere in the application for five seconds when you complete a special gesture (described in the video below). If you then press the button that appears, you will see a new screen that contains 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 creative ID), and you can report creative issues for that ad. This gesture is available for all ads with SDK 11.6.0 or later.

For 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 any issues with ads and to get help from the associated ad network, select the problematic ad and click the Report button, which creates an ad issue report. Send this report to the appropriate ad network partner. For issues with AppLovin ads, send this 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:

  • [ALSdk shared].settings.creativeDebuggerEnabled = NO;
  • 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:

  • [[ALSdk shared] showCreativeDebugger];
  • 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:

  • NSString *creativeIdentifier = ad.creativeIdentifier;
  • 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 iOS Adapter Version
AppLovin Interstitial, Rewarded Ad Loaded 6.15.0
AdColony Interstitial, Rewarded Ad Loaded All
Amazon Banner, Interstitial, MREC, Rewarded Ad Loaded 4.5.6.1
BidMachine Banner, Interstitial, MREC, Native, Rewarded Ad Loaded 1.9.4.1.2
Chartboost Interstitial, Rewarded N/A 8.4.0.1
DT Exchange Banner, Interstitial, Rewarded Ad Displayed 7.8.0.1
Google Ad Manager Banner, Interstitial, Rewarded Ad Loaded 7.69.0.1
Google bidding and Google AdMob Banner, Interstitial, Rewarded Ad Loaded 7.69.0.1
InMobi Banner, Interstitial, Rewarded Ad Loaded 9.1.1.1
Liftoff Monetize Banner, Interstitial, Rewarded Ad Displayed 6.8.1.3
Meta Audience Network Banner, Interstitial, Rewarded Ad Loaded All
Mintegral Banner, Interstitial, Rewarded Ad Loaded 6.7.5.0.1
Pangle Banner, Interstitial, Rewarded Ad Loaded All
Smaato Banner Ad Loaded 21.6.10.1
Tapjoy Interstitial, Rewarded Ad Loaded All

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:

  • - (void)didLoadAd:(MAAd *)ad
    {
      NSString *networkName = ad.networkName;
    }
    
    - (void)didFailToDisplayAd:(MAAd *)ad withError:(MAError *)error
    {
      NSString *networkName = ad.networkName;
    }
  • func didLoad(_ ad: MAAd)
    {
      let networkName = ad.networkName
    }
    
    func didFail(toDisplay ad: MAAd, withError error: MAError)
    {
      let networkName = ad.networkName
    }