Ads for iOS

by Jon (Updated on 2014-01-29)


  • Introduction
  • Showing / Hiding Ads
  • Ad Events
  • Controlling the Position
  • Tips
  • Alternative Networks



Games on the App Store can make money by displaying ads. For the iOS platform, your best bet for making money is to display iAds, Apple’s own ad network.

Tip: In practice, ads perform best for games which are frequently downloaded and have replay value. Although this can vary widely, it often takes 1,000 ad impressions (views) to generate $1 USD.

If you're out to maximize revenue, consider a sponsorship instead.


Showing / Hiding Ads

To display an ad, you must tell the ad to show. This is done using the show/hide ad block under Game > Mobile.


Note: Bear in mind that an ad will not immediately show. See the Tips section below to learn why.


Ad Events

Stencyl provides events for ads. Specifically...

  • An ad is viewed (clicked on)
  • An ad is closed
  • The ad area loads
  • The ad area fails to load

These events can be found under the Mobile > Ads item under the Add Event dropdown.


Tip: We recommend pausing the game when an ad is clicked on and resuming it when the ad is dismissed, otherwise the game will continue to run while the ad is overlayed over everything else.


Controlling Ad Position

Ad Position is set in Game Settings > Mobile > Monetization using the Ad Position dropdown. You can choose between Top or Bottom positioning.




Why doesn't the ad show?

During testing, iAds can randomly fail to show. This is because Apple deliberately causes them to fail (randomly), so that you can test how your app performs in these scenarios.

Even in cases where an ad displays, it may take 30 seconds, a minute or even longer for the ad to display if the ad inventory is empty at the time.


Avoid covering up the screen

When iAds are displayed, they will cover up a small part of the screen. You should avoid displaying crucial game elements under an ad, such as HUD elements. The height of mobile ad block (under Game > Mobile) provides the height, so you can lay your game out accordingly.


Alternate Networks

Officially, Stencyl only supports iAds. However, through free, user-created extensions, other ad networks are supported. These include:

As these extensions see further adoption and development, we may consider integrating them as core features in the future.

Disclaimer: All articles are geared towards Stencyl 3.0 and above. Use comments to provide feedback and point out issues with the article (typo, wrong info, etc.). If you're seeking help for your game, please ask a question on the forums. Thanks!


Updated once more for 3.0 to account for the recent changes and support for alternative networks.
0 1 year, 8 months ago
I've revised this article for Stencyl 3.0.
1 2 years, 5 months ago
And maybe support for full page interstitial ads between scenes?
It would be handy alternative for when you don't want to give up the real estate in landscape mode for a banner ad.

2 3 years, 5 months ago

Sign In to Comment