Ads documentation missing?

Unity Services
1

I am unable to find documentation about some question of how unity ads works, I have read the FAQ but there is still some question without answer.

  • The function ‘Advertisement.IsReady(“rewardedVideo”)’ return false in case the ads is loading? Or it only check If the ad server can serve and ad?

  • The function ‘Advertisement.IsReady(“rewardedVideo”)’ return false in case the user doesn’t have internet? ( If the user enter in an elevator, and lose internet, click on the ads, it fails, and then the user go out from the elevator and recover internet again, will IsReady return true?

  • What is the expected workflow of unity ads ? ( For example , isReady return true, then the ad gets loaded and finnally the ads plays)

  • Which causes could lead to IsReady return false?

  • Which causes could lead to Show.Result.Failed callback?

  • In case the ad is not ready, Is any way to know the reason? So we can give the user a proper feedback like “Come tomorrow for more ads”,“You need internet connection”,“Unable to load the ads, try again later”, “There is currently no ads available in your country”…etc return a generic error message is not the best aproach in ads

Thanks in advance

2

Seems all your questions are related to https://docs.unity3d.com/ScriptReference/Advertisements.Advertisement.IsReady.html method. IsReady() will return true when Ads SDK is able to show an ad, typically that ad has been cached on device. So if IsReady() returns true, you can as developer safely call Show() immediately after.

IsReady() could still return true, even if user doesn’t have internet connection, as long as they had connection at some point, at which SDK would download and cache the video.

Right now Ads SDK doesn’t return any error codes, could be a feature to consider though. There are couple of ways to check for internet connectivity yourself in game, which you could use for now, to give better user experience.

/Rasmus

3

Thanks for the answer, So in case that the ad failed (I assume that it failed after being ready, and called show) isReady will still return true for the same ad? Or It will refresh?

Imagine that the user have an ad ready to show, He tries to see the ad, but it fails, the user again click on the ad
IsReady will return false now? ( Assuming there is only 1 ad available)

Please take into consideration to make error codes as a new feature, When the user click on ads and fails , If users doesn’t know what is happening and only see a generic error message, that discourage from clicking again in the future

4

If your gameplay is depending on ads to be shown, you can consider looking at mediation networks like e.g. https://unity.fyber.com/docs which will allow you to integrate multiple ad networks into your game, and thereby likely increasing the chance of an ad being available.

/Rasmus