Mobile IronSource Ads

The Mobile IronSource Ads implements IronSource advertisements with complete ad-network mediation support, extensible through addon modules.

It supports banner, interstitial, rewarded video and offerwall advertisements. 
It also has complete advertisement management features for both IronSource and its ad mediation networks.

It is using dedicated native libraries for both Android iOS, written from scratch for Construct 3.

 

Intstructions

1. The first step is to add the Mobile IronSource addon into the project.

2. The next step is to go to the Properties Bar while the Mobile IronSource object is selected. 

3. During development, check the Debug Mode property. This allows the app to log errors on the console, for mobile debugging. 
Don't forget to turn it off when exporting for your production build.

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, so no need to modify them.

Only change them if you require feature customization.

7. Add the ad-network mediation addons you want included with IronSource.
Like Admob, Facebook Audience Network, Unity Ads, etc.

8. The Mobile IronSource Collection, just like most addons in the collection, supports the C3 Build Service. It is a one-click build feature of Construct 3.

You can also use other build services like PhoneGap, Android Studio, XCode and the Cordova CLI.

Features

The Mobile IronSource is an addon that integrates the native mobile IronSource SDK into an application made in Construct 3, with support for both android and ios.
It allows you to integrate IronSource advertisement with complete ad-network mediation options.

Features :

  • Full native Android SDK integration.

  • Full native iOS SDK integration.

  • IronSource Advertisement.

  • Complete ad-network mediation support.

  • Easy to use and no programming required.

  • Well-supported and fully tested.

  • Complete IronSource features.

  • Complete ad-network mediation features.

  • Banner, Interstitial Rewarded Video and Offerwall

  • Complete management features.

  • GDPR & CCPA support.

  • Construct 3 editor support.

  • Construct 3 runtime.

  • C3 Build Service & PhoneGap.

  • Android Studio & XCode.

  • Cordova CLI

Easy Ad-Network  Mediation

Add & Play

Admob Ads - Desktop.png
  • To add an ad-network mediation for the Mobile IronSource, simply insert the addon object into the project.

  • Check if there is a required property input by clicking on the object, in this case, the Admob Ads addon.

  • Fill in the blanks, there will be descriptions to guide you.

Ad-Network List

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

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

  • You may add all ad-network mediation, but you will have to setup your account for each network.

  • The addons auto-updates your SDK version on every build. If you get build issues, contact us immediately, so we can fix it.

Mobile IronSource Collection - Focus.png
  • 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 Facebook.

  • 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. (iOS only)

Actions, Conditions & Expressions

Actions

1/4

Debugging :

  • Validate Integration - Show the status list of all integration, from the debugger of Android Studio or XCode.

Settings :

  • Set Mode - Toggle the advertisements to add into the game, run before initialization.

    • Rewarded Video - Toggle to enable or disable rewarded video advertisements.

    • Interstitial - Toggle to enable or disable interstitial advertisements.

    • Offerwall - Toggle to enable or disable offerwall advertisements.

    • Banner - Toggle to enable or disable banner advertisements.

  • Set Consent - Toggle to enable or disable personalized adsvertisements. This is for GDPR compliance.

    • User Has Given Consent - Toggle true or false, depending if the user has given consent.

  • Set Compliance - Set the CCPA Compliance consent, provided by the user.

    • Do Not Sell - If "false", IronSource will restrict the sale of end users personal information under the CCPA.


General :

  • Initialize - Initialize IronSource to enable advertisement features. Applicable if not on "Auto Initialization".

    • App Key - The "AppKey" for the IronSource application. This can be found from the IronSource Dashboard.

    • UserID Mode - If "Automatic", IronSource will use the advertising id as the user's id. If "Manual", you can specify the user id below.

    • UserID - Customized user id for the user.

  • Check Placement If Capped - Checks an advertisement type's placement, if it has exceeded its capacity to show.

    • Placement Name - The placement name of the advertisement.

    • Advertisement - The advertisement type to check the placement from.


Settings : Segment :

  • Set Segment - Send the defined properties of the current user, for this segment, which is sent to the IronSource servers.

    • Name - The name of the segment.

  • Add User Age - Define the age property of the user.

    • Age - The user's age. Starting from 1 to 99. [Integer]

  • Add User Gender - Define the gender property of the user.

    • Gender - Set the user's gender. Either "Male" or "Female".

  • Add User Level - Define the level property of the user.

    • Level - Set the user's level. [Integer]

  • Add User Creation Date - Define the creation-date property of the user.

    • Date - Set the user's creation date. [Long]

  • Add User IAP Total - Define the iap-total property of the user.

    • IAP Total - The total value of the In-App Purchases of the user.

  • Add User IsPaying - Define the isPaying status property of the user.

    • Is Paying - Toggle true, if the user is a paying customer.

  • Add User Custom Property - Define a custom property for the user.

    • Key - The key for the custom user property.

    • Value - The value for the custom user property.


Settings : Rewarded Video Server :

  • Clear Video Properties - Clears all added rewarded video properties.

  • Add Video Property - Add a key-value pair property for the next "Set Video Server Parameters".

    • Key - The rewarded video property key.

    • Value - The rewarded video property value.

  • Set Video Server Parameters - Pushes all rewarded video properties, then set them as the custom rewarded video server parameters.

  • Clear Video Server Parameters - Clear all the set rewarded video server parameters.


Settings : Offerwall Server :

  • Add Offerwall Property - Add a key-value pair property for the next "Set Offerwall Server Parameters".

    • Key - The offerwall property key.

    • Value - The offerwall property value.

  • Clear Offerwall Properties - Clears all added offerwall properties.

  • Set Offerwall Server Params - Pushes all offerwall properties, then set them as the custom offerwall server parameters.


Settings : Rewarded Video :

  • Set Should Track Network State - Sync the rewarded video advertisement availability with the network state.

    • Sync To Network - If true, the availability of the rewarded video advertisements will be synced with the network state.


Rewarded Video :

  • Set Dynamic User ID - Set the identifier for verifying Rewarded Video Advertisement transactions.

    • ID - The custom dynamic user id, to differentiate transactions from the server.

  • Get Video Placement Info - Get the rewarded video placement info.

    • Placement Name - The placement name of the rewarded video advertisement.

  • Show Rewarded Video - Show the rewarded video advertisement by placement name. If empty, it will use the default placement.

    • Placement Name - The placement name of the rewarded video advertisement. If empty, it will use the default placement.

  • Check Video If Available - Checks if a rewarded video advertisement is available to show.


Interstitial :

  • Create Interstitial - Create an interstitial advertisement.

  • Show Interstitial - Show the interstitial advertisement by placement name. If empty, it will use the default placement.

    • Placement Name - The placement name of the interstitial advertisement. If empty, it will use the default placement.

  • Check Interstitial If Ready - Checks if an interstitial advertisement is ready to show.


Banner :

  • Create Banner - Create a banner advertisement by placement name. If empty, it will use the default placement.

    • Placement Name - The placement name of the banner advertisement. If empty, it will use the default placement.

    • Position - The position of the banner, either "Top" or "Bottom".

    • Size - The size of the banner advertisement. Either "Banner", "Large", "Rectangle", "Smart" or "Custom".

    • Custom Width - If the banner size is for "Custom Size", then input here the custom width of the banner.

    • Custom Height - If the banner size is for "Custom Size", then input here the custom height of the banner.

    • Auto Show - If true, it will automatically show the banner advertisement.

  • Show Banner - If a banner is loaded, show the banner using this action.

  • Hide Banner - Hide the banner advertisement.

  • Destroy Banner - Destroy the banner advertisement.


Offerwall :

  • Show Offerwall - Show the offerwall advertisement by placement name. If empty, it will use the default placement.

    • Placement Name - The placement name of the offerwall advertisement. If empty, it will use the default placement.

  • Get Offerwall Credits - Manually call to receive information on the user’s total credits and any new credits the user has earned.


Settings : Offerwall :

  • Set to Receive Offerwall Callbacks - Toggle to receive the callback triggers from the app or not. Set to false if offerwall credits are handled automatically from a server.

    • Receive From App - If true, client-side callbacks will be received. Set to false if receiving from a server.

Conditions

General :

  • Is Initialized - Checks if the IronSource SDK is already initialized.

  • Is Mode Enabled - Checks if an advertisement mode is activated.

    • Mode - The advertisement mode to check if activated.

1/4
  • On Check Placement If Capped - Checks if an advertisement placement has reached its capacity to be shown, as assigned from the IronSource Console. Triggers if a "Check Placement If Capped" action is fired. 

    • Advertisement - The advertisement type to check the placement from.

    • Placement Name - The placement name of the advertisement.

    • State - The cap state of the placement, to determine if the allowed number for showing the advertisement placement has been reached.

 


Rewarded Video :

  • On Video Opened - Triggers if a rewarded video advertisement is opened.

  • On Video Clicked - Triggers if a rewarded video advertisement has been clicked.

  • On Video Show Failed - Triggers if a rewarded video advertisement failed to show.

  • On Video Rewarded - Triggers if a rewarded video advertisement has been completed and the user is rewarded.

  • Is Video Available - Checks if there's a rewarded video advertisement ready to show.

  • On Video Closed - Triggers if a rewarded video advertisement is closed.

  • On Video Availability Changed - Triggers if a rewarded video advertisement's availability changed.

    • Is Available - The current availability status toggle.

  • On Video Started - Triggers if a rewarded video advertisement has started.

  • On Video Ended - Triggers if a rewarded video advertisement has ended.

  • On Check Video If Available - Triggers if a "Check Video If Available" action is fired, to directly check if a rewarded video advertisement is available.

    • Is Available - Toggle to check whether a rewarded video advertisement is available or not.

  • Is Video Showing - Checks if a rewarded video advertisement is currently showing.


Interstitial :

  • On Check Interstitial If Ready - Triggers if a "Check Interstitial If Ready" action is fired, to directly check if there is an interstitial advertisement available.

    • Is Ready - Toggle to check whether the interstitial advertisement is ready or not.

  • Is Interstitial Ready - Checks if an interstitial advertisement is ready to show.

  • On Interstitial Create Failed - Triggers if an interstitial advertisement has failed to load.

  • On Interstitial Show Failed - Triggers if an interstitial advertisement has failed to show.

  • On Interstitial Opened - Triggers if an interstitial advertisement has been opened.

  • On Interstitial Closed - Triggers if an interstitial advertisement has been closed.

  • On Interstitial Show - Triggers if an interstitial advertisement has shown successfully.

  • On Interstitial Clicked - Triggers if an interstitial advertisement has been clicked.

  • On Interstitial Ready - Triggers if an interstitial advertisement is ready to show.

  • Is Interstitial Showing - Checks if an interstitial advertisement is currently showing.


Banner :

  • Is Banner Loaded - Checks if a banner has been loaded. It's still loaded even after showing. Creating a new banner will reset the toggle.

  • Is Banner Showing - Checks if a banner is showing.

  • On Banner Created - Triggers if a banner advertisement has been loaded.

  • On Banner Create Failed - Triggers if a banner advertisement fails to load.

  • On Banner Clicked - Triggers if a banner advertisement has been clicked.

  • On Banner Screen Presented - Triggers if a banner advertisement is about to present a full screen content.

  • On Banner Screen Dismissed - Triggers if a banner advertisement's fullscreen content has been dismissed.

  • On Banner Left Application - Triggers if a banner advertisement's user would be taken out of the application context.


Offerwall :

  • On Offerwall Available - Triggers if an offerwall advertisement has changed its availability status.

    • Is Available - The toggle to check if the offerwall advertisement is available.

  • On Offerwall Opened - Triggers if an offerwall advertisement has opened.

  • On Offerwall Show Failed - Triggers if an offerwall advertisement has failed to show.

  • On Offerwall Credited - Triggers if an offerwall advertisement has credited the user.

  • On Offerwall Credit Failed - Triggers if an offerwall advertisement has failed to get the offerwall credits.

  • On Offerwall Closed - Triggers if an offerwall advertisement has closed.

  • Is Offerwall Available - Checks if the offerwall advertisement is ready to show.

  • Is Offerwall Showing - Checks if the offerwall advertisement is currently showing.


Segment :

  • On Segment Received - Triggers if the user's segment has been received by the current session.

    • Has Segment - Checks if there's a segment found and received for the current session user.


Placement Info :

  • On Get Video Placement Info - Triggers if the rewarded video advertisement's placement info has been retrieved successfully.

    • Placement Name - The rewarded video advertisement's placement name.

  • On Any Get Video Placement Info - Triggers if any rewarded video advertisement's placement info has been retrieved successfully.

Expressions

Expressions.png

Rewarded Video :

  • VideoPlacementName - The placement name of the rewarded video advertisement.

  • VideoRewardName - The reward name of the current rewarded video advertisement's placement.

  • VideoRewardAmount - The reward amount of the current rewarded video advertisement's placement.

Offerwall :

  • OfferwallCredits - Returns the number of credits the user has earned.

  • OfferwallTotalCredits - Returns the total number of credits ever earned by the user.

  • OfferwallTotalCreditsFlag - In some cases, like if the data is cleared, the exact credits wouldn't be provided. In this case, the ‘OfferwallCredits’ will be equal to the ‘OfferwallTotalCredits’, and this will return "True". Otherwise, "False".


Segment :

  • SegmentName - The received segment name. Empty if no segment has been found.


Failure Response :

  • ErrorCode - The error code, lookup the ironSource documentation for more information.

  • ErrorMessage - The error message, lookup the ironSource documentation for more information.

  • ErrorJSON - The error response in JSON string, lookup the ironSource documentation for more information.

Properties

Properties.png

Settings - Mobile IronSource addon's settings configuration.

  • Debug Mode - If enabled, the error logs will be shown in the console.

IronSource - The IronSource SDK configuration section.

  • AppKey - Your IronSource application key.

  • Initialization - Initialize the application on startup or manually by action. Manual mode gives more control.

    • Automatic

    • Manual

  • Features - The advertisement features to activate with the IronSource SDK.

    • Banner - Toggle to enable banner advertisements.

    • Interstitial - Toggle to enable interstitial advertisements.

    • Rewarded Video - Toggle to enable rewarded video advertisements.

    • Offerwall - Toggle to enable offerwall advertisements.


Preferences - Additional settings to add with the IronSource SDK.

  • Personalized Ads - GDPR Compliance, toggle to give consent. Recommended in manual mode, asking for the user's input.

  • Do Not Sell (CCPA) - CCPA Compliance, toggle to allow data selling to ad-providers. Recommended in manual mode, asking for the user's input.


Rewarded Video Ads - Configuration for rewarded video advertisements.

  • Track Network State - Toggle to sync the rewarded video advertisement availability with the network state.


Banner Ads - Configuration for banner advertisements.

  • Banner Overlap - Recommended to be checked. Toggle to place the banner on top of the layout, otherwise will adjust the layout to place the banner.


Offerwall Ads - Configuration for offerwall advertisements.

  • Receive Clientside Callbacks - Toggle to receive the callback triggers from the app or not. Set to false if offerwall credits are handled automatically from a server.

Debug Version

The Mobile IronSource addon has a debug version, this is used for validating integration in Android Studio or XCode.

This is compatible with the original addon, simply install this addon during testing and replace with the original for production.

In case of accidental usage of the debug version for production, don't worry it'll still work, there will just be some native debug codes.

Game Project

Sample Setup Project

Specifications

  • Instructions - The sample project has comments and instructions on how to use the addon and its features.

  • A.C.E. Coverage - It covers the implementation of each action, condition and expression.

  • Tips and Tricks - It provides some tips and tricks to a better use of the addon and of the event-sheet system alongside it.

Supporters

Only

Game Project

Automatic Project

Specifications

  • Instructions - The sample project has comments and instructions on how to use the addon and its features.

  • A.C.E. Coverage - It covers the implementation of each action, condition and expression.

  • Tips and Tricks - It provides some tips and tricks to a better use of the addon and of the event-sheet system alongside it.

Supporters

Only

Game Project

Manual Project

Specifications

  • Instructions - The sample project has comments and instructions on how to use the addon and its features.

  • A.C.E. Coverage - It covers the implementation of each action, condition and expression.

  • Tips and Tricks - It provides some tips and tricks to a better use of the addon and of the event-sheet system alongside it.

Supporters

Only

Game Project

Automatic Advanced

Specifications

  • Instructions - The sample project has comments and instructions on how to use the addon and its features.

  • A.C.E. Coverage - It covers the implementation of each action, condition and expression.

  • Tips and Tricks - It provides some tips and tricks to a better use of the addon and of the event-sheet system alongside it.

Supporters

Only

Game Project

Manual Advanced

Specifications

  • Instructions - The sample project has comments and instructions on how to use the addon and its features.

  • A.C.E. Coverage - It covers the implementation of each action, condition and expression.

  • Tips and Tricks - It provides some tips and tricks to a better use of the addon and of the event-sheet system alongside it.

Supporters

Only

 
 
 
 
 
 

Feature Showcase

 

Get the tools

for your pro games!

Constuct Master Collection - Itch.io
Constuct Master Collection - Discord
Constuct Master Collection - Construct 3

© Construct Master Collection 2020 • All rights reserved

Contact Information: