Mobile IronSource Collection

The Mobile IronSource Collection is a set of Construct 3 plugins that implements IronSource advertisements with complete ad-network mediation for both Android and iOS.


It provides banner, interstitial, rewarded video and offerwall advertisements from different provider platforms, including Google Admob, Unity Ads, Facebook, etc.


It uses dedicated native libraries written exclusively for Construct 3, ensuring optimal performance and quality in providing mobile application advertisements.

PlayFab API v2.png

Introduction

Step 1.png

The Mobile IronSource Collection has a main plugin called Mobile IronSource, this is the plugin that integrates the ironSource advertisement SDK  and manages the ad-network mediation features of various advertisement network SDKs.

The rest of the plugins are adapters to various advertisement networks you might want to add in your project.


  • Adding an ad-network requires you to sign up for an account to their service. You will have to manage each advertisement network separately, including each payout from an advertisement network.

  • Treat each advertisement network as a separate integration, the ad-network mediation just optimizes the integration of all included advertisement network SDKs for efficient and harmonious delivery of advertisements, and most especially to maximize advertisement revenue for you, the publishers.

  • In the Construct 3 editor, all advertisement networks are synced and unified by the main plugin, the Mobile IronSource plugin. Hence, the actions, conditions and expressions are limited in the adapter plugins due to it being already handled by the Mobile IronSource plugin.

  • Some advertisement networks might also require filling up your advertisement network account credentials, in the plugin properties.

  • Some advertisement networks might also require you to set their own customized compliance and regulatory implementations, e.g. Google Admob advertisement's target rating, child and families targeting compliance, GDPR, CCPA and COPPA consent toggles, etc.



Ad-Networks List


  • The Mobile IronSource Collection has complete support for all ad-network mediation available in the IronSource SDK for both Android and iOS.

  • For optimal results, it's important to plan which ad-networks to add into your project, based on your target audience.

  • You may add all ad-networks for ad-network mediation, but you will have to create and set an account for each advertisement network.

  • The plugins automatically update the dependency versions on every build. If you get build issues, contact us immediately so that we can fix it.



The following is the list of ad-networks currently supported by the Mobile IronSource Collection.

  • IronSource - the main addon (Mobile IronSource) has built-in support for the IronSource SDK.

  • Google Admob - the mobile advertising network of Google.

  • Facebook Audience Network - the mobile advertising network of the biggest social network, Facebook. It is a subsidiary company of Meta Platforms, Inc.

  • Unity Ads - the mobile advertising network of Unity, and their famous rewarded video ads.

  • AdColony - is one of the leading mobile advertisement network in the world.

  • Amazon - the mobile advertising network of Amazon.

  • AppLovin - is a mobile marketing platform, founded in California.

  • Chartboost - is a San Francisco-based mobile advertising and monetization platform.

  • Fyber - is a global tech company, developing a next-gen monetization platform for mobile publishers.

  • HyprMX - is an ad network based in New York, bringing brand ads to mobile apps.

  • InMobi - is an Indian global provider of enterprise platforms for marketers.

  • Maio - is a Japan-based mobile ad-network platform.

  • MIntegral - is a mobile advertising platform that simplifies the challenges of cross-regional marketing.

  • Tapjoy - is a mobile ad platform that offers a novel way for users to engage in mobile advertising.

  • Vungle - is a mobile ad start-up in London and the US, specializing in localized video advertising.

  • TikTok - also called Pangle Ads, it is the advertising network of the famous app TikTok.

  • Smaato - is a global real-time advertising platform for mobile publishers and app developers.

  • Snap - also called Snapchat Ads, it is the advertising network of the famous app Snapchat.

  • myTarget - An advertising platform that reaches every user of the Russian-speaking Internet.

  • Tencent - An advertisement platform of a Chinese multinational technology company.

  • SuperAwesome Ads - An advertisement platform for kids digital media ecosystem based in United Kingdom.

  • Yahoo Ads - An advertisement platform of Verizon, a wireless carrier company based in New York, USA.



Mobile IronSource Ads


The Mobile IronSource plugin is the main plugin in the Mobile IronSource Collection.



  • Mobile IronSource - implements native mobile IronSource ads with complete support of ad-network mediation. It provides banner, interstitial, rewarded video and offerwall advertisements.

 

Plugins List

 

Features

There is currently nothing to show, we will add more in the future.

 

How to use?

The Mobile IronSource Collection is a set of Construct 3 plugins that implements IronSource advertisements with complete ad-network mediation for both Android and iOS.


It is easy to add these advertisement features into your mobile application projects, you will only need to follow the steps below.



1. The first step is to add the Mobile IronSource object into the project. The Mobile IronSource object contains all the features to implement IronSource ads and supporting ad-network mediation.



2. The next step is to click the Mobile IronSource object from the project bar. Then, look at the properties bar showing the properties of the object.


3. During development, check the Debug Mode property to allow the application to log information and errors in the console, for mobile debugging. Do not forget to disable debugging when exporting your production release builds. It is harmless and alright to enable for release builds, although it is no longer necessary to keep it on since release builds do not have consoles to log.


4. Retrieve the application key of your IronSource application and input it into the AppKey property.


5. By default, the other properties are already setup to work for both debugging and production release, so no need to modify them. Only change the other properties if you require feature customizations.



6. Add the ad-network mediation plugins you want included with your IronSource advertisement network mediation. These include networks such as Google Admob, Facebook Audience Network, Unity Ads, etc.


7. It is as easy as adding an object into the project and setting up an account of that ad-network service.




8. Some ad-network plugins might also require you to set their own credentials fields.

  • Credentials - these are usually filled in the properties bar of the ad-network plugin. The plugins will not export if these fields are not properly filled, since these are used by the ad-network SDKs to properly integrate and link the advertisement network application.




9. Some ad-network plugins might also require you to set their compliance and regulatory implementations.

  • Compliance and Regulations - some advertisement network plugins have customized compliances and regulations that cannot be unified in the main Mobile IronSource plugin, therefore it must be set from the ad-network adapter's plugin. For example, Google Admob advertisement's target rating, child and families targeting compliance, GDPR, CCPA and COPPA consent toggles, etc.




10. Some ad-network plugins might also have their own customized features.

  • Customized features - some ad-network plugins have customized or unique features, hence it cannot be unified in the main Mobile IronSource plugin. Therefore, it must be set from the ad-network adapter's plugin. For example, Facebook Audience Network's (Meta)'s interstitial cache flag configuration.

 

Guides

The Mobile IronSource Collection uses native mobile implementations and features​, which means projects need to be exported and built before use or debugging.


Native mobile features are calling Java or Kotlin methods on Android, and Objective-C and Swift methods on iOS. Therefore, application projects with native mobile features require exporting to Android or iOS to be able to run properly.



User Guide



The Mobile IronSource is versatile, full packed of tools to fit your needs. There are multiple ways of achieving a proper workflow. But, in this specific tutorial, the basics will be focused.



The Banner section allows the creation, showing, hiding and destroying of banners.

The Debugging section allows the validation of integration on both Android Studio and XCode.

This is available when using the debugging plugin version.

The General section allows the manual initialization and checking if the specific advertisement type has been capped.



The Interstitial section allows the creation, showing, hiding and destroying of interstitial advertisements.

The Offerwall section allows the showing of offerwall advertisements and client-side claiming of offerwall credits.

The Rewarded Video section allows the checking for the function lookup on the availability of rewarded advertisements, and showing rewarded advertisements.

  • Check Video If Available - this is an action to check if there is an available rewarded advertisement.

  • You can also use the Is Video Available condition for every tick checking, in the conditions dialog.

  • Setting the Dynamic User ID, - the dynamic user id is a parameter to verify advertisement reward transactions. To receive this parameter through the server to server callbacks, this must be set before showing rewarded advertisements.

  • In server to server callbacks, you will receive a dynamicUserId parameter in the callback URL with the reward details.

  • This can be changed throughout the session.

  • Get Video Placement Info - this is useful for retrieving each advertisement placement details.

  • Show Rewarded Video - this is an action for showing rewarded video advertisements, if available.



The Settings section allows the configuration of the IronSource SDK and all the SDK of its ad-networks in mediation.

  • Set Mode - this allows you to choose which advertisement types are available for the application session, this is preset from the properties bar.

  • This must be set before initialization, for changes.

  • Set Consent - allows you to collect the user's input consent to use personalized ads. For more information, kindly click to visit the GDPR documentation, IronSource article and for the advertisement mediation networks' article.

  • This must be set before initialization, for manual initialization.

  • Set Compliance - allows you to collect the user's input consent to sell personal tracking data. For more information, kindly click to visit the CCPA documentation.

  • This must be set before initialization, for manual initialization.

  • Set Child Directed - allows you to collect the user's input toggle if the end-user is a child or not. Kindly click for more information regarding COPPA.

  • This must be set before initialization.

  • For Google Play's Design Apps for Families Programs - this must always be enabled, to target advertisements for children and families.

  • Set Device Id Opt-Out - set to prevent access to the AAID for end-users flagged as children, on Android.

  • This must be set before initialization.

  • This is required to be enabled (checked) for applications in Google Play's Designed for Families Programs.

  • For Google Play's Design Apps for Families Programs -make sure to add the Mobile Advert Families Programs plugin, to prevent access to the Android Advertising ID (AAID), which is a compliance requirement.


The Settings : Offerwall section allows the configuration of offerwall advertisement settings.

  • The Set to Receive Offerwall Callbacks - if set checked, the plugin collection will allow triggering of Offerwall Listeners from the client-side application, this is used in claiming of offerwall credits from the application.

  • Set unchecked if the IronSource application is using server-side callbacks in receiving offerwall credits. For more information on server-side callbacks, click here.

The Settings : Offerwall Server section allows the configuration of offerwall advertisement's client to server settings. This is useful for adding server parameters for offerwall advertisements.

For more information, click here for Android and here for iOS.


The Settings : Rewarded Video section allows the configuration of rewarded video advertisement settings.

  • The Set Should Track Network State - if checked, the plugin collection will adjust the availability of the rewarded video ads based on the internet connection state. It is recommended to check this.

  • This default option state is also available from the properties bar.

The Settings : Rewarded Video Server section allows the configuration of rewarded video advertisement's client to server settings. This is useful for adding server parameters for rewarded video advertisements.

  • For more information, kindly click for Android and for iOS​.

The Settings : Segment section allows the configuration of user segments. This is important for tailoring served advertisements to fit specific audiences.

  • For more information, kindly click for Android and here for iOS.



Properties Guide


The properties guide section will walk you through the properties options of the plugins in the Mobile IronSource Collection.



1. The Settings section allows you to customize plugin specific features. One of it is the Debug Mode property, allowing you to log information, warnings and errors during development and testing


2. The IronSource section allows you to configure the advertisement network mediation. This includes the application key and initialization.

  • AppKey - the application key from your IronSource application.

  • Initialization - if Automatic, the options from the properties bar will be final, and IronSource will auto-initialize on startup. If Manual, IronSource will initialize if called using the Initialize action.


3. The Features section allows you to customize which advertisement types will be activated.


4. The Rewarded Video Ads section allows you to customize the rewarded video advertisements.

  • The Track Network State property allows you to adjust if the video advertisement's availability will take into account the network connectivity state.

  • This is recommended to check (enable), most especially for cases of internet connection loss, disconnection or instability.


5. The Banner Ads section allows you to customize the banner advertisements.

  • The Banner Overlap property, if enabled, allows you to overlap the banner advertisement on top of the layout. Or, if disabled, adjust the layout to accommodate the banner advertisement.

  • If enabled (checked), the banner advertisement will be placed on top of the layout, this is the recommended option.

  • Otherwise, if disabled, the layout will be adjusted to accommodate the banner advertisement.

  • Banner overlap is available for both Android and iOS.

  • Disabled banner overlap is only available on Android.

  • If this is causing issues to your company's end, please contact support for us to work on a solution.


6. The Offerwall Ads section allows you to customize offerwall advertisements.

  • The Receive Clientside Callbacks property, if checked, allows the application to receive the credits locally in the application. If unchecked, credits will be sent to a specified server from the IronSource Console​.

  • If you want to implement server-side offerwall callbacks, kindly click for Android or iOS.


Ad-Network Configurations



  • Each ad-network can have their own exclusive configurations. If you plan to use an ad-network specific feature, access the individual addon object.

 

Documentation

The Mobile IronSource Collection is a plugin collection that provides native mobile features for game application projects by integrating native the Android SDKs and iOS SDKs of a plugin's feature in Construct 3.



The Mobile IronSource Collection implements features in the Android SDK, and other 3rd party Software Development Kits (SDKs) developed by services, platforms and library developers.



The Mobile Master Collection implements features in the iOS SDK, and other 3rd party Software Development Kits (SDKs) developed by services, platforms and library developers.



The Mobile IronSource Collection works just like the Mobile Master Collection in this regard. Therefore, if you wish to read a technical introduction to native mobile plugins, please check the Mobile Master Collection to learn additional information, such as native mobile debugging.

 

Showcase

The Mobile IronSource Collection is a set of Construct 3 plugins that implements IronSource advertisements with the ironSource Android SDK and ironSource iOS SDK, with complete ad-network mediation through various advertisement networks with their Android SDKs and iOS SDKs, for both Android and iOS.







Important Notes

1. The UserID is not to be confused with the Dynamic UserID.

  • The user id is used to identify each user for offerwall advertisements, and must be set before initialization in manual mode, or in automatic mode. It is now automatically retrieved, even without the Google Admob plugin.

  • The dynamic user id is used to identify transactions for rewarded video advertisements, this can be set throughout the session. For server to server callbacks, set this before initialization.

2. The Mobile IronSource Collection included all the features in the ironSource Android SDK and ironSource iOS SDK. Therefore, if you need technical details of the features, then please click to visit the documentation for Android and for iOS.

3. The plugins in the Mobile IronSource Collection automatically updates some dependencies on every build, so if there is a technical concern belonging below, please do contact support.

  • C3 Build Service - build failure.

  • New IronSource SDK version.

  • New mediation adapter version.

  • New feature or compliance.

  • New IronSource breaking changes.

  • Android​

  • iOS


4. New IronSource accounts might get an initialization error in its first few hours. Kindly wait for its completion, it usually does not take longer than 24 hours for the IronSource Team to review your account.

 
 

Tutorial  Kit

Instructions Kit

Construct 3 Project
Construct 3 Project

press to zoom
Construct 2 Project
Construct 2 Project

press to zoom
Construct 3 Project
Construct 3 Project

press to zoom
1/2

Specifications

  • Instructions - The game project contains instructions and steps on how to use the addon and its features.

  • Action, Conditions and Expressions - It covers the implementation of each action, condition and expression.

  • Tips and Tricks - It provides some tips and tricks on the recommended ways of using the addon.

Supporters

Only