Rewarded Ad object

⚡ Before you start
Make sure you have correctly initialized Mediaiton Manager via Script or Unity Editor.

Implementation by UnityEditor | Script C#

• Add an RewardedAdObject to the scene
• Load Ad callbacks
• Content callbacks
• Unity Events sample
• Use RewardedAdObject from script

---

Rewarded ads are ads that users have the option of interacting with in exchange for in-app rewards.

This guide shows you how to integrate rewarded ads into a Unity app.

Add an RewardedAdObject to the scene

1. Add an GameObject to your scene using GameObject > Create Empty in the Unity Editor.
2. Add Component CleverAdsSolutions/Rewarded Ad Object in the inspector to new GameObject.
3. Select Manager ID from settings asset for each runtime platform.
4. Attach function to OnReward event to handle reward.
5. Invoke Present() method to show the interstitial ad.

• Restart Interstitial Ad interval on rewarded ad closed
  The interstitial ad interval will restart after the rewarded ad is closed.
• OnReward
  The most important event is called when the user is rewarded for watching a video

⭐ An RewardedAdObject does not have any rendered components. Therefore, you can place the GameObject anywhere in the scene.

Load Ad callbacks

• On Ad Loaded
  The event is invoked when the rewarded ad has finished loading.
• On Ad Failed To Load
  The event is invoked when the rewarded ad fails to load. The Message parameter describes the type of failure that occurred.

Content callbacks

• On Ad Failed To Show
  The event is invoked when the rewarded ad failed to show. The Message parameter describes the type of failure that occurred.
• On Ad Shown
  The event is invoked when the rewarded ad is shown.
• On Ad Clicked
  The event is invoked when the user clicks on the rewarded ad.
• On Ad Closed
  The event is invoked when the rewarded ad is closed.

⭐ Using Ad objects automatically enable Execute Events On Unity Thread and invoke all callbacks in the Unity Thread to safe use of Unity API.

Unity Events sample

You can implement functions that correspond to ad callbacks. For example, if you want to handle when a banner ad fails to load:

1. Create a function compatible with the ad callback in custom component.

public void OnReward() {
    Debug.Log("The user earned the reward.");
}

2. Attach the script which contains the above function to any GameObject in the scene.
3. Click the + button, then drag & drop the GameObject that you've attached the script to.
4. Select the function that you want to link to the ad callback. For the parameterized ad callbacks, select the function to accept the dynamic variable so you can get the parameter value from the SDK.

Use RewardedAdObject from script

Get the rewarded ad instance from the script:

RewardedAdObject interstitial = interstitialObject.GetComponent<RewardedAdObject>();

Before displaying a rewarded ad to users, you must present the user with an explicit choice to view rewarded ad content in exchange for a reward. Rewarded ads must always be an opt-in experience.

Show the rewarded ad:

interstitial.Present();

---

What’s Next?

• Follow our integration guides and implement our Ad Units:
  • Banner Ads
  • Rewarded Ads
• See the Privacy page to learn how to ensure that your application complies with privacy regulations.