Rewarded ads integration for Unity Package

Prerequisites

• Ensure that you have correctly integrated the LevelPlay Unity package into your application. Integration is outlined here.
• Ensure that you initialize the SDK using LevelPlay Initialization API.
• Find the AdUnitID in LevelPlay dashboard.

Create Rewarded Ad Object

// Create Rewarded Ad object LevelPlayRewardedAd rewardedAd = new LevelPlayRewardedAd(rewardedAdUnitId);

LevelPlayRewardedAd

Config

// Use optional Config parameterLevelPlayRewardedAd(string adUnitId, Config config = null)

Config

adUnitId

Creating with a Price Floor

Config

LevelPlayRewardedAd

// Create Rewarded Ad object with Price Floor in config.var configBuilder = new LevelPlayRewardedAd.Config.Builder();configBuilder.SetBidFloor(1.0); // Minimum bid price in USDvar rvConfig = configBuilder.Build();LevelPlayRewardedAd RewardedAd = new LevelPlayRewardedAd(RewardedAdUnitId, rvConfig);

Register to Rewarded Events

• It is recommended to set the listener before loading the rewarded ad.
• Each rewarded ad should have its own listener implementation.
• Callbacks run on the main thread.

// Register to Rewarded eventsRewardedAd.OnAdLoaded += RewardedOnAdLoadedEvent;RewardedAd.OnAdLoadFailed += RewardedOnAdLoadFailedEvent;RewardedAd.OnAdDisplayed += RewardedOnAdDisplayedEvent;RewardedAd.OnAdDisplayFailed += RewardedOnAdDisplayFailedEvent;RewardedAd.OnAdRewarded += RewardedOnAdRewardedEvent;RewardedAd.OnAdClosed += RewardedOnAdClosedEvent;// OptionalRewardedAd.OnAdClicked += RewardedOnAdClickedEvent;RewardedAd.OnAdInfoChanged += RewardedOnAdInfoChangedEvent;// Implement the eventsvoid RewardedOnAdLoadedEvent(LevelPlayAdInfo adInfo) {}void RewardedOnAdLoadFailedEvent(LevelPlayAdError error) {}void RewardedOnAdDisplayedEvent(LevelPlayAdInfo adInfo) {}void RewardedOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error) {}void RewardedOnAdRewardedEvent(LevelPlayAdInfo adInfo, LevelPlayReward adReward) {}void RewardedOnAdClosedEvent(LevelPlayAdInfo adInfo) {}void RewardedOnAdClickedEvent(LevelPlayAdInfo adInfo) {}void RewardedOnAdInfoChangedEvent(LevelPlayAdInfo adInfo) {}

LevelPlay Ad Info

Get Rewarded ad details

Prerequisites

• SDK Initialization: Call initSDK and wait for the onInitializationSuccess callback to ensure the reward data has been cached.
• Ad Object Instance: Instantiate a Rewarded Ad object with a valid Ad Unit ID before calling the API.
• Minimum SDK Version: Use LevelPlay SDK version 8.1.0 or higher (Native or Unity package).

Best practices

• Call on initialization success: The best time to call getReward is immediately inside your initialization success listener. This ensures your UI is ready the moment the user enters a screen.
• Check for empty states: Always validate that amount > 0 before you update your UI. This ensures a smooth user experience if a network error occurs during initialization.
• Placement precision: Ensure the string used in getReward("placementName") exactly matches the name defined in the LevelPlay dashboard.

API structure

getReward

public LevelPlayReward getReward(String placementName)

null

Initial setup

• Integrated feature: Because the reward data is retrieved during the initial SDK setup, the API call is instantaneous and doesn't require a network request.
• Editor configuration: After your app is integrated with the LevelPlay SDK, the API is available for use immediately. No additional assets or plugins are required to test this functionality.

Understand reward selection logic

• Placement level: If a valid placement name is provided in the call, the SDK returns the specific reward configured for that placement in the dashboard.
• Ad Unit level: If the placement name is null or not found, the SDK falls back to the default reward defined for the Ad Unit.
• Fallback state: If the API is called before initialization is complete, it returns a reward object with an empty string name and an amount of 0.

Update your UI dynamically

• Validate amount: Always verify that reward.amount > 0 before updating your UI components.
• Event-Driven updates: Call the API inside your initialization success listener to ensure the UI is accurate the moment a user enters a screen.
• Case sensitivity: Ensure the placement name string in your code matches the LevelPlay dashboard exactly; mismatched strings will trigger the Ad Unit fallback.

Retrieve reward data examples

/// <summary> /// Retrieves the reward associated with the ad. /// Use this method to obtain the reward configured for the ad unit or placement. The /// placement-specific reward takes precedence over the ad unit reward when a valid placement name /// is provided. /// </summary> /// <param name="placement">The placement name to retrieve the reward for, or null to use the ad unit's reward.</param> /// <returns>A <see cref="LevelPlayReward"/> object. Returns an empty reward on failures (name: "" and amount: 0).</returns> LevelPlayReward reward = rewardedAd.getReward("battle_screen");// Update UI dynamicallyif (reward.Amount > 0 && !string.IsNullOrEmpty(reward.Name)) {    rewardButton.text = $"Click to get {reward.Amount} {reward.Name}";} else {    rewardButton.text = "Watch for Rewards";}

Troubleshooting getReward API implementation

• Reward amount returns 0: This usually occurs if the API is called before the onInitializationSuccess callback. Ensure the SDK is fully ready before querying rewards.
• Wrong reward type shown: Check if you have multiple placements. If the placement name is misspelled, the SDK will default to the primary ad unit reward instead of the specific placement reward.

Load Rewarded Ad

// Load rewarded adRewardedAd.LoadAd();

Show Rewarded Ad

• If using placements, pass the placement name in the ShowAd API as shown in the Placements section below.
• When the ad has been successfully displayed to the user, you can load another ad by repeating the loading step.

// Show ad without placementRewardedAd.ShowAd();// Show ad with placementRewardedAd.ShowAd(placementName: "placementName");

Check Ad is Ready

// Check that ad is ready and that the placement is not cappedif (RewardedAd.IsAdReady() && !LevelPlayRewardedAd.IsPlacementCapped(placementName)){    RewardedAd.ShowAd(placementName);}

Placements

// Check that ad is ready and that the placement is not cappedif (RewardedAd.IsAdReady() && !LevelPlayRewardedAd.IsPlacementCapped(placementName)){    RewardedAd.ShowAd(placementName);}

Dynamic UserId

• The string value must be comprised of 1-64 alphanumeric characters.
• You will receive a

  dynamicUserId

  parameter in the callback URL with the reward details.

LevelPlay.SetDynamicUserId("userId");

Reward the User

// Subscribe to the OnAdRewarded eventRewardedAd.OnAdRewarded += (adInfo, adReward) =>{    // Grant the reward to the user    Debug.Log($"Ad Completed: {adInfo.PlacementName}, Reward: {adReward.Name} - {adReward.Amount}");    GrantReward(adReward.Name, adReward.Amount);};// Example method to process the rewardprivate void GrantReward(string rewardName, int rewardAmount){    // TODO: Implement logic to grant the reward to the user    Debug.Log($"Granting reward: {rewardName} with amount: {rewardAmount}");}

Full Implementation Example of Rewarded Ads

public class RewardedAdSample {    private LevelPlayRewardedAd RewardedAd;    void CreateRewardedAd() {        // Create RewardedAd instance        RewardedAd = new LevelPlayRewardedAd("RewardedAdUnitId");        // Subscribe RewardedAd events        RewardedAd.OnAdLoaded += RewardedOnAdLoadedEvent;        RewardedAd.OnAdLoadFailed += RewardedOnAdLoadFailedEvent;        RewardedAd.OnAdDisplayed += RewardedOnAdDisplayedEvent;        RewardedAd.OnAdDisplayFailed += RewardedOnAdDisplayFailedEvent;        RewardedAd.OnAdClicked += RewardedOnAdClickedEvent;        RewardedAd.OnAdClosed += RewardedOnAdClosedEvent;        RewardedAd.OnAdRewarded += RewardedOnAdRewardedEvent;        RewardedAd.OnAdInfoChanged += RewardedOnAdInfoChangedEvent;    }    void LoadRewardedAd() {        // Load or reload RewardedAd        RewardedAd.LoadAd();    }    void ShowRewardedAd() {        // Show RewardedAd, check if the ad is ready before showing        if (RewardedAd.IsAdReady()) {            RewardedAd.ShowAd();        }    }    // Implement RewardedAd events    void RewardedOnAdLoadedEvent(LevelPlayAdInfo adInfo) { }    void RewardedOnAdLoadFailedEvent(LevelPlayAdError error) { }    void RewardedOnAdClickedEvent(LevelPlayAdInfo adInfo) { }    void RewardedOnAdDisplayedEvent(LevelPlayAdInfo adInfo) { }    void RewardedOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error) { }    void RewardedOnAdClosedEvent(LevelPlayAdInfo adInfo) { }    void RewardedOnAdRewardedEvent(LevelPlayAdInfo adInfo, LevelPlayReward adReward) { }    void RewardedOnAdInfoChangedEvent(LevelPlayAdInfo adInfo) { }}

LevelPlay Mediation Demo App

Next steps

• Add Mediation Networks
• Interstitial Ad
• Banner Ads