Skip to content

Commit 4326bdb

Browse files
jk7287IgnisRBX
andauthored
Clarify rewarded video availability check timing (#1541)
## Changes This surfaces the existing `GetAdAvailabilityNowAsync` timing guidance next to the client implementation steps. Developers should call the method as close as possible to showing the ad, such as when the user opens the shop menu containing the video ad button. The best practices now also avoid calling `GetAdAvailabilityNowAsync` after an ad finishes unless another ad is being offered. ## Checks By submitting your pull request for review, you agree to the following: - [ ] This contribution was created in whole or in part by me, and I have the right to submit it under the terms of this repository's open source licenses. - [ ] I understand and agree that this contribution and a record of it are public, maintained indefinitely, and may be redistributed under the terms of this repository's open source licenses. - [ ] To the best of my knowledge, all proposed changes are accurate. --------- Co-authored-by: IgnisRBX <43388550+IgnisRBX@users.noreply.github.com>
1 parent 49e7485 commit 4326bdb

1 file changed

Lines changed: 6 additions & 2 deletions

File tree

content/en-us/production/promotion/rewarded-video-ads.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,11 @@ To set up a rewarded video ad inside your game:
6565
To implement the rewarded video ad on the client-side:
6666

6767
1. Add a new `Class.LocalScript` to the button you just inserted into your game.
68-
2. Use the `Class.AdService.GetAdAvailabilityNowAsync|GetAdAvailabilityNowAsync` method to make sure the button is only visible to the user if an ad is available.
68+
2. Use `Class.AdService:GetAdAvailabilityNowAsync()` to check whether an ad is available before attempting to show it.
69+
70+
<Alert severity="warning">
71+
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, only call it when the user opens the shop menu.
72+
</Alert>
6973

7074
```lua title="Code example for rewarded video ad (Client)"
7175
-- Services
@@ -370,7 +374,7 @@ To prevent abuse of the rewarded ad system and to provide the best user experien
370374
To get the most out of your rewarded video ad, make sure to:
371375

372376
- 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.
373-
- Call `Class.AdService.GetAdAvailabilityNowAsync|GetAdAvailabilityNowAsync` when the user finishes watching the ad to determine if another ad is available for the user to watch.
377+
- After an ad finishes, only call `Class.AdService:GetAdAvailabilityNowAsync()|GetAdAvailabilityNowAsync()` if you offer the user another opportunity to watch an ad. This helps avoid filled requests that do not lead to impressions.
374378
- Use analytics to identify the best placement for video ads to encourage user engagement without disrupting gameplay.
375379
- 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.
376380

0 commit comments

Comments
 (0)