Rewarded

This article will go through all the steps required to display a Rewarded ad in your application.

Rewarded ads are skippable fullscreen ads. They allow you to reward users with in-app items for watching ads.

Rewarded ads can only be served to users who explicitly and previously chose to view a rewarded ad. You can specify the reward values associated with the ad units in your application and set different rewards for different ad units.

Prerequisites

Ensure your application is registered on the Ogury Dashboard. If not, please refer to the Getting Started page before proceeding.

Step 1: Create a Rewarded ad unit

on your asset page in the Ogury Dashboard.
, as you will need it for integration. It is in the form of a UUID, which consists of a 36-character string formatted as follows: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where each x represents a hexadecimal digit.

In the following code samples, this ad unit ID will be represented as xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Step 2: Load a Rewarded ad

To load a Rewarded ad, instantiate an OguryRewardedAd object and call its load() method.

class MyActivity : Activity() {

    private lateinit var rewardedAd: OguryRewardedAd

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        rewardedAd= OguryRewardedAd(this, "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
        rewardedAd.load()
    }
}

public class MyActivity extends Activity {

    private OguryRewardedAd rewardedAd;
    
    @Override protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
                        
        rewardedAd= new OguryRewardedAd(this, "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
        rewardedAd.load() 
    }
    
}

OguryRewardedAd requires the following parameters:

context: a reference to any kind of Context.
adUnitID: the ad unit ID for the Rewarded ad. If you do not have one, please refer to the first step to create it.

If you are developing a mediation adapter, you must pass an additional parameter, OguryMediation which should be instantiated with:

name: the name of the mediation.
version: the version of the mediation SDK.

rewardedAd = OguryRewardedAd(
    this, 
    "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    OguryMediation("your mediation name", "your mediation SDK version")
)

rewardedAd = new OguryRewardedAd(
    this, 
    "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    new OguryMediation("your mediation name", "your mediation SDK version")
);

Step 3: Register for callbacks

You can monitor the lifecycle of your Rewarded ad by implementing the OguryRewardedAdListener interface. This listener provides real-time updates on key events, such as successful ad loading, display, reward or errors.

To use it, set the listener on the instance of OguryRewardedAd by calling the setListener() method before invoking the load() method. Implement the necessary methods in your class to ensure timely notifications, allowing you to manage the ad experience effectively.

The onAdRewarded callback specifically allows you to handle the rewards given to users after they interact with the ad. The reward name and value can be set in the Reward Settings section of your ad unit on the Ogury Dashboard.

If the onAdErrorcallback is triggered, refer to the Error handling section below for detailed information on troubleshooting.

rewardedAd.setListener(object : OguryRewardedAdListener {

    // Called when the ad is loaded and ready to be shown
    override fun onAdLoaded(rewardedAd: OguryRewardedAd) {
        // Call show() to display the ad
    }

    // Called when an impression is recorded
    override fun onAdImpression(rewardedAd: OguryRewardedAd) {
        // Track ad performance here
    }
    
    // Called when the user earns a reward from the ad
    override fun onAdRewarded(rewardedAd: OguryRewardedAd, reward: OguryReward) {
        // Handle the rewarded event, such as granting the user the reward
        val rewardName = reward.name
        val rewardValue = reward.value
    }

    // Called when the user clicks on the ad
    override fun onAdClicked(rewardedAd: OguryRewardedAd) {
        // Handle ad click tracking here
    }

    // Called when the ad is closed
    override fun onAdClosed(rewardedAd: OguryRewardedAd) {
        // Resume app flow after ad is closed
    }

    // Called when the ad fails to load or display
    override fun onAdError(rewardedAd: OguryRewardedAd, error: OguryAdError) {
        when (error.type) {
            OguryAdError.Type.LOAD_ERROR-> {
                // Handle loading error
            }
            OguryAdError.Type.SHOW_ERROR -> {
                // Handle display error
            }
        }
    }
})

rewardedAd.setListener(new OguryRewardedAdListener() {

    // Called when the ad is loaded and ready to be shown
    @Override
    public void onAdLoaded(OguryRewardedAd rewardedAd) {
        // Call show() to display the ad
    }
    
    // Called when an impression is recorded
    @Override
    public void onAdImpression(OguryRewardedAd rewardedAd) {
        // Track ad performance here
    }
    
    // Called when the user earns a reward from the ad
    @Override
    public void onAdRewarded(OguryInterstitialAd interstitialAd, OguryReward reward) {
        // Handle the rewarded event, such as granting the user the reward
        String rewardName = reward.getName();
        String rewardValue = reward.getValue();
    }
    
    // Called when the user clicks on the ad
    @Override
    public void onAdClicked(OguryRewardedAd rewardedAd) {
        // Handle ad click tracking here
    }
    
    // Called when the ad is closed
    @Override
    public void onAdClosed(OguryRewardedAd rewardedAd) {
        // Resume app flow after ad is closed
    }
    
    // Called when the ad fails to load or display
    @Override
    public void onAdError(OguryRewardedAd rewardedAd, OguryAdError error) {
        switch (error.type) {
            case OguryAdError.Type.LOAD_ERROR:
                // Handle loading error
                break;
            case OguryAdError.Type.SHOW_ERROR:
                // Handle display error
                break;
        }
    }
    
});

Step 4: Show a Rewarded Ad

To display a loaded Rewarded ad, invoke the show() method on the instantiated OguryRewardedAd object.

if (rewardedAd.isLoaded()) {
    // The ad is loaded and ready to be displayed.
    rewardedAd.show()
} else {
    // The ad is not loaded yet. Handle this situation appropriately.
}

if(rewardedAd.isLoaded()) {
    // The ad is loaded and ready to be displayed.
    rewardedAd.show();
} else {
    // The ad is not loaded yet. Handle this situation appropriately.
}

Always verify that the ad is loaded before invoking the show() method, particularly if you are not calling it from the onAdLoaded callback.

Step 5: Test your integration

After registering your app, it may take up to 15 minutes before ads are available.

Ogury exclusively serves ads to users who have provided their consent. Before conducting any tests, it is essential to ensure that your implementation complies with applicable privacy regulations. For more information on the regulations supported by Ogury, please visit the Privacy compliance page.

Since our algorithm uses personalized targeting, you may not receive ads during testing. To obtain test ads, you can append _test to your Rewarded ad unit ID in the code, for example: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_test.

For further details on test mode and enabling debug logs, please refer to the Test your implementation page.

Advanced topics

Error handling

If you are unable to load or display any Rewarded ads, we recommend logging callbacks from the OguryRewardedAdListener to monitor the ad's lifecycle, especially the onAdError callback. This method provides an OguryAdError instance containing important error details:

type: indicates the error type through the OguryAdError.Type enum, which distinguishes between loading errors (Load) and showing errors (Show).
code: An integer that identifies the specific error. Errors that can occur during ad loading or displaying are defined in the OguryLoadErrorCode and OguryShowErrorCode classes. Detailed explanations of these error codes are provided in the tables below to assist you in troubleshooting effectively.
message: A descriptive message that provides additional context about the error.

You can utilize these details to diagnose the issue and take appropriate action to resolve it.

OguryLoadErrorCode

OguryShowErrorCode

Last updated 1 month ago