Rewarded video - user-initiated ads where users can earn in-app rewards in exchange for viewing a video ad.

You can use our demo app  as a reference project.

1. Display rewarded video

To display rewarded video, call the following code in the activity:

Appodeal.show(activity, Appodeal.REWARDED_VIDEO);

Appodeal.show(activity, Appodeal.REWARDED_VIDEO)

2. Check if a rewarded video is loaded

Appodeal.isLoaded(Appodeal.REWARDED_VIDEO);

Appodeal.isLoaded(Appodeal.REWARDED_VIDEO)

3. Use rewarded video callbacks

Appodeal.setRewardedVideoCallbacks(new RewardedVideoCallbacks() {
  @Override
  public void onRewardedVideoLoaded(boolean isPrecache) {
    // Called when rewarded video is loaded
  }
  @Override
  public void onRewardedVideoFailedToLoad() {
    // Called when rewarded video failed to load
  }
  @Override
  public void onRewardedVideoShown() {
    // Called when rewarded video is shown
  }
  @Override
  public void onRewardedVideoShowFailed() {
    // Called when rewarded video show failed
  }
  @Override
  public void onRewardedVideoClicked() {
    // Called when rewarded video is clicked
  }
  @Override
  public void onRewardedVideoFinished(double amount, String name) {
    // Called when rewarded video is viewed until the end
  }
  @Override
  public void onRewardedVideoClosed(boolean finished) {
    // Called when rewarded video is closed
  }
  @Override
  public void onRewardedVideoExpired() {
    // Called when rewarded video is expired
  }
});

Appodeal.setRewardedVideoCallbacks(object : RewardedVideoCallbacks {
  override fun onRewardedVideoLoaded(boolean isPrecache) {
    // Called when rewarded video is loaded
  }
  override fun onRewardedVideoFailedToLoad() {
    // Called when rewarded video failed to load
  }
  override fun onRewardedVideoShown() {
    // Called when rewarded video is shown
  }
  override fun onRewardedVideoShowFailed() {
    // Called when rewarded video show failed
  }
  override fun onRewardedVideoClicked() {
    // Called when rewarded video is clicked
  }
  override fun onRewardedVideoFinished(double amount, String name) {
    // Called when rewarded video is viewed until the end
  }
  override fun onRewardedVideoClosed(boolean finished) {
    // Called when rewarded video is closed
  }
  override fun onRewardedVideoExpired() {
    // Called when rewarded video is expired
  }
})

4. Cache rewarded video manually

By default, auto caching is enabled: Appodeal SDK starts to load Rewarded Video right after the initialization method is called. The next Rewarded Video ad starts to load after the previous one has been shown.

To disable automatic caching for rewarded videos, use the code below before the SDK initialization:

Appodeal.setAutoCache(Appodeal.REWARDED_VIDEO, false);

Appodeal.setAutoCache(Appodeal.REWARDED_VIDEO, false)

Appodeal.cache(activity, Appodeal.REWARDED_VIDEO);

Appodeal.cache(activity, Appodeal.REWARDED_VIDEO)

5. S2S rewarded video callbacks

5.1. Server-to-server (S2S) rewarded video callbacks

To secure your app's economy, we offer S2S reward callbacks. To validate each reward, you need to set up a callback URL on your server that will receive the reward information. Appodeal will pass the user data to your callback URL that you will need to validate and adjust the user balance accordingly.

1. Create the reward callback URL on your server that will receive the reward information.

2. Fill the created URL and the encryption key in the app settings in your dashboard.

3. The reward callback will be sent to your URL using GET request with two parameters:

{http://example.com/reward}?data1={data1}&data2={data2}

5. Check impression_id for uniqueness and store it in your system to prevent the duplicate of transactions.

To set the user ID, use this method before the SDK initialization:

Appodeal.getUserSettings(this).setUserID("User#123")

Appodeal.getUserSettings(this).setUserID("User#123")

We offer sample scripts in Go, PHP, Ruby, Java, Node.js, Python 3, and C# to decrypt the data. If you need samples in other languages, please contact our support team and we will provide it to you.

Sample in PHP: reward.php.

Sample in Ruby: reward.rb.

Sample in Java: reward.java.

Sample in Node.js: reward.js. 

Sample in Python 3: reward.py.

Sample in C#: reward.cs.

Sample in Go: reward.go.

5.2. Get reward data for placement

To get the reward data set for a specific placement use the following method before showing the rewarded video:

Appodeal.getRewardParameters(placementName);

Appodeal.getRewardParameters(placementName)

6. Check if the rewarded video was initialized

To check if the rewarded video was initialized, you can use the method:

Appodeal.isInitialized(activity, Appodeal.REWARDED_VIDEO);

Appodeal.isInitialized(activity, Appodeal.REWARDED_VIDEO)

7. Check if autocache is enabled for rewarded video

To check if autocache is enabled for rewarded video, you can use the method:

Appodeal.isAutoCacheEnabled(activity, Appodeal.REWARDED_VIDEO);

Appodeal.isAutoCacheEnabled(activity, Appodeal.REWARDED_VIDEO)

8. Get predicted eCPM for rewarded video

To get the predicted eCPM from the next block in the caching queue, use the method:

Appodeal.getPredictedEcpm(Appodeal.REWARDED_VIDEO);

Appodeal.getPredictedEcpm(Appodeal.REWARDED_VIDEO)

9. Mute videos if call volume is muted

You can mute the sound in a rewarded video using the method:

Appodeal.muteVideosIfCallsMuted(true);

Appodeal.muteVideosIfCallsMuted(true)