Skip to content

Clarify rewarded video availability check timing #1540

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
jk7287 wants to merge 4 commits into from
+6 −2
Closed

Clarify rewarded video availability check timing #1540

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
7dce000
Clarify rewarded video availability checks
jk7287 Jul 15, 2026
dd7dab2
Clarify rewarded video availability rechecks
jk7287 Jul 15, 2026
594f502
Surface rewarded video availability timing
jk7287 Jul 15, 2026
f802e6c
Avoid prescribing rewarded ad button visibility
jk7287 Jul 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions content/en-us/production/promotion/rewarded-video-ads.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,10 @@ To implement the rewarded video ad on the client-side:
1. Add a new `Class.LocalScript` to the button you just inserted into your game.
2. Use the `Class.AdService.GetAdAvailabilityNowAsync|GetAdAvailabilityNowAsync` method to make sure the button is only visible to the user if an ad is available.

<Alert severity="warning">
When possible, call `GetAdAvailabilityNowAsync` only after the user takes a clear action to watch the ad, such as clicking the video ad play button. Maximizing the ratio of impressions to filled requests can benefit fill rate, EPM, and earnings.
</Alert>

```lua title="Code example for rewarded video ad (Client)"
-- Services
local AdService = game:GetService("AdService")
Expand Down Expand Up @@ -369,8 +373,8 @@ To prevent abuse of the rewarded ad system and to provide the best user experien

To get the most out of your rewarded video ad, make sure to:

- Call `Class.AdService.GetAdAvailabilityNowAsync|GetAdAvailabilityNowAsync` as close as possible to the moment you plan to show the ad. For example, if you have a "Watch video ad to get a reward" button in a shop menu, you should only call `GetAdAvailabilityNowAsync` when the user opens the shop menu. This approach improves performance by preventing ads from unnecessarily being held in memory, and benefits CPM (cost-per-thousand impressions) and earnings by optimizing the ad fill rate.
- Call `Class.AdService.GetAdAvailabilityNowAsync|GetAdAvailabilityNowAsync` when the user finishes watching the ad to determine if another ad is available for the user to watch.
- When possible, call `Class.AdService.GetAdAvailabilityNowAsync|GetAdAvailabilityNowAsync` only after the user takes a clear action to watch the ad, such as clicking the video ad play button.
- After an ad finishes, only call `Class.AdService.GetAdAvailabilityNowAsync|GetAdAvailabilityNowAsync` if you offer the user another ad to watch.
- Use analytics to identify the best placement for video ads to encourage user engagement without disrupting gameplay.
- Use ad opportunities to track when you offer a user a chance to watch a video ad for a reward. Keep an eye on the ratio between filled requests, ad opportunities, and ad impressions to figure out if you should make your ads easier to find or if your rewards need to be more compelling.

Expand Down
Loading