Before beginning this tutorial, be sure to watch the tutorial on installing the ctalyst plugin on the Unreal Engine game development platform.
You can watch the Plugin Installation tutorial from this link: Installing the Unreal Engine UE4 ctalyst Plugin
Because Interactive and Incentivized ads are more advanced than Dynamic or Static ads, be sure to watch the tutorial on how to create Dynamic and Static ads. You should be familiar with the process before attempting to create an interactive ad.
You can watch the Dynamic and Static tutorial from this link: Setting Up Dynamic and Static Ads
Adding an Interactive Plane
Open your game project in the Unreal Engine.
For this tutorial, we will be working with an empty level and with the plugin already installed.
However, you can use ctalyst at any point during your game development cycle.
We have created a simple plane in our basic empty level.
Let’s create a Plane Blueprint and add a default material to the plane.
Default materials are those that you would like your players to see if there are no ads to be served or there is no network connectivity. This is a great feature as it ensures a native and genuine look and feel to your game, and further guarantees your ad spaces will never be empty.
Next, add a box collider to the plane and adjust its size to fit the plane.
We’ll now add the ctalyst Custom Collison Method to the Plane’s Blueprint box collider to execute when a collision has been detected.
Open the Plane Blueprint, navigate to the Event Graph Tab, and add a method to the Event ActorBeginOverlap.
Right-click on the graph and add ctalyst’s custom method function titled Actors Overlapped Event.
Connect the Event ActorBeginOverlap module’s execution node to the Actors Overlapped Event execution node.
The Actors Overlapped Event has two parameters. They are named Overlapping Actor and Overlapped Actor.
Select Other Actor under Event ActorBeginOverlapped and connect it to the Overlapping Actor parameter of the function.
Right-click on an empty space in the graph editor and select Get a Reference to self and connect it to the Overlapped Actor parameter.
Adding The Reward
We can now add the in-game reward code. Interactive ads must always offer the player an in-game reward during the game play in addition to real-world rewards in the coupon menu.
For the purpose of the tutorial, we’ll demonstrate the reward by executing a simple Print Statement as a confirmation. But you can reward the player in any you can imagine that would be appropriate for the game play moment.
For example, you could reward a player with an instant health boost, or a discount on an in-app purchase from your app store, or even a time-limited special offer from the in-app store. You could also reward players with levels, bonuses, special items and more.
To connect your reward, left click the execution node of the Actors Overlapped Event and drag it out.
From the list that appears, select the reward function that you’ve created. If you have not created a reward function you will need to do so first.
And again, in this tutorial we are going to select a basic Print Statement to deliver a confirmation message.
Compile, save and exit.
Adding The SDK
Drag and drop the Plane’s Blueprint into the scene and then add the Plane’s Blueprint to the ctalystSDK, by selecting the ctalystSDK under the World Outliner window.
Select the ctalystSDK and then from the Details window, add an object to the Ad Objects List by clicking the plus sign.
Choose the Actor Option you’ve just created.
Change the Ad Type to Interactive, and set the AdCode to the aspect ratio of your plane.
Product Placement ID’s are only for product placements and can be ignored.
Coupon Type is either landscape or portrait, depending on how you’ve chosen to design your Reward’s Menu.
Priority is a grouping that determines the order that ads are served. The lower the number, the higher the priority. For example, you can assign a group of ads to Priority 0 in front of where a player will spawn.
You can assign multiple ads to the same priority group.
Level is a future feature, you can safely ignore it.
That’s it! You’re now ready to serve interactive and incentivized ads. Hit the play button to see and test with the sandbox ads.