Getting a game site ready for H5 Games Ads: AdSense site approval
The published steps before H5 Games Ads can serve: AdSense account, adding the site, ownership checks, Ready status, ads.txt and the H5 application form.
H5 Games Ads (the Ad Placement API’s adBreak() and adConfig()) runs on the AdSense code, so the site that hosts your game has to clear the same AdSense steps as any other site, plus a separate application for the games product. This page lists those steps as Google’s help center and developer docs describe them on 2026-10-01. Nothing here makes approval more likely; Google states that access is not guaranteed. For the integration itself, see Google Ad Placement API: adBreak().
The steps in order
- Have an approved AdSense account (sign up).
- Add the site that hosts the game to the AdSense Sites page (add a site).
- Verify ownership with the ad code, an ads.txt line or a meta tag.
- Request review and wait for the site to show “Ready” (site status).
- Publish an ads.txt file with your publisher ID (ads.txt guide).
- Apply for H5 Games Ads through Google’s form (apply).
Google’s pages do not say whether step 6 must wait for step 4; they say only that both an approved account and an application are needed.
Which site to add
The AdSense tag belongs in the same document as the game canvas. If you iframe your own game from another URL, the tag goes inside the iframe (game structure). Whoever hosts that document controls the publisher ID, the monetization settings and the payments (payments). So the site to add and get approved is the one that serves the game page. A game you send to a portal that hosts it falls under that portal’s tag, not yours.
Add the site and verify ownership
In AdSense, open Sites, choose the new-site option, enter the URL and save. The site appears with the status “Requires review” (add a site). Sites on host partners such as Blogger are added through the partner instead.
You then connect the site with one of three methods (add a site):
- AdSense code snippet in the
<head>of each page that will show ads. For a game page this is the code you need anyway. - ads.txt line in a file at the site root.
- Meta tag in the
<head>, if you do not want the ad code on the homepage.
<!-- Option 1: the AdSense code. For H5 Games Ads, keep the second script too:
it defines adBreak() and adConfig(). Replace the ID with your own. -->
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-0000000000000000"
crossorigin="anonymous"></script>
<script>
window.adsbygoogle = window.adsbygoogle || [];
var adBreak = adConfig = function (o) { adsbygoogle.push(o); };
</script>
<!-- Option 3: ownership meta tag only -->
<meta name="google-adsense-account" content="ca-pub-0000000000000000">
The script lines follow the H5 Games Ads code article, which warns that ads do not work without the second script. The meta tag follows the add-a-site article. If verification fails, Google suggests confirming the change is published and reachable by its crawlers (Mediapartners-Google and Google-Display-Ads-Bot), or trying another method. Ownership verified in Search Console is also accepted (not ready).
Request review and reach “Ready”
After verification, request review. Google confirms you own the site and that it follows the AdSense Program policies, typically within a few days and occasionally over 2-4 weeks (add a site). Ads serve only once the site has passed review and shows “Ready” (sites list).
The status article defines four approval states:
| Status | Meaning |
|---|---|
| Requires review | Not checked yet. Requesting review before the account setup tasks are done leaves the site in “Getting ready” without a review. |
| Getting ready | Checks are running. A new account may first need payment details set up. Do not remove and re-add the site; that can delay things. |
| Needs attention | Issues to fix before ads can show. |
| Ready | Ads can show, as long as the site keeps following policy. |
Why a site does not reach “Ready”
Google’s not-ready article groups the causes:
- Code missing or incomplete, for example outside the
<head>or on a different site from the one added. - Site unreachable: wrong URL, site not live, a login wall, the crawler blocked in robots.txt, or an invalid or self-signed certificate on an HTTPS site.
- Not enough unique content or a poor user experience, including weak navigation.
- Policy violations.
For game sites, two publisher policies are worth reading before review. The inventory value policy bars Google ads on screens with no or low-value publisher content, under construction, or auto-generated without manual review. The replicated content policy lists sites dedicated to embedding media from other sites without substantial added value among its examples. Neither policy mentions games directly.
Publish ads.txt
Google calls ads.txt not mandatory but highly recommended (ads.txt guide). The file sits at the site root, for example https://example.com/ads.txt, and contains one line per seller:
google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
Replace the zeros with your publisher ID; AdSense shows the exact line to copy under Sites. Add lines for any other ad network you use (ads.txt guide).
The Sites page shows an ads.txt status next to the approval status (site status). “Unauthorized” is the one that hurts: a file exists without your ID, and every ad request from the site is rejected. After changing the file, use the recheck option; Google says changes can take a few days to show, and up to a month for sites with few ad requests (ads.txt guide).
Apply for H5 Games Ads
H5 Games Ads is a by-application product. You request access through the form linked from the help center and the developer docs. The published conditions:
- Approval is not guaranteed and depends on partner eligibility.
- An approved AdSense account is required to show ads in H5 games.
- Submitting the form lets Google contact you about product updates.
If you are approved, using the API gives a limited permission to show full-screen ads under Google’s policy (sign up), which the H5 Games Ads introduction restricts to natural transitions created with adBreak().
While you wait, data-adbreak-test="on" on the AdSense script shows mock ads that follow your configured frequency, without sending ad requests to Google. It cannot catch a wrong data-ad-client value (testing modes). Remove it before players see the game. Placement and frequency rules are in Ad Placement API preroll and ad frequency.
What to check before you apply
- The game page is on a domain you control, live, public, without a login, and served over valid HTTPS.
- robots.txt does not block Google’s ad crawlers.
- The AdSense code, with the
adBreak/adConfigline, is in the<head>of the document that contains the canvas. - The site offers original content and navigation beyond the game itself; the not-ready article asks for enough valuable content and navigational elements.
- Payment details and the other setup tasks on the AdSense homepage are done.
- The site shows “Ready” and the ads.txt status is “Authorized”.
data-adbreak-testis removed from the production page.
What is not published
Google does not publish the eligibility criteria for H5 Games Ads, how long an application takes to answer, or whether a site must be “Ready” before you apply. The revenue share for H5 Games Ads specifically is not stated; see the Google H5 Games Ads page and portal payouts compared for what AdSense does publish.
Questions
- Is an approved AdSense account enough to use H5 Games Ads?
- No. Google says you need an approved AdSense account, and H5 Games Ads is a separate by-application product whose approval is not guaranteed and depends on partner eligibility.
- How long does AdSense take to mark a site Ready?
- Google says the checks usually take a few days and in some cases 2-4 weeks. Removing and re-adding the site can delay the process.
- Is ads.txt required for AdSense?
- Google calls it not mandatory but highly recommended. Once a site has an ads.txt file that omits your publisher ID, its status becomes Unauthorized and all ad requests from that site are rejected.
Sources
- How to sign up (Ad Placement API, Google for Developers)
- Sign up for AdSense H5 Games Ads (Google AdSense Help, answer 1705831)
- Get started with AdSense H5 Games Ads (Google AdSense Help, answer 9959170)
- Add the AdSense code to your game page (Google AdSense Help, answer 9955214)
- AdSense site management (Google AdSense Help, answer 12131223)
- Add a new site to your sites list (Google AdSense Help, answer 12169212)
- Check the status of your AdSense sites (Google AdSense Help, answer 12170222)
- What to do when your site is not ready to show ads (Google AdSense Help, answer 12176698)
- Ads.txt guide (Google AdSense Help, answer 12171612)
- Google-served ads on screens without publisher-content (Publisher Policies Help, answer 11112688)
- Google-served ads on screens with replicated content (Publisher Policies Help, answer 11190248)
- Testing modes (Ad Placement API, Google for Developers)
- Payments and distribution (Ad Placement API, Google for Developers)
- HTML5 game structure (Ad Placement API, Google for Developers)