About HTML5/Playable ads for App campaigns

HTML5/Playable assets capture the attention of app users in a unique way by being interactive and entertaining. This article describes where HTML5/Playable assets can appear and the sizes and formats you can upload for your App campaign, and how we measure interactions and conversions.

Note: AMPHTML assets are not supported in App Campaigns.

Where and how your ads may appear

Your HTML5/Playable assets may be paired with other assets such as your app icon, app description, or description text when they are displayed on the Google Display Network. App campaigns respect your account settings regarding any exclusions you’ve set for webpages and apps. Learn about how you can exclude webpages and apps.

HTML5/Playable sizes and formats

Before you create an App campaign, consider the following tips for creating your HTML5 assets:

  • Currently accepted sizes for HTML5:
    • Recommended sizes (your assets will appear as full screen ads on the majority of devices)
      • 320x480 (portrait)
      • 480x320 (landscape)
  • To validate your HTML5 assets before uploading, run your .ZIP file through the Google Ads HTML5 Validator tool.
  • Upload your asset as a .ZIP file with a maximum size of 5MB and no more than 512 files within the .ZIP.
  • You can upload up to 20 .ZIP files for each ad group.
  • .ZIP files can contain the following formats: HTML, CSS, JS, GIF, PNG, JPG, JPEG, SVG.
  • .ZIP files cannot contain other .ZIP files
  • UTF-8 must be used for non-ASCII characters.
  • Sound and video are not supported for HTML5 ads for App campaigns.

How your ads are measured

HTML5/Playable App campaign ads provide an immersive experience for your current and potential app users that allows for app interaction before downloading the app. Because users may interact with the HTML5/Playable ads but take action later, it’s important to accurately measure interactions and their impact on conversions.


  • What they are: An engagement is counted when a user interacts for the first time with or clicks on your HTML5/Playable ad.
  • How they’re billed for App ads: HTML5/Playable ads are charged on a cost per engagement (CPE) basis. You’ll be billed for an Engagement, which is recorded when a user interacts for the first time with or clicks on your HTML5/Playable ad.
  • How conversions are measured: For HTML5/Playable ads, conversions are counted when a user installs your app within 30 days of an Engagement. Learn more about mobile app conversion windows


  • Greater accuracy when measuring performance of your HTML5/Playable app install ads.
  • Improved and more accurate conversion data to optimize conversions.

If you use Google Web Designer

Ad environment When you create an asset in Google Web Designer, you must specify the “Google Ads” environment.
Supported components
  • Swipeable Gallery
  • Carousel Gallery
  • 360° Gallery
  • Gallery Navigation
  • Image Button
  • Spritesheet
Publishing for Google Ads In Google Web Designer:
  1. Click Publish.
  2. Select Publish locally.
  3. Upload the resulting .ZIP file to Google Ads.
  • Expandable ads are not supported.
  • All images used in HTML5 ads must be local images, not referenced images, and should be part of the assets that comprise the ZIP file.
  • Only Google web fonts are supported. Other web fonts are not supported.
  • For environment target actions, timer and multiple exits are not supported.
  • Local storage methods cannot be used in HTML5 ads.

If you don't use Google Web Designer

HTML requirements

HTML5 assets must include:

  • <!DOCTYPE html> declaration
  • <html> tag
  • <body>tag
  • Ad format size meta tag within the <head> tag. For example: <meta name="ad.size" content="width=300,height=250">

Explicit end tags (inline ending tags will not be accepted):

  • Example of valid end tags: <path></path>
  • Example of what not to do: <path> or <path />

Alternatively, you can extract the inline svg into a separate file.

Upload requirements

All code and assets must be referenced using a relative path to resources included in the .ZIP file.

No external references are allowed except references to:

Clickable buttons

If you want to make sure users can click only on your call to action button (for example, “Download”), follow these instructions to include the exitapi.js script. If you don't include the exitapi.js script, Google Ads will make your entire asset clickable.


  1. Include the following script in your HTML <head> tag: <scripttype="text/javascript" src="https://tpc.googlesyndication.com/pagead/gadgets/html5/api/exitapi.js"> </script>
  2. Then make the following JavaScript call to enable your final URL: ExitApi.exit()
    1. For example, send a consumer to the final URL, using a standard anchor:
      1. <a onclick="ExitApi.exit()">Learn more</a>
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue

Clear search
Close search
Google apps
Main menu
Search Help Center