top of page

Advertising

The Advertising plugin is specifically designed to manage the application's advertisement features, especially Rewarded Adverts through the PlayFab service, for games built using Construct 3 and Construct 2.


The plugin allows you to manage, track (analytics) and claim items in the PlayFab Economy for players when rewarded through completion in watching advertisements.


The Advertising plugin is compatible with all Construct Master Collection's advertisement plugins, for all platforms including Web, Android and iOS.

PlayFab API v2.png

Introduction

Step 1.png

The Construct Master Collection supports the full and easy integration of the PlayFab service for both Construct 3 and Construct 2.


Please click here to learn more about PlayFab.

Features


Here are some of the features of the PlayFab service:

  • Rewarded Advertisements Integration

  • Economy Integration

  • Advertisement Rewards

  • Player Item Claim

  • Player Statistic Claim

  • Player Currency Claim

  • Advertisement Placements

  • Advertisement Segments

  • Reward Limits

  • Advertisement Reporting

  • Attribution


For more information about all the integrated PlayFab service features, please click here to learn the introductory lessons to PlayFab.


Network Services


Here are some of the platform services that can be linked:

  • PlayFab

  • Google Play

  • Game Center

  • Facebook

  • Facebook Instant Games

  • Steam

  • Xbox Live

  • Instant Games (Android Studio port)

  • Nintendo Switch (3rd party porting services)

  • PS4 (3rd party porting services)

  • Nintendo Switch (3rd party porting services)


Editor Features


Here are some of the features in the Construct editor:

  • All platforms support, including web, mobile and desktop.

  • Construct 3

  • Construct 2

Introduction
Features

How to use?

It is easy to use the Advertising plugin, you will only need to follow the steps below.

  1. Set up the PlayFab API plugin, please click to visit the documentation. This includes creating a PlayFab account, studio and title.

  2. Set up the Authentication plugin, please click to visit the documentation.

  3. Finally, you can now use the Advertising object, and include more PlayFab addons for more features.


Instructions
Documentation

Documentation

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



Server Configuration



To integrate rewarded advertisements.

  1. Login to your PlayFab account.

  2. Choose a studio and select the title you want to enable adding and/or subtracting virtual currencies.

  3. From the sidebar, select the settings icon.

  4. Then, click the Title Settings option.

  5. From the Title Settings page, select the API features tab.

  6. Under the Enable API Features section, check the following checkboxes.

    • Allow client to add virtual currency

    • Allow client to subtract virtual currency



Related Plugins


  • Mobile IronSource Collection - is a plugin collection that implements IronSource advertisements with ad-network mediation or advert bidding with other ad-networks including Google Admob, Facebook Audience Network, Unity Ads, and 20+ other most popular and competitive ad-networks. The Mobile IronSource Collection is written natively from scratch using both the Android SDK and iOS SDK of each ad-network including ironSource, and developed in mind solely for Construct 3 integration. The Mobile IronSource Collection is designed for optimal advertisement delivery on mobile for Construct 3.

  • Google Admob Collection - is a plugin collection that implements Google Admob advertisements. It is a completed version of the Mobile Advert with complete features, while remaining easy to use.

  • Google Ads (Web H5) - is a plugin that implements HTML5 Games Ads with Google AdSense. Google Ads plugin supports web, mobile web including Google Admob, and desktop web.

ACEs

Actions, Conditions & Expressions

Actions

The following action groups:

  • General

  • Advert

General

  • Attribute Install - Attribute an install for advertisement.

    • Adid - The adid for this device.

    • Idfa - The IdentifierForAdvertisers for iOS Devices.


  • Get Placements - Request a list of ad placements and a reward for each.

    • App Id - The current application id to use.

    • Tag - Tag to differentitate requests.


  • Get Placement - Request an ad placement and its reward.

    • App Id - The current application id to use.

    • Id - Id Identifier, if present.

    • Name - Name Identifier, if present.

    • Tag - Tag to differentitate requests.



Advert

  • Report Advert - Report an advertisement state.

    • Placement Id - Unique ID of the placement to report for.

    • Reward Id - Unique ID of the reward the player was offered.

    • Activity - Type of activity, may be Opened, Closed, Start or End.

    • Tag - Tag to differentitate requests.


  • Plan Custom Tag - The optional custom tags associated with the next request (e.g. build number, external trace identifiers, etc.).

    • Key - The key of this custom tag.

    • Value - The value of this custom tag.


  • Reward Player - Grant a reward to the player after completely watching an advertisement.

    • Placement Id - Placement unique ID

    • Reward Id - Reward unique ID

    • Tag - Tag to differentitate requests.

Conditions

The following condition groups:

  • General

  • Advert

  • Placement

  • Reward

General

  • Compare Tag - Compare the tag value of the current request.

    • Comparison - Select the way to compare the tag value.

    • Tag - Enter the value to compare.


  • On Attribute Installed - Trigger fires when attribute installation has completed successfully.


  • On Attribute Install Failed - Trigger fires when attribute installation has failed.



Advert

  • On Rewarded - Trigger fires when the advertisement rewards have been granted to the player.

    • Tag - Enter the tag to differentiate requests.


  • On Advert Reported - Trigger fires when an advertisement state has been reported.

    • Tag - Enter the tag to differentiate requests.


  • On Any Rewarded - Trigger fires when the advertisement rewards have been granted to the player.


  • On Any Advert Reported - Trigger fires when an advertisement state has been reported.


  • On Reward Failed - Trigger fires upon failure to grant the player rewards.

    • Tag - Enter the tag to differentiate requests.


  • On Advert Report Failed - Trigger fires upon failure to report the advertisement state.

    • Tag - Enter the tag to differentiate requests.


  • On Any Reward Failed - Trigger fires upon failure to grant the player rewards.


  • On Any Advert Report Failed - Trigger fires upon failure to report the advertisement state.



Placement

  • On Get Placements - Trigger fires when the placements are successfully retrieved from the server.

    • Tag - Enter the tag to differentiate requests.


  • On Any Get Placements - Trigger fires when the placements are successfully retrieved from the server.


  • For Each Placement - Loops through all the received placements from the server.


  • On Get Placements Failed - Trigger fires upon failure to retrieve the placements from the server.

    • Tag - Enter the tag to differentiate requests.


  • On Any Get Placements Failed - Trigger fires upon failure to retrieve the placements from the server.



Reward

  • For Each Item - Loops through all the granted reward items from the server.


  • For Each Currency - Loops through all the granted currencies from the server.


  • For Each Statistic - Loops through all the granted and incremented statistics from the server.

Expressions

The following expression groups:

  • General

  • Placement

  • Reward

  • Reward (Items)

  • Reward (Currencies)

  • Reward (Statistics)

  • Server

General

  • Tag - The tag to differentiate requests.



Placement

  • PlacementId - Return the placement unique id.

    • Index - The index of the placement to get from the placement list.


  • PlacementCount - Return the number of placements received from the server.